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

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

• Страница с сообщениями (/gb/)
• Вид материалов
• Форма добавления сообщений

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

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

В списке модулей слева выберите «Гостевая книга»:

При работе с шаблонами вы можете в любой момент посмотреть список доступных переменных, нажав на значок в редакторе:

Страница с сообщениями

Данный шаблон отвечает за отображение двух страниц:

• Главная страница модуля (/gb/)
• Страница добавления сообщения (/gb/0-1)

Переход на главную страницу выполняется по ссылке в переменной $READ_LINK$. Ссылка для добавления сообщений — $SIGN_LINK$. В зависимости от настройки «Форма на отдельной странице», ссылка ведёт либо на страницу добавления сообщений (/gb/0-1), либо к форме на странице со списком сообщений (/gb#sign).

В шаблоне доступна переменная $MODULE_NAME$, которая содержит название модуля (задаётся в настройках).

Все содержимое страницы выводится через переменную $BODY$. Переход между страницами сообщений (если их больше, чем указано в настройках) осуществляется с помощью переключателя страниц, который также включён в $BODY$.

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

Шаблон «Вид материалов» отвечает за отображение сообщений в списке на главной странице модуля.

Данный шаблон позволяет вывести содержимое всех полей, добавляемых при публикации сообщения:

• $ANSWER$ — ответ администратора
• $CITY$ — город
• $COUNTRY$ — страна
• $EMAIL$ или $EMAIL_JS$ — email пользователя (в текстовом виде или в виде JavaScript-выражения для защиты от спама)
• $ICQ$ — номер ICQ пользователя
• $MESSAGE$ — текст сообщения
• $NAME$ — имя
• $STATE$ — штат
• $SITE$ — сайт пользователя

Также можно вывести информацию о пользователе, оставившем сообщение:

• $IP_ADDRESS$ — IP-адрес на момент добавления
• $USERNAME$ — имя авторизованного пользователя
• $USER_AVATAR_URL$ — ссылка на аватар

Кроме того, каждое сообщение содержит дополнительную информацию:

• $CLASS$ — CSS-класс (разный для чётных/нечётных сообщений)
• $DATE$, $TIME$, $WDAY$ — дата, время и день недели публикации
• $ENTRY_RATING_USE$ — флаг включённого рейтинга
• $ENTRY_RATING$ — суммарный рейтинг сообщения
• $BAD_ENTRY_URL$, $GOOD_ENTRY_URL$ — ссылки для выставления оценки (плохая/хорошая)
• $MODER_PANEL$ — панель модератора
• $NOT_ACTIVE$ — сообщение не опубликовано
• $NUMBER$ — порядковый номер сообщения

Форма добавления сообщений

Шаблон отвечает за отображение формы добавления. Задача администратора — разместить в шаблоне необходимые поля, их названия и кнопку отправки.

Поля выводятся с помощью специальных переменных, доступных только в этом шаблоне. Например: $NAME_FL$, $CITY_FL$, $STATE_FL$, $MESSAGE_FL$ и др.

Переменная $SECURITY_FL$ добавляет в форму поле для ввода кода безопасности и саму картинку с кодом.

За отправку сообщения отвечает кнопка с атрибутом submit. Пример:

<input class="commSbmFl" type="submit" id="gbsbm" value="- Добавить комментарий -" />

Текст кнопки (value), класс и id могут быть изменены администратором.

Переменная $ERROR$ выводит текст ошибки или уведомления об успешной отправке:

$SMILES$ выводит блок со смайлами, которые можно вставить в сообщение по клику (редактор смайлов):