Управление дизайном модуля «Форум»
С помощью данной инструкции вы научитесь управлять внешним видом модуля «Форум».
За отображение всех страниц модуля отвечают следующие шаблоны:
- Общий вид страниц форума
- Вид материалов
- Форма добавления сообщения
- Вид категории/раздела
- Вид темы/опроса
Каждый шаблон использует собственный набор переменных. Они выводят конкретную информацию и выполняют различные функции. Чтобы посмотреть список доступных переменных, нажмите на соответствующий значок в редакторе шаблонов:
Общий вид страниц форума
Это единственный шаблон модуля, который формирует страницу целиком. Остальные шаблоны формируют лишь её части. Этот шаблон используется на следующих страницах:
- Главная страница модуля (
//example.com/forum/) - Страница раздела, форума и подфорума (
//example.com/forum/id) - Страница темы и опроса
- Страница создания темы и опроса
- Ленточный вариант форума
- Список участников форума
- Правила форума
- Поиск
- Подписки участника
В большинстве случаев настраивать эти страницы отдельно не требуется — их содержимое выводится с помощью переменной $BODY$. Исключение составляют страницы разделов, форумов, тем и опросов: вид материалов в них задаётся с помощью других шаблонов.
Переменные шаблона «Общий вид страниц форума»:
| Переменная | Описание переменной |
|---|---|
| $BOARD_RULES_LINK$ | Ссылка на раздел «Правила форума» |
| $BODY$ | Основная часть страницы |
| $CUR_FORUM_NAME$ $CUR_FORUM_URL$ | Название и ссылка текущего форума |
| $CUR_SECTION_NAME$ $CUR_SECTION_URL$ | Название и ссылка текущего раздела |
| $CUR_SUBFORUM_NAME$ $CUR_SUBFORUM_URL$ | Название и ссылка текущего подфорума |
| $CUR_THREAD_DESCR$ $CUR_THREAD_NAME$ $CUR_THREAD_URL$ | Описание, название и ссылка темы/опроса |
| $FORUM_TITLE$ | Значение для тега <title> |
| $MEMBERS_LIST_LINK$ | Ссылка на список участников форума |
| $RECENT_POSTS_LINK$ | Ссылка на ленточный вариант форума |
| $RSS_LINK$ | Ссылка на RSS-ленту модуля |
| $SEARCH_PAGE_LINK$ | Ссылка на страницу поиска |
Вид материалов
Шаблон определяет внешний вид сообщений внутри темы:
Все сообщения темы, оформленные согласно этому шаблону, помещаются в переменную $BODY$, которая далее используется в шаблоне «Общий вид страниц форума».
Шаблон позволяет отобразить не только сам текст сообщения и прикреплённые файлы, но и детальную информацию об авторе.
Доступные переменные шаблона:
| Переменная | Описание переменной |
|---|---|
| $ATTACHMENT$ | Прикреплённый файл и его размер |
| $AVATAR_URL$ | Ссылка на аватар автора сообщения |
| $AWARDS$ | Количество наград |
| $AWARDS_DO_URL$ | Ссылка для вручения награды |
| $AWARDS_READ_URL$ | Ссылка на страницу со списком наград |
| $BAN_RATING$ | Рейтинг замечаний |
| $CITY$ | Город пользователя |
| $COUNTRY$ | Страна пользователя |
| $COUNTRY_ID$ | ID страны пользователя |
| $DELETE_URL$ | Ссылка для удаления сообщения |
| $DEL_ENTRY_FIELD$ | Поле для пометки на удаление (видно только модераторам) |
| $DO_BAN_URL$ | Ссылка для добавления замечания |
| $DO_REP_URL$ | Ссылка для изменения рейтинга репутации |
| $EDITEDBY$ | Информация о том, кто и когда редактировал сообщение |
| $EDIT_URL$ | Ссылка для редактирования сообщения |
| $EMAIL$ | Email пользователя |
| $ENTRY_MANAGE_ICON_BAR$ | Панель управления сообщением (Цитата, Жалоба, Редактировать, Удалить) |
| $FID$ | ID форума |
| $GENDER$ | Пол пользователя |
| $GENDER_ID$ | ID пола (используется для отображения иконки) |
| $GID$ | ID группы автора сообщения |
| $GROUP_ICON$ | Иконка группы пользователя |
| $GROUP_NAME$ | Название группы пользователя |
| $HOME_PAGE$ | Домашняя страница пользователя |
| $ICQ$ | ICQ-номер |
| $ID$ | ID материала |
| $JABBER$ | Jabber-идентификатор |
| $JS_EMAIL$ | Email для ссылок (в JS-формате) |
| $MESSAGE$ | Текст сообщения |
| $NUMBER$ | Порядковый номер сообщения |
| $ON_TOP_ICON$ | Иконка "Закреплено сверху" |
| $PM_URL$ | Ссылка на ЛС (личные сообщения) |
| $POSTS$ | Количество сообщений пользователя |
| $POST_COUNTRY$ | Страна во время отправки сообщения |
| $POST_COUNTRY_ID$ | ID страны при отправке сообщения |
| $PROFILE_URL$ | Ссылка на профиль пользователя |
| $QUOTE_URL$ | Ссылка для цитирования сообщения |
| $READ_BAN_URL$ | Ссылка для просмотра замечаний |
| $READ_REP_URL$ | Ссылка для просмотра репутации |
| $REG_DATE$ | Дата регистрации пользователя |
| $REG_TIME$ | Время регистрации |
| $REG_WDAY$ | День недели регистрации |
| $REPORT_URL$ | Ссылка для жалобы на сообщение |
| $REP_RATING$ | Рейтинг репутации |
| $SIGNATURE$ | Подпись пользователя |
| $SKYPE$ | Skype-идентификатор |
| $STATE$ | Штат (регион) |
| $TID$ | ID темы |
| $TIMESTAMP$ | Временная метка сообщения |
| $UID$ | ID пользователя (если гость — 0) |
| $USERNAME$ | Имя пользователя (login) |
| $USER_DETAILS_ICON_BAR$ | Панель с иконками: профиль, ЛС, сайт, email, ICQ |
| $USER_FULL_NAME$ | Полное имя пользователя |
| $USER_IP$ | IP-адрес пользователя |
| $USER_RANK_ICON$ | Иконка ранга пользователя |
| $USER_RANK_NAME$ | Название ранга |
| $USER_STATUS$ | Онлайн-статус (online/offline) |
| $USER_TITLE$ | Титул пользователя |
| $YAHOO$ | Yahoo-идентификатор |
| <?$LAST_AWARDS$('N')?> | Вывод последних N наград (до 10) |
Форма добавления сообщения
Этот шаблон определяет порядок и состав полей при добавлении сообщения.
Если настройка отключена, форма будет отображаться прямо на странице темы. В обоих случаях форма будет иметь одинаковое содержимое, определяемое данным шаблоном.
Доступные переменные шаблона:
| Переменная | Описание переменной |
|---|---|
| $BBCODES$ | BB-коды |
| $ERROR$ | Сообщение об ошибке при неправильном заполнении формы |
| $FILE_MAX_SIZE$ | Максимальный размер загружаемых файлов |
| $FORM_TITLE$ | Название формы |
| $MESSAGE_OPTIONS_FLAG$ | Флаг доступности опций сообщения |
| $MODER_OPTIONS_FLAG$ | Флаг доступности модераторских опций |
| $SMILES$ | Смайлы |
| $SUBMIT_SIGN$ | Надпись на кнопке «Отправить» |
| $_CLOSED_OPT$ | Опция «Закрыть тему» |
| $_EDITED_OPT$ | Опция «Сообщение отредактировано» |
| $_FILES_UPLOADER$ | Поле «Прикрепить файл» |
| $_FIRSTONTOP_OPT$ | Опция «Первое сообщение всегда сверху» |
| $_HTML_OPT$ | Опция «Включить HTML» (если разрешён HTML) |
| $_MAKE_BR_OPT$ | Опция «Заменять переносы строк тегом <br>» |
| $_MESSAGE$ | Поле «Сообщение» |
| $_ONTOP_OPT$ | Опция «Тема всегда сверху» |
| $_POLL_ANSWERS$ | Поле «Варианты ответов опроса» |
| $_POLL_MULTI_OPT$ | Опция «Выбор нескольких вариантов ответов» |
| $_POLL_ONLY_OPT$ | Опция «Только опрос» |
| $_POLL_PERIOD_OPT$ | Опция «Период голосования» |
| $_POLL_QUESTION$ | Поле «Вопрос опроса» |
| $_SECURITY_CODE$ | Поле «Код безопасности» |
| $_SIGNATURE_OPT$ | Опция «Включить подпись» |
| $_SMILES_OPT$ | Опция «Включить смайлы» |
| $_SUBSCRIBE_OPT$ | Опция «Уведомление на e-mail при ответах» |
| $_THREAD_DESCR$ | Поле «Краткое описание темы» |
| $_THREAD_NAME$ | Поле «Название темы» |
| $_USER$ | Поле «Имя пользователя» |
Вид категории/раздела
Этот шаблон определяет внешний вид форумов и подфорумов:
Они отображаются списком на главной странице модуля, а также на страницах разделов и форумов. Все элементы выводятся в переменную $BODY$, используемую в шаблоне «Общий вид страниц форума».
Поддерживаемые переменные:
| Переменная | Описание переменной |
|---|---|
| $ARCHIVE$ | Архив раздела/форума |
| $FIRST_POST_ICON$ | Иконка первого непрочитанного сообщения |
| $FIRST_POST_LINK$ | Ссылка на первое непрочитанное сообщение |
| $FORUM_DESCRIPTION$ | Описание форума/раздела |
| $FORUM_MODERS$ | Список модераторов |
| $FORUM_POSTS$ | Количество сообщений |
| $FORUM_THREADS$ | Количество тем |
| $FORUM_TITLE$ | Название форума/раздела |
| $FORUM_URL$ | Ссылка на форум/раздел |
| $GUEST_MSG$ | Флаг, указывающий, что последнее сообщение оставлено гостем |
| $ICON_NEW$ | Иконка, если есть новые сообщения |
| $ICON_NONEW$ | Иконка, если нет новых сообщений |
| $LAST_POST_AUTHOR$ | Ник автора последнего сообщения |
| $LAST_POST_AUTHOR_PROFILE$ | Ссылка на профиль автора последнего сообщения |
| $LAST_POST_DATE$ | Дата и время последнего сообщения |
| $LAST_POST_LINK$ | Ссылка на последнее сообщение |
| $LAST_POST_THREAD_LINK$ | Ссылка на тему последнего сообщения |
| $LAST_POST_THREAD_NAME$ | Название темы последнего сообщения |
| $NEW_MESSAGES$ | Флаг наличия новых сообщений |
| $PRIVATE$ | Флаг приватности форума/раздела |
| $USERNAME$ | Имя пользователя (login) |
| $VIEWERS$ | Количество пользователей, просматривающих форум |
Вид темы/опроса
Этот шаблон задаёт внешний вид тем и опросов в списке на страницах форума и подфорума:
Все элементы списка помещаются в переменную $BODY$, которая затем используется в шаблоне «Общий вид страниц форума».
Поддерживаемые переменные:
| Переменная | Описание переменной |
|---|---|
| $CURATOR_NAME$ | Ссылка на профиль куратора темы |
| $CUR_GROUP_ID$ | ID группы вошедшего пользователя |
| $CUR_USER_ID$ | ID вошедшего пользователя |
| $CUR_USER_REG_DAYS$ | Количество дней с момента регистрации пользователя |
| $DELETE_BUTTON$ | Кнопка удаления темы/опроса |
| $EDIT_BUTTON$ | Кнопка редактирования темы/опроса |
| $FIRST_POST_ICON$ | Иконка первого непрочитанного сообщения |
| $FIRST_POST_LINK$ | Ссылка на первое непрочитанное сообщение |
| $FORUM_TITLE$ | Название форума/раздела |
| $FORUM_URL$ | Ссылка на форум/раздел |
| $GUEST_MSG$ | Флаг: последнее сообщение оставлено гостем |
| $IS_PINNED$ | Флаг: тема закреплена |
| $LAST_POST_AUTHOR$ | Ник автора последнего сообщения |
| $LAST_POST_AUTHOR_PROFILE$ | Ссылка на профиль автора последнего сообщения |
| $LAST_POST_DATE$ | Дата и время последнего сообщения |
| $LAST_POST_LINK$ | Ссылка на последнее сообщение |
| $NEW_MESSAGES$ | Флаг наличия новых сообщений |
| $PAGE_SWITHCES$ | Переключатель страниц темы/опроса |
| $SHOW_VIEWS$ | Флаг: пользователь может видеть количество просмотров |
| $SUBSCRIBE$ | Подписка на тему/опрос |
| $THREAD_AUTHOR$ | Автор темы/опроса |
| $THREAD_DESCRIPTION$ | Описание темы/опроса |
| $THREAD_ICON$ | Иконка "новые/нет новых сообщений" |
| $THREAD_POSTS$ | Количество сообщений в теме |
| $THREAD_STATE$ | Состояние темы: новые сообщения или нет |
| $THREAD_TITLE$ | Название темы/опроса |
| $THREAD_TYPE_ICON$ | Иконка состояния темы (обычная, закреплена, закрыта и др.) |
| $THREAD_TYPE_STATE$ | Тип темы: «Обычная», «Закреплена», «Закрыта» и пр. |
| $THREAD_URL$ | Ссылка на тему/опрос |
| $THREAD_VIEWS$ | Количество просмотров темы/опроса |
| $USERNAME$ | Имя пользователя (login) |






