Шаблон авторизации

Авторизация в чате происходит в два этапа: сначала вводится ник, потом пароль.

Имеется возможно объединить эти два шага в один. Все что для этого нужно сделать - только добавить еще одно поле для ввода пароля рядом с вводом ника в шаблоне "логин".

Пример:



Другой шаблон авторизации

Пример шаблона авторизации в две строки для широкого фрейма.

Пример:

Код устанавливается в шаблон "логин"



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

Пример:



Шаблон поздравления с днем рождения

Этот шаблон можно использовать на дополнительных страничках или во фрейме "Информация".

Пример:

Окно "Смайлики"

Окно смайликов состоит из трех основных частей — это: собственно таблица смайликов, меню переключения страниц и меню выбора группы. С помощью шаблона можно комбинировать положение этих элементов в окне.

В шаблоне используются следующие переменные:

%SMILES% - выводит страницу смайликов, смайлики располагаются относительно друг друга на одном расстоянии, которое определяется дизайном.
%SMILES_TABLE% - выводит страницу смайликов в виде таблицы, в которой смайлики располагаются по центру ячеек. Браузер Internet Explorer некорректно отображает страницу в данном режиме.
%MENU% - выводит меню страниц смайликов, меню представлено в виде последовательности номеров страниц.
%GROUPS_MENU% - выводит меню для выбора группы смайликов, меню представлено в виде выпадающего списка. Если использовать эту переменную как функцию и передать ей число, то это число будет означать количество пробелов, которое необходимо отступить в меню слева и справа от названий групп.
%GROUP_NAME% - выводит название текущей группы, применять следует только при наличии групп. Если использовать эту переменную как функцию, то в аргументе можно передать градиентный цвет, которым будет выводиться название, аргумент должен передаваться в кавычках.
В шаблоне может использоваться только одна переменная %SMILES% или %SMILES_TABLE%, переменные %MENU% и %GROUPS_MENU% желательно использовать внутри условных операторов — в этом случае присутствие меню в окне будет зависеть от количества смайликов и наличия групп.

По умолчанию в окне выводится 100 смайликов на страницу. Чтобы изменить это значение переменные %SMILES%, и %SMILES_TABLE% должны быть использованы как функции, а в аргументе передать новое число.

Пример шаблона:

Команды альтернативного наказания нарушителей

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

Список команд:

/shutup nick
подавляет вывод фраз пользователя, повторное исполнение команды разрешает вывод фраз;
/totalignore nick
исключает пользователя из разговора, фразы пользователя не будут видны другим пользователям, также этот пользователь удаляется из всех списков (онлайн, игноры и т.д.), при этом, для самого пользователя ничего не изменится, он будет видеть свои фразы. Повторное исполнение команды возвращает пользователя в разговор;
/reverse nick
текст пользователя будет выводиться в чат задом наперед, т.е. текст будет читаться справа налево, повторное исполнение этой команды отключает эффект;
/abracadabra nick [число] или /абракадабра nick [число]
искажает текст пользователя, вплоть до невозможности его прочтения, необязательный параметр число задает степень искажения текста, от легкого искажения, до полной абракадабры, число должно лежать в диапазоне от 6 (самое слабое искажение) до 100 (самое сильное искажение). При значении 60 текст уже становится практически не читабельным. Применение команды без числа устанавливает максимальное искажение текста. Для отключения эффекта искажения необходимо выполнить команду без параметра;
/vowel nick [буква] или /гласные nick [буква]
заменяет в словах все русские гласные, необязательный параметр буква указывает на какую букву должна производиться замена, если параметр не указан то гласные будут заменяться случайными буквами. Для отключения этого эффекта необходимо выполнить команды без параметра.
*Примечание: квадратные скобки [] в командах указывают, что параметр внутри скобок является необязательным, сами скобки при вводе команды печатать не надо.

Действие этих команд распространяется только на текущую сессию посетителя, при перезаходе посетителя установленные параметры будут сброшены. Для того, чтобы сохранять действие команд при повторном входе посетителя необходимо поместить его в бан-лист командой /ban nick или /бан nick. Повторное исполнение этой команды удаляется пользователя из бан-листа. Команда /ban выводит список забаненных.

Модераторы, имеющие доступ к командам альтернативного наказания, в админке имеют индекс "BN".

Форма авторизации для дополнительных страниц

Здесь дано описание как правильно устанавливать форму авторизации на дополнительных страницах.

Код формы авторизации на дополнительных страницах немного отличается от кода, который устанавливается на внешних сайтах (код в разделе "Web-мастеру" админки чата), т.к. требуется выполнение следующих условий:

• сохранение номера порта, через который осуществляется доступ;
• сохранение реферального номера.

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

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


Пример рабочей формы



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

Пример формы с выбором комнаты



Пример формы с выбором дизайна



Пример формы с выбором комнаты и дизайна

Фрейм отправки сообщений

Здесь представлены примеры модификации стандартного шаблона фрейма отправки сообщений.

Дублирование функций из навигации

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

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

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

в виде ссылок



в виде кнопок



Осталось добавить нужные функции в шаблон "отправка"

Пример:




Счетчик времени прибывания в чате

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

Пример шаблона с таймером:



Переключатель транслита

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

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

Пример шаблона с переключателем транслита в виде чекбокса



Пример шаблона с переключателем транслита в виде кнопки

Прежде всего определимся, что такое шаблон. Шаблон — это каркас, который задает положение элементов документа.

В шаблонах имеются специальные параметры (переменные), которые в процессе компиляции (парсинга шаблона) заменяются на реальные значения. В итоге получается полностью готовый HTML-код для вывода в браузер.



• %ICON% — иконка посетителя, если он зарегистрирован, по которой открывается его анкета. Если посетитель загрузил свою иконку, будет отображена его иконка.
• %RANK% — звание посетителя, выводится только текст.
• %RANK_ICON% — иконка звания посетителя, если есть, в противном случае выводит дефолтовую картинку анкеты.
• %RANK_ICON_INFO% — то же, что и %RANK_ICON%, но с возможностью открывать анкету посетителя при клике на картинку.
• %USER_ICON% — пользовательская иконка, загруженная посетителем.
• %USER_ICON_INFO% — то же, что и %USER_ICON%, но с возможностью открывать анкету посетителя при клике на картинку.
• %TORT% — булево значение, истина (символ пробела), если у посетителя сегодня день рождения, иначе ложь (пустая строка).
• %TORT_ICON% — пиктограмма торта, если у посетителя день рождения.
• %STAT% — статус посетителя, который он выбрал в навигации, либо командой /status.
• %STAT_ICON% — иконка статуса.
• %WEBCAM_ICON% — иконка включенной веб-камеры в режиме "трансляция", если переменную использовать как функцию, в аргументе можно передать подсказку, которая будет выводиться при наведении мышки на иконку.
• %USER_STAT% — личный статус пользователя, который он установил командой /status, системные статусы этой переменной не выводятся.
• %INVISIBLE% — булево значение, истина (символ пробела), если посетитель находится в режиме "невидимость", иначе ложь (пустая строка).
• %INVISIBLE_ICON% — пиктограмма невидимости.
• %SEX% — число, указывающее пол посетителя: 1 - мужской, 2 - женский, если пол не установлен переменная содержит пустую строку.
• %SEX_ICON% — пиктограмма пола посетителя, если пол установлен.
• %FLAG% — флаг страны, которой принадлежит IP-адрес, с которого зашел посетитель, размер картинки флага 29 на 20 пикселей.
• %FLAG_INFO% — кликабельный флаг, откроется анкета, если есть.
• %SMALL_FLAG% — тоже флаг страны, но меньших размеров, картинка 18 на 12 пикселей.
• %SMALL_FLAG_INFO% — кликабельный маленький флаг.
• %CO% — двубуквенное обозначение страны в нижнем регистре, можно использовать для загрузки своих изображений флагов.
• %NICK% — ник посетителя.
• %PHOTO% — булево значение, истина (символ пробела), если у посетителя в анкете имеются фотографии, иначе ложь (пустая строка).
• %SHUTUP% — булево значение, истина (символ пробела), если посетителя лишили слова (наказан), иначе ложь (пустая строка).
• %ODDEVEN% — число, содержит 0 для четных строк и 1 для нечетных строк.
• %DESIGN% — число, содержит номер текущего дизайна.
• %CAPTION% — заголовок подписка, если имеется разделение на мальчиков и девочек.
• %TOTAL% — число, количество человек в чате.

Используя эти обозначения, можно создать шаблон списка посетителей любой конфигурации.

Для выделения строки списка используется оператор {{{ }}}. Внутри этих скобочек должна находиться одна строка списка, остальные будут формироваться аналогично.

Теперь примеры



без флага



с флагом





без флага



с флагом





без флага



с флагом





без флага



с флагом




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



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



или для английских:



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

Теперь рассмотрим, из чего состоят наши шаблоны.

1. Это блок



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

2. Код



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



3. Функция, которая определяет параметры списка.



Именно в это место будет выводиться список.
Первым аргументом этой функции всегда должна быть строка "WHO".
Второй аргумент - это название шаблона списка из п.1 (%TABLE%)
Третий - это строка, которая будет выводиться, если в чате никого нет.
Четвертый - порядок деления списка на подсписки (мальчики, девочки, а также список голосования). Подсписки определяются парами число-строка. Число указывает, какой подсписок должен выводиться: 0 - без пола, 1 - мальчики, 2 - девочки, 3 - голосование (всего 4 пары). Строка - это то, что будет отображаться в заголовке подсписка. Если деления не должно осуществляться, здесь должны быть определены только две пары - 0 и 3.
Пятый - подсказка, которая должна выводиться при наведении мышки на иконку пользователя.
Шестой - подсказка, которая должна выводиться при наведении мышки на иконку киллера. Если строка пустая - будет выводиться такая же подсказка, что и у простого пользователя.

4. Как определяются стили

Чтобы все текстовые элементы в каждом дизайне имели свой стиль, их необходимо поместить в контейнер с определенным классом:



Так определяются здесь все текстовые элементы. Для списка изначально заданы следующие имена селекторов:

• tm - для сообщения, что в чате никого нет, оно же и для вывода надписи "всего в чате:"
• bm - для текста "мальчики"
• gm - для текста "девочки"
• nm - для текста "бесполые"
• vm - для текста "на голосовании"

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

!!! Обращаю ваше внимание, что имена селекторов класса, при определении их в пользовательских стилях, должны начинаться с точки.