QPLBoard - документация

[Seo-man]

Создание Custom-шаблонов QPLBoard

1. Общие сведения



Custom-шаблоны - это пользовательские шаблоны доски объявлений QPLBoard, которые сделают вашу доску уникальной.


Вы можете создать произвольный набор дополнительных полей в форме подачи и поиска объявлений для каждой рубрики.

В рубриках автомобильной тематики это могут быть "марка авто", "пробег", "цвет автомобиля", опции "ABS", "акустика" и пр. характеристики.


Существует возможность создавать поля однострочного и многострочного ввода, выпадающие списки, списки множественного выбора, флажки (чекбоксы), одиночный флажок (чекбокс), радиокнопки (выбор один из многих) - и все это без изменения "движка" скрипта, без программирования на php.

Списки, на основе которых строится большинство элементов custom-шаблона, можно редактировать через интерфейс администратора. Сами шаблоны - простейшие HTML фрагменты со специальными вставками (мета-тегами), которые определяют то, какие поля появятся в форме.

Вы сможете создать эти шаблоны самостоятельно или заказать у нас, прислав нам список дополнительных полей с описанием.



Для создания custom шаблонов вам понадобиться

· базовые навыки создания HTML страниц;

· html или текстовый редактор (можно работать и через обычный “блокнот”, EmEditor, Far, Total Commander);

· доступ к хостингу, где расположена доска;

· доступ к панели администратора.



Убедитесь, что файлы доски скопированы на хостинг и база данных инициализирована. В качестве проверки вы можете создать простую структуру рубрик и попробовать добавить в них объявления. Объявления должны быть опубликованы на сайте. После того, как убедитесь, что база данных работает, можете удалить рубрики и объявления, и приступать к созданию и настройке custom шаблонов.



В доске объявлений можно создать неограниченное кол-во рубрик любой вложенности. Подача объявления осуществляется всегда только в конечную (самую глубокую) рубрику. Стандартный набор информационных полей при подаче объявления – “Заголовок объявления” и “Описание” (или “Текст объявления”). По умолчанию все созданные рубрики будут иметь этот набор полей.



При необходимости набор полей формы подачи и поиска объявлений можно расширить. Например, при создании узкотематической доски автомобильной тематики вы можете сделать различные дополнительные поля для рубрик “Легковые автомобили”, “Грузовики и автобусы” и пр. Некоторые рубрики могут иметь одинаковые наборы дополнительных полей, для них будут использоваться одни и те же custom-шаблоны.



2. Файл конфигурации custom-шаблона



Файл конфигурации рубрики нужен для того, чтобы указать название custom-шаблона, идентификатор custom-шаблонов и файлы, которые содержат списки, на основе которых формируется custom-шаблон.



Пример файла конфигурации рубрики:



Автомобили

cars

brands=brands.txt,models=models.txt,color=color.tx t



Первая строка – заголовок custom-шаблона. Его вы будете видеть в выпадающем списке при выборе custom-шаблона для рубрики.

Вторая строка – идентификатор custom-шаблона. Это поле используется в качестве префикса для имен шаблонов поиска, подачи объявления, просмотра и т.д., находящихся в каталогах \modules\qplboard\templates\custom\user\ и \modules\qplboard\templates\custom\admin\.

Внимание! Допустимые символы – латинские символы a-z (в нижнем регистре), цифры 0-9 и символы ‘_’, ‘-‘. Не должно быть пробелов, русских букв.

Третья строка – это перечень списков с указанием файла, из которых брать содержимое, для того, чтобы заполнить их в момент инициализации.

brand=brands.txt

brand – идентификатор списка. Допустимые символы– латинские символы a-z (в нижнем регистре), цифры 0-9 и символы ‘_’, ‘-‘.

brands.txt – текстовый файл с элементами списка. Например:

AC
Acura
Alfa Romeo
Aston Martin
Audi
Austin
Bentley

В этом файле каждый элемент располагается по одному на строке. Элемент может содержать латинские и русские буквы, цифры, кавычки, тире, и пр.

Списки могут использоваться для формирования таких элементов формы подачи и поиска объявлений как

· Выпадающие списки

· Радио-кнопки

· Флажки (чекбоксы)

Рис. Пример элемента формы сформированного на базе списка “тип кузова”. Розовым выделен выпадающий список и поле, к которому он относится.

Файл конфигурации должен называться латинскими буквами с расширением .cfg (например, auto_car.cfg) и находиться в каталоге \modules\qplboard\templates\custom\.


В этом же каталоге должны находиться все файлы со списками.


Рис. Внешний вид списка выбора custom (дополнительного) шаблона при создании новой рубрики. То, что выводится в качестве названия шаблона – первая строка файлов конфигурации.



При открытии страницы создания новой рубрики доски объявлений список custom-шаблонов (все файлы с расширением .cfg) считывается динамически из каталога \modules\qplboard\templates\custom\ и используя первые строки из файлов формируется выпадающий список с заголовками custom-шаблонов.



После того, как для рубрики назначен custom-шаблон, изменится вид подачи и поиска объявления, поскольку к стандартным полям “Заголовок”, “Текст объявления” добавятся еще дополнительные поля выбора. Например, форма подачи объявления в рубрику “Легковые Автомобили” может выглядеть следующим образом.