Инструкция состоит из следующих разделов:

• Обзор и подключение
• Настройка
  • Основные настройки
  • Поля в форме добавления
  • Права групп пользователей
  • Удаление модуля
• Использование
• Управление дизайном
  • Шаблон отображения сообщений
  • Шаблон формы добавления
• FAQ по расширению «Мини-чат»

Обзор и подключение

Расширение «Мини-чат» позволяет пользователям обмениваться сообщениями прямо на сайте — без использования форума или комментариев. Чат можно разместить на любой странице в произвольном месте.

Для подключения расширения нажмите кнопку «+» на главной странице панели управления и выберите «Мини-чат»:

После успешной установки модуль появится в списке:

Далее необходимо выбрать место размещения чата. Войдите на сайт как администратор и перейдите в раздел «Управление дизайном» → «Включить конструктор»:

Добавьте новый блок:

Перетащите его в боковую колонку и откройте настройки:

На вкладке «Содержимое» выберите: Site elements → Мини-чат:

Сохраните изменения:

Мини-чат готов к использованию.

Настройка

Основные настройки

• uAPI для модуля. Подробнее см. на странице: http://api.ucoz.net
• Уведомлять о новых сообщениях по e-mail. При добавлении нового сообщения в чат администратор получит уведомление по почте.
• Использовать код безопасности для группы «Пользователи». Защищает чат от спама. Тип капчи можно изменить в настройках сайта.
• Максимальная длина сообщения: от 50 до 500 символов.
• Максимальная длина слова: от 3 до 255 символов.
• Количество хранимых сообщений: от 3 до 60. Старые сообщения удаляются при превышении лимита.
• Порядок вывода новых сообщений: сверху или снизу.

Поля в форме добавления

Вы можете настроить поля, отображаемые при отправке сообщений. Доступны: имя, сообщение, email, сайт и два дополнительных поля.

Для добавления поля нажмите кнопку с изображением «+» и выберите нужное:

Для удаления поля нажмите на крестик рядом с ним:

По умолчанию обязательны поля «Имя» и «Сообщение». Чтобы сделать другое поле обязательным — переключите соответствующую настройку:

Права групп пользователей

Доступные действия для разных групп:

• Добавление сообщений
• Премодерация сообщений (отложенный показ)
• Удаление своих сообщений
• Редактирование своих сообщений
• Отбор своих сообщений
• Редактирование всех сообщений
• Удаление всех сообщений

Удаление модуля

Чтобы отключить модуль «Мини-чат», выберите пункт «Удалить модуль» и введите ответ на секретный вопрос:

Использование

Так выглядит Мини-чат на странице сайта:

1. Частота обновления — выбирается из доступных значений: 15, 30, 60, 120 секунд.
2. Инструменты чата:
   1. Обновить — загружает новые сообщения.
   2. Вставить смайл — открывает окно с доступными смайликами.
   3. BB-коды — вызывает окно с подсказками по BB-кодам.
   4. Управление сообщениями (доступно администраторам) — позволяет редактировать и модерировать сообщения. Также отображаются сообщения, ожидающие подтверждения.
3. Форма добавления сообщений — отображает поля, указанные в настройках модуля.
4. Список сообщений — отображаются уже добавленные записи.

Управление дизайном

Для изменения внешнего вида мини-чата перейдите в раздел: Дизайн → Редактор → Мини-чат.

В интерфейсе редактора доступны два шаблона:

• «Вид материалов» — шаблон отображения сообщений
• «Форма добавления сообщений» — шаблон формы отправки сообщений

Шаблон отображения сообщений

Отвечает за вывод одного сообщения в списке мини-чата.

Доступные переменные:

• $AVATAR_URL$ — ссылка на аватар автора
• $CUSTOM1$, $CUSTOM2$ — значения дополнительных полей
• $DATE$, $TIME$, $WDAY$ — дата, время, день недели
• $EMAIL$, $EMAIL_JS$ — email в виде текста и ссылки
• $GID$ — ID группы (0 — гость)
• $IP_ADDRESS$ — IP пользователя
• $MESSAGE$ — текст сообщения
• $NAME$ — имя пользователя
• $NUMBER$ — порядковый номер сообщения
• $PARITY$ — 1 (нечетное), 2 (четное)
• $PROFILE_URL$ — ссылка на профиль
• $SITE$ — URL сайта
• $STR_* — названия полей, как указано в настройках
• $UID$ — ID пользователя (0 — гость)
• $USERNAME$ — логин пользователя
• $USER_AGENT_PDA$ — true/false: используется ли PDA-браузер

Шаблон формы добавления сообщений

Отвечает за внешний вид формы отправки сообщений.

Доступные переменные:

• $BBCODES_URI$ — ссылка на справку по BB-кодам
• $FIELDS_MASK$ — битовая маска включенных полей (Email = 1, Сайт = 2, и т.д.)
• $MAX_MESSAGE_LEN$ — макс. длина сообщения
• $MSGCTRL_URI$ — ссылка на управление сообщениями
• $SMILES_URI$ — ссылка на окно со смайлами
• $STR_CUSTOM1$, $STR_CUSTOM2$ — названия доп. полей
• $STR_EMAIL$, $STR_MESSAGE$, $STR_NAME$, $STR_URL$ — названия стандартных полей

FAQ по расширению «Мини-чат»

Как изменить цвет полосы заполнения текста?

Через Панель управления: Дизайн → Редактор → Мини-чат. Также можно использовать CSS.

Как удалить сообщения в чате?

Из окна управления сообщениями — нажмите на иконки под блоком чата.

Как задать интервал обновления меньше 30 сек?

В HTML-шаблоне найдите строку:

<option value="0">--<option value="30">30сек<option value="60">1мин<option value="120">2мин<option value="300">5мин<option value="900">15мин</select>

Измените значение value вручную.

Как скрыть чат от некоторых пользователей?

Используйте условные операторы в шаблоне, где вставлен код вызова чата:

<?if($GROUP_ID$=2 || $GROUP_ID$=3 || $GROUP_ID$=4)?>вызывающий код<?endif?>

Можно ли создать отдельные комнаты для разных пользователей?

Нет, такая возможность в модуле отсутствует.

Есть ли архив сообщений, как в cbox?

В Мини-чате архива сообщений нет.

Как задать размер шрифта в чате по умолчанию?

.commCommentTd { font-size: 14pt; }

Или в шаблоне:

<font size=14pt>$MESSAGE$</font>

Как изменить фон чата?

<style>body { background: #цвет_фона; }</style>