С помощью данной инструкции вы научитесь управлять внешним видом модуля «Доска объявлений».

За отображение всех страниц модуля отвечают следующие шаблоны:

• Главная страница доски объявлений (//example.com/board/)
• Страница со списком материалов раздела
• Страница со списком материалов категории
• Страница материала и комментариев к нему
• Вид материалов
• Страница поиска и рейтинга материалов
• Страница добавления/редактирования материала
• Форма добавления/редактирования материала

Если включена PDA-версия сайта, то для неё используются отдельные шаблоны модуля:

Каждый из шаблонов использует собственный набор переменных. Эти переменные выполняют различные функции и выводят соответствующую информацию. Чтобы просмотреть список доступных переменных, нажмите на значок в редакторе:

Главная страница модуля

На главной странице отображается перечень кратких обзоров объявлений. За вывод перечня отвечает переменная $BODY$. Количество отображаемых материалов регулируется через настройку «Количество отображаемых материалов».

С помощью $PAGE_SELECTOR$ можно реализовать постраничную навигацию.

Если вы используете разделы или категории, переменная $CATEGORIES$ выведет их список в любом месте шаблона. Эта переменная показывает категории и разделы, находящиеся в корне (не вложенные). Для изменения внешнего вида используйте настройки: «Внешний вид» / «Разделы и категории».

Страница со списком материалов раздела

Здесь отображаются анонсы объявлений из определённого раздела. За вывод отвечает $BODY$. Если на сайте нет разделов, данный шаблон может не использоваться.

Дополнительные переменные:

• $PAGE_SELECTOR$ — переключатель страниц
• $CATEGORIES$ — список вложенных категорий
• $FILTER1_MENU$, $FILTER2_MENU$, $FILTER3_MENU$ — выпадающие фильтры (как создать фильтры?)
• $SORTING_MENU$ — меню сортировки. Настраивается в разделе «Внешний вид» / «Меню сортировки»

Страница со списком материалов категории

Эта страница используется всегда, так как категория обязательна при добавлении объявления.

Действуют переменные:

• $BODY$
• $PAGE_SELECTOR$
• $FILTER1_MENU$, $FILTER2_MENU$, $FILTER3_MENU$
• $SORTING_MENU$

Для отображения информации о родительском разделе используйте:

• $SECTION_NAME$
• $SECTION_DESCR$
• $SECTION_URL$

Страница материала и комментариев к нему

В этом шаблоне размещается вся информация, добавленная при создании объявления: полный текст, изображения, дата публикации, категория и т.д. Каждое поле отображается своей переменной, которую можно разместить в любом месте шаблона.

Если активирована настройка «Комментирование», на странице будет доступна форма добавления комментариев. Шаблоны для отображения комментариев настраиваются в разделе «Дизайн» → «Редактор» → «Комментарии».

Если у материала заданы фильтры, их значения можно вывести с помощью переменных:

• $FILTER1_VALUE$
• $FILTER2_VALUE$
• $FILTER3_VALUE$

$PLACED_TILL$ — выводит дату из поля «Разместить до» (как добавить поле?).

$ONTOP$ — флаг закреплённого материала. Значения: 1 — закреплён, 0 — не закреплён. Используется в условных операторах <if()?>.

Для вывода файлового архива используются коды:

• $FILE_DIRECT_URL$
• $FILE_SIZE$
• $FILE_URL$

$LOADS$ — количество загрузок прикреплённого файла.

Вид материалов

Этот шаблон отвечает за отображение анонсов добавленных объявлений. Он используется в шаблонах:

• Главная страница модуля
• Страницы категорий и разделов
• Страницы поиска и рейтинга

Шаблон может включать любые поля материала. Основная задача — представить информацию компактно и удобно для восприятия, чтобы пользователи могли быстро просматривать список объявлений.

Страница поиска и рейтинга материалов

Этот шаблон охватывает несколько типов страниц:

1. Страница поиска материалов
Отображает список объявлений, соответствующий введённому запросу. Для перехода на неё пользователь должен воспользоваться формой $MODULE_SEARCH_FORM$. В переменной $SECTION_NAME$ будет показан запрос: Поиск[запрос].

2. Страница рейтинга материалов
Выводит список объявлений, отсортированных по определённым критериям. Используются следующие переменные-ссылки:

• $TOP_COMMS_URL$ — по количеству комментариев
• $TOP_LOADS_URL$ — по количеству загрузок файлов
• $TOP_NEW_URL$ — по дате добавления
• $TOP_RATING_URL$ — по рейтингу
• $TOP_READS_URL$ — по количеству просмотров

3. Страница материалов пользователя
Отображает список объявлений, добавленных конкретным пользователем. Используются переменные:

• $_BOARD_ACTIVITY_URL$ — ссылка на список объявлений
• $_BOARD_ENTRIES$ — количество добавленных объявлений

Вывод контента осуществляется через $BODY$. Постраничная навигация — $PAGE_SELECTOR$.

Страница добавления/редактирования материала

Главное содержимое — форма добавления материала. Она формируется на основе настроек модуля, а отображается через переменную $BODY$.

Чтобы отменить внесённые изменения, воспользуйтесь кнопкой «Восстановить стандартный шаблон»:

Форма добавления/редактирования материала

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

Пример: поле «Краткое описание» отображается с помощью следующего кода:

<?if($BRIEF_FL$)?>
 <li class="notcolumn">$BRIEF_FL$</li>
 <li class="notcolumn"> </li>
 <li class="notcolumn"><hr /></li>
<?endif?>

Вы можете скопировать этот код и вставить его в нужное место шаблона между другими блоками вида:

<li class="notcolumn"><?endif?>