Лого, баннер, меню

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

В коде фрейма "баннер" можно использовать всего три шаблонных переменных:

• %BANNER% - в это место устанавливается баннер, список баннеров необходимо задать в разделе "Баннеры", смена баннеров происходит после каждой отправки сообщения;
• %LOGO% - в это место устанавливается логотип, который загружен в разделе "Логотип";
• %MENU% - в это место, куда устанавливаются кнопки меню, кнопки всегда расположены в ряд, настройка меню производится в разделе "Меню".

В коде фрейма "меню" можно использовать только одну шаблонную переменную %MENU%.

Если во фрейме баннера будет установлено меню, то необходимости во фрейме "меню" нет и его необходимо убрать в разделе "Фреймы".

Если не предполагается использовать баннеры и логотип, то необходимо убрать фрейм баннера, оставить только фрейм меню.

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

Важно помнить, что во всех остальных окнах и фреймах чата для отображения баннера и логотипа необходимо пользоваться шаблонными функциями %CHAT('BANNER')% и %CHAT('LOGO')% соответственно.

Примеры кода фрейма "баннер" для разных случаев.

Во фрейме размещается баннер и логотип.



Во фрейме размещается баннер, логотип и меню.



Стилевые параметры этих фреймов задаются в разделе "Дизайн".

Альтернативное меню

Стандартное меню чата состоит из прямоугольных кнопок одинаковой ширины и высоты, стили которых можно настраивать через "Дизайн". Однако, имеется возможность создавать меню из графических или текстовых кнопок. В этом случае необходимо самостоятельно прописать в коде расположение кнопок, используя для графических кнопок тэг , а для текстовых – .

Чтобы кнопки функционировали необходимо указать ряд параметров в этих тегах:

• name — обязательный параметр, указывает какую функцию выполняет кнопка (см. ниже);
• frame — необязательный параметр, должен принимать значение "1", указывает на то, что функция будет выводиться во фрейме чата, а не во всплывающем окне, параметр не должен использоваться вместе с параметром win;
• win — необязательный параметр, указывает на то, что функция будет выводиться во всплывающем окне, значение этого параметра определяет конфигурацию всплывающего окна (см. ниже), если отсутствуют оба параметра win и frame, то это заставит создать всплывающее окно, конфигурация которого определяется админкой чата, параметр win не должен использоваться вместе с параметром frame;
• menu — необязательный параметр, должен принимать значение "1", указывает на то, что данная кнопка является кнопкой меню чата, имеет смысл использовать только если данная функция кнопки является нестандартной (например, открывается внешний URL).

Стандартные функции (параметр name):

• help — окно помощи;
• rules — окно правил чата;
• people — окно раздела "Люди";
• people/form — окно регистрации;
• who — список посетителей в онлайне
• whowas — список посетителей, побывавших в чате;
• calendar — окно календаря;
• gb — окно гостевой книги, функция работает, только если корректно настроены виртуальные каталоги;
• creation — окно творчества, функция работает, только если корректно настроены виртуальные каталоги.

Также в качестве функции можно использовать любой URL.

Определение конфигурации всплывающих окон (параметр win).

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

• 1 — окно должно содержать полосы прокрутки;
• 2 — окно должно быть изменяемым;
• 4 — окно должно содержать меню браузера;
• 8 — окно должно содержать кнопки браузера;
• 16 — окно должно содержать адресную строку;
• 32 — окно должно содержать статусную строку;
• 64 — окно должно открываться по середине экрана.

ВАЖНО! Многие современные браузеры по соображениям безопасности всегда включают в состав окна часть перечисленных элементов, например, некоторые браузеры всегда выводят адресную и статусную строки, независимо от того, были переданы эти параметры или нет.

Пример. Чтобы открыть окно размером с родительское и при это окно содержало полосы прокрутки и его можно было изменять, необходимо в кнопке указать параметр win="0:0:3", где 3 – это сумма чисел 1 (полосы прокрутки) и 2 (изменяемый размер).

Второй пример. Чтобы открыть окно фиксированного размера по центру экрана и при это окно содержало полосы прокрутки необходимо в кнопке указать параметр win="500:400:65", где 500 и 400 – ширина и высота окна соответственно, а 65 – сумма чисел 1 (полосы прокрутки) и 64 (окно по центру).

Пример меню



Устанавливать альтернативное меню можно в любой фрейм чата, кроме окна сообщений. Это вносит большее разнообразие при создании неповторимого облика чата.

Боты

Увеличить функциональность чата можно с помощью функций-ботов. Отличие функций-ботов от остальных функций чата заключается в том, что боты находятся в чате как обычные посетители и имеют собственные имена, а вызов функций производится путем отправки сообщений в чат на имя бота.

Боты разбиты на две группы:

медиа-боты — позволяют выводить в чат медиа-контент, такой как: музыка, катринки и видео.
инфо-боты — позволяют получать такую информацию как: прогноз погоды, курс валют, перевод текста с одного языка на другой.
Разбиение ботов на группы позволяет более гибко манипулировать привилегиями пользователей для доступа к этим функциям.

Медиа-боты

Запросы на медиа-боты перенаправляются на сторонние сервера для поиска запрашиваемого медиа-контента. Так поиск музыки осуществляется на различных mp3-серверах, поиск видео осуществляется сервером www.youtube.com, поиск картинок — поисковиком www.google.com.

Т.к. поиск медиа-контента может выдавать более одного результата, то по результатам поиска формируется список. Для управления списком служат команды бота, команды начинаются с символа "." (точка) и следом указывается название команды.

Список команд медиа-ботов:

• where/где — выводит список серверов, на которых осуществляется поиск;
• list/лист — выводит текущую страницу списка из результата поиска, список всегда содержит не более 10 элементов;
• page/страница — выводит следующую страницу списка из результата поиска;
• next/еще — воспроизводит в чате следующий элемент из списка, для нового поиска воспроизведение всегда начинается с первого элемента списка;
• число — воспроизводит произвольный элемент, номер должен совпадать с номером из списка.

Все медиа-боты имеют одинаковый синтаксис поиска и управления.

Инфо-боты

К ботам группы "инфо-боты" относятся следующие боты:

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

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

Погода

Для получения информации о погоде необходимо информеру послать команду "погода название_города" или "weather название_города". Если не указывать город, то он будет вычислен автоматически на основании данных входа пользователя. Бывает, что информер выдает погоду в городе не той страны, которая ожидалась, это случается когда в разных странах имеются города с одним и тем же названием. Для такого случая необходимо информеру явно указать страну, в которой находится город, используя следующий синтаксис: "погода co:название_города", где co — двухбуквенное обозначение страны, например для России это ru, для США — us.

Курсы валют

Для получения курсов валют необходимо информеру послать команду "курс валюта" или "rate валюта", где валюта указывается трехбуквенным кодом. Чтобы получить все возможные коды, которые понимает информер, необходимо ему послать команду "валюта" или "currency".

Переводчик

Если язык оригинала — русский, то переводчик будет переводить текст на английский язык. Если язык оригинала не русский, то переводчик попытается сам определить язык, на котором написан текст и переведет его на русский язык. Кроме того, переводчику можно явно указать язык оригинала и язык перевода, для этого применяется следующий синтаксис: sl|tl|текст, где sl — код языка оригинала, tl — код языка перевода, коды языков перечислены на этой странице.

Калькулятор

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

Удобство пользования калькулятором наглядно можно продемонстрировать на примерах.

Пример 1, простой расчет, демонстрирует работу с памятью и комментарием.



В этом примере в память заносятся два числа и над ними производятся четыре математических действия

Пример 2, демонстрирует работу пользовательских функций.



Команды калькулятора:

• .list/лист — выводит результаты ваших выражений и сами выражения.
• .def имя ( список_аргументов ) = выражение — определяет пользовательскую функцию с именем имя, список аргументов функции указывается через запятую, отсчет всегда от единицы, например, для функции, которая принимает три аргумента список должен выглядеть как ($1, $2, $3). Команда .def без параметров выводит список всех пользовательских функций.
• .del имя — удаляет пользовательскую функцию с именем имя.
• .clear/.reset/.очистить — очищает список выражений и список пользовательских функций.
• .precision/.точность число — определяет точность, с которой выводятся результаты вычислений, число указывает, сколько знаков после запятой требуется выводить, максимальное значение равно 20.
• .exp — включает/выключает вывод результатов в экспоненциальной форме.

Управление ботами

Управление ботами может осуществлять только главный администратор чата. Для управление ботами используются четыре команды: запуск, остановка, стилизация и управление видимостью в комнатах.

Запуск ботов

Для запуска бота необходимо в чат передать команду:



где:

• имя_бота — любое имя, которые вы хотите дать боту.
• тип_бота — какого типа бот должен быть запущен.

Допустимые типы ботов:

• MUSIC — медиа-бот для поиска музыки.
• YOUTUBE — медиа-бот для поиска видео.
• IMAGES — медиа-бот для поиска картинок.
• INFORMER — инфо-бот "информер".
• TRANSLATOR — инфо-бот "переводчик".
• CALC — инфо-бот "калькулятор".

В чате не допускается запускать несколько ботов одного типа.

Остановка ботов

Для остановки бота необходимо в чат передать команду:



где:

• имя_бота — имя бота, который находится в чате.

Стилизация ботов

Стилизация ботов позволяет задавать никам и фразам ботов любые цвета и шрифты. Для стилизации бота необходимо в чат передать команду:



где:

• имя_бота — имя бота, который находится в чате.
• параметры_стилизации — такие параметры, как: nickcolor, nickfont, nickstyle, messcolor, messfont, messstyle, синтаксис полностью аналогичен синтаксису команды /setup.

Боты в других комнатах

Запуск ботов всегда производится только в одной комнате чата. Если в чате несколько комнат, то в них также можно установить ботов. Чтобы боты были доступны в других комнатах надо выполнить следующую команду:



где:

• имя_бота — имя бота, который находится в чате.
• номер_комнаты — номер комнаты чата, номера комнат можно увидеть в админке чата в разделе "комнаты". Допускается передавать сразу несколько номеров, номера должны указываться через пробел.

Повторное выполнение команды для той же комнаты отключит бота в этой комнате.

Боты в списке посетителей

Чтобы в списке посетителей боты не смешивались с другими пользователями чата, их можно посместить в отдельный список, для этого необходимо отредактировать шаблон "кто в чате" и указать в функции %CHAT("WHO", ... )% подсписок для ботов (подробнее об этой функции написано в документации Шаблон списка посетителей).

Пример определения функции списка:

Встроенные команды чата

Общедоступные команды, работают у всех пользователей:



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

Счетчик просмотров и последние просмотры анкеты

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

Запоминаются пользователи как находящиеся в чате, так и те, которые просматривают анкету, не входя в чат. В последнем случае ник будет отсутствовать, но запоминается IP-адрес и идентификатор компьютера. Просмотры учитываются только в том случае, если пользователь в текущих сутках открыл анкету первый раз, либо анкета была изменена, т.е. если один и то же пользователь в текущих сутках (от 00:00:00 до 23:59:59) будет открывать анкету несколько раз и при этом владелец анкеты ее не изменял, будет учтен только первый просмотр, если анкета была отредактирована, будет учитываться каждый просмотр.

Для вывода счетчика просмотров в анкете необходимо установить переменную %VIEWS%. Для получения списка просмотревших в анкету необходимо установить ссылку или кнопку с id или name равным show_viewers, пример:



Допускается задавать количество элементов списка "последние просмотры", для этого необходимо задать атрибут max в тэге. Минимальное количество в списке ограничено числом 10, а максимальное - 100 элементов.

Внешний вид списка последних просмотров определяется шаблон "последние просмотры" раздела "Анкеты". Пример код шаблона в случае двухколончатого вывода:



Описание шаблонных переменных:

%NUM% — порядковый номер в списке.
%NICK% — ник просмотревшего (если есть).
%DATE% — дата последнего просмотра.
%COUNT% — сколько раз пользователь открывал эту анкету.
%IP% — IP-адрес просмотревшего.
%CC(n)% — функция проверки номера колонки, где n — номер колонки.

В приведенном шаблоне в случае отсутствия ника у пользователя (пользователь не вошел в чат) будет выводиться надпись "нет ника", но вместо надписи можно выводить, например, его IP-адрес, для этого можно использовать шаблонную переменную %IP%.

Кроме счетчика просмотров анкеты имеется счетчик, подсчитывающий сколько раз владелец анкеты просматривал текущую анкету, для вывода этого счетчика в анкету надо установить код:



Вместе с этими функциями имеется привилегия "скрывать просмотры". Данная привилегия предоставляет доступ к одноименной настройке, т.е. настройке "скрывать просмотры". С включенной привилегией в личных настройках появляются дополнительный переключатель (чекбокс). Эта настройка позволяет скрывать свой ник в списке последних просмотров, однако счетчик будет учитывать просмотры в любом случае. Кроме того, настройка "скрывать просмотры" не скрывает ник пользователя в списке от администратора, администратор всегда видит полный список. Также состояние переключателя можно изменять консольной командой чата /setup hideviews. Данная команда меняет состояние переключателя только для текущей сессии, не сохраняя настройку, т.е. после перезахода в чат состояние переключателя "скрывать просмотры" будет определяться личными настройками.

Капча для регистрации

Для защиты чата от автоматических регистраций анкет имеется возможность установить капчу (CAPTCHA) — специальную картинку с изображением случайного числа, которое легко будет читаться человеком, но крайне тяжело обрабатываться роботом.

ВАЖНО! Установка капчи требует изменение шаблонов чата, прежде необходимо открыть к ним доступ.

Для установки капчи требуется внести изменения в два шаблона.

Первый шаблон — "HTML-код анкеты" раздела "Люди", необходимо добавить в начало следующий код:



Второй шаблон — "страница ников" раздела "Люди", необходимо найти код:



и заменить его на код:



Функция капчи может принимать до трех параметров, влияющие на внещний вид капчи, синтаксис выглядит так:



где:
A0 — оттенок серого, цвет, которым выводятся цифры: от черного (0) до белого (255),
A1 — уровень искажения картинки: 0 – нет искажения, 10 – максимальное искажение
A2 — уровень зашумленности картинки случайными линиями, число от 0 до 10, 0 – нет зашумленности

без A1 и A2 будет выводиться самая легко читаемая картинка, но и роботам будет легче ее опознать.

функция для работы с анкетами - %PEOPLE()%

функция %PEOPLE()%

Универсальная функция для работы с анкетами. Рассмотрим только одно применение этой функции с аргументом 'LIST'.

Функция %PEOPLE('LIST')% предназначена для получения списка зарегистрированных пользователей по определенным критериям.

Полный список всех возможных аргументов:



Список пользователей формируется с учетом опций поиска. Набор этих опций передается в функцию как строка, в которой записана комбинация параметров для выбора требуемых данных. Для более наглядной записи опций поиска, все опции имеют предопределенные имена. Для комбинации множества опция в строке необходимо использовать символ вертикальной черты '|'.

Список опций для поиска:



Пример:

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



Результатом работы функции %PEOPLE("LIST")% будет HTML-код списка.
Дополнительно эта функция создает 5 переменных, которые можно использовать на странице:


1. %FIRST% — номер первого элемента текущей страницы
2. %LAST% — номер последнего элемента текущей страницы
3. %PAGE% — номер текущей страницы
4. %PAGES% — количество страниц
5. %TOTAL% — количество всех элементов с данным критерием поиска

Функция для определения состояния чата - %CHAT()%

функция %CHAT()%

Возвращает системную информацию о чате:



Числа, возвращаемые функциями %CHAT('FIRST')% и %CHAT('LAST')%, являются количество секунд, прошедших от даты 1 января 1970 года (такой отсчет времени принят в UNIX-системах). Эти значения можно использовать в функции %DATE()%.