White Tiger
WWW Board — система поддержки WWW-конференции

Модуль отображения всяких мелочей


1. Введение, описание, disclaimer
2. Системные требования
3. Подготовка и установка
4. Настройка
5. Изменения
6. Последняя версия и ее download


1. Введение, описание, disclaimer

Данный скрипт является дополнительным модулем (plug-in) к программе поддержки Internet-форума (конференции) White Tiger WWW Board версии 2.933b или выше и полностью работоспособен только вместе с ней. С предыдущими версиями осуществляется ограниченная совместимость.
Модуль предназначен для вывода некоторых характеристик форума, отображение которых не предусмотрено в White Tiger WWW Board.
Программа распространяется бесплатно, регистрация не требуется. Никаких запретов на модификацию и/или расширение возможностей не предусматривается. Гарантируется некоторая работоспособность программы, никакая информация ни по каким адресам не высылается.


2. Системные требования

Для того, чтобы модуль работал на вашем форуме, должны выполняться следующие требования:
  • программная поддержка форума осуществляется White Tiger WWW Board версии 2.952b или выше;
  • включена интерпретация SSI (server side includes) программным обеспечением сервера либо установлен плагин WWWPage(r) версии 3.2x или выше.


3. Подготовка и установка

Никаких исправлений в файл скрипта вносить не нужно. Он использует стандартный модуль программы White Tiger WWW Board. Только в том случае, если файл основной программы wtbext.cgi переименован, внесите соответствующее изменение в строку

require "wtbext.cgi";

Поместите файл wtbshow.cgi в каталог скриптов форума и присвойте ему права чтения и исполняемости.
Добавьте в параметр форума «Верхняя строка Index» один или несколько фрагментов (по одному для каждого вывода):

<!--#include virtual="$dircgi/wtbshow.cgi?fid=$fid&ins=KEY"-->

в том месте, в котором вы хотите видеть соответствующую информацию. Вы можете вставить этот фрагмент также и в другие интерполируемые параметры форума.

Параметр KEY определяет, что именно вставлять, и может принимать следующие значения:
  • curdate — текущая дата в формате «XX day XXXX, XX:XX», в следующих версиях формат можно будет настроить;
  • lastdate — дату последнего посещения участником форума, формат тот же (поскольку значение обновляется при запуске wtbservice.cgi?ins=news или wtbshow.cgi?ins=news, вызов модуля с этим ключом должен быть осуществлен до них);
  • allmes — полное количество сообщений, поступившее на форум по текущий момент (значение берется из файла <wtblast.txt>);
  • indexmes — количество сообщений, присутствующих на основной странице;
  • news — выводит новостную строку и/или извещения о новых сообщениях, появившихся на форуме; этот ключ аналогичен такому же запуску входящего в WTBoard сервисного скрипта, однако исполняется быстрее и поддается более гибкой конфигурации (см. пункт «Настройка»).


4. Настройка

Настройка модуля производится с использованием так называемых «условных инструкций». Вместо трех параметров: newmestext, newanstext, newmesanstext, предусмотренных в WTBoard для отображения извещений о новых сообщениях, ответах и сообщениях и ответах, WTShow использует только один — newmesanstext, который можно сконфигурировать необходимым образом.
Поясним применение условных инструкций на примере. Допустим, необходимо, чтобы при имеющихся новых сообщениях выдавался следующий текст:
Появилось новых сообщений: 12.
При имеющихся новых ответах:
Появилось новых сообщений: 12, из них новых ответов на ваши сообщения: 5.
При отсутствии ответов и новых сообщений вообще:
Новых сообщений не обнаружено.
Соответствующий шаблон будет выглядеть следующим образом:
%newmes{Появилось новых сообщений: $newmes%newans{, из них новых ответов на ваши сообщения: $newans}%.}%%REVERSEnewmes{Новых сообщений не обнаружено.}%
То есть, если определено значение $newmes, интерполируется строка внутри фигурных скобок, вместо ключа $newmes подставляется соответствующая ссылка. Если к тому же определен и $newans, то есть имеются ответы на сообщения вошедшего на форум, интерполируется дополнительно и фрагмент, относящийся к ответам. Если значения не определены, строка в фигурных скобках удаляется.
Третий фрагмент обозначен для случая, когда новых сообщений нет. Префикс REVERSE предписывает интерполировать фрагмент в случае, когда соответствующий ключ не определен или равен нулю.
В условных инструкциях шаблона можно использовать все стандартные ключи WTBoard. Кроме того, особо рассматриваются следующие инструкции:
    $newmes — количество новых сообщений; ключ заменяется на ссылку для поиска новых сообщений;
    $newans — количество ответов на сообщения данного автора; ключ заменяется на ссылку для поиска ответов;
    ключ $snewmes заменяется на число без ссылки;
    ключ $snewans заменяется на число без ссылки;
    $lastdate — в случае, если посетитель зарегистрирован на форуме, ключ $lastdate содержит дату последнего посещения в формате «ДД месяца ГГГГ, ЧЧ:ММ»; если посетитель на форуме не зарегистрирован, значение не определено.
Вложенность условных инструкций поддерживается ограниченно.


5. Изменения

1.0a (25/VI/2000)
[+] первая публичная версия;
1.01a (26/VI/2000)
[!] если lastdate не определен, выводится текст: «неизвестно когда»;
[!] багофикс вывода лишнего «Content-type...»;
1.02a (13/01/2001)
[+] использование условных инструкций.


6. Последняя версия и ее download

Текущая версия программы White Tiger Show for White Tiger WWW Board — 1.02a, предназначена для работы с программным обеспечением форума White Tiger WWW Board 2.952b и выше, ограниченно совместима с предыдущими версиями WTBoard.

White Tiger Show 1.02a for White Tiger WWW Board 2.952b+ (13/01/2000, 6 KB)


Copyright © 2000-2001, White Tiger.