From d7a5845a0ea5f1748965d7cfd13e4da981ae5eef Mon Sep 17 00:00:00 2001 From: Victor Wagner Date: Tue, 25 Mar 2008 08:26:06 +0000 Subject: [PATCH] =?utf8?q?=D0=9F=D1=80=D0=B8=D0=B2=D0=B5=D0=B4=D0=B5=D0=BD?= =?utf8?q?=D0=BE=20=D0=B2=20=D1=81=D0=BE=D0=BE=D1=82=D0=B2=D0=B5=D1=82?= =?utf8?q?=D1=81=D1=82=D0=B2=D0=B8=D0=B5=20=D1=81=20=D1=80=D0=B0=D0=B1?= =?utf8?q?=D0=BE=D1=82=D0=BE=D0=B9=20=D1=80=D0=B5=D0=B0=D0=BB=D1=8C=D0=BD?= =?utf8?q?=D0=BE=D0=B3=D0=BE=20=D1=81=D0=BA=D1=80=D0=B8=D0=BF=D1=82=D0=B0?= =?utf8?q?=20=D0=BF=D0=BE=D1=81=D1=82=D0=B8=D0=BD=D0=B3=D0=B0=20=D1=80?= =?utf8?q?=D0=B5=D0=BF=D0=BB=D0=B8=D0=BA=D0=B8.?= MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit --- doc/config.txt | 2 +- doc/templates.txt | 110 +++++++++++++++++++++++++++++++++++++--------- 2 files changed, 91 insertions(+), 21 deletions(-) diff --git a/doc/config.txt b/doc/config.txt index aeb9abb..90a372c 100644 --- a/doc/config.txt +++ b/doc/config.txt @@ -60,7 +60,7 @@ replies_per_page - число реплик на странице форума. forbid_tags=список-html-тэгов, запрещенных в сообщении. -restricted_userinfo= +restricted_user_info= список полей в информации о пользователе, которые имеет право изменять только администратор форума diff --git a/doc/templates.txt b/doc/templates.txt index d9ba674..fde12d5 100644 --- a/doc/templates.txt +++ b/doc/templates.txt @@ -43,7 +43,8 @@ author - ник автора сообщения. innerHtml заменяется Следует учитывать что в случае openId авторизации в этот элемент будет помещен элемент a со ссылкой на домашнюю страницу mdate - дата публикации сообщения innerHtml заменяется на дату -avatar - элемент img атрибут src которого заменияется на аватар автора +avatar - элемент img атрибут src которого заменияется на аватар автора, + или на templates/1x1.gif если у автора нет аватара. astatus - статус автора на форуме innerHtml заменяется на статус acomment - комментарий к нику, введенный автором при регистрации. innerHtml заменяется на комментарий @@ -145,7 +146,7 @@ mreply - ссылка на скрипт ответа. Атрибут href буд Страница списка тем (головная страница форума) -Может иметь элемент с классом message, описывающий форум в целом (его +Может иметь элемент с классом header, описывающий форум в целом (его создатель, вводный текст и т.д. Шаблоном описания конкретной темы является элемент с классом topic, @@ -157,23 +158,35 @@ mreply - ссылка на скрипт ответа. Атрибут href буд Кнопку setrights следует показывать только пользователю с правами администратора. +элемент с классом topic должен быть заключен в элемент с классом +topiclist. -Кроме этого, cтраница должна иметь ссылку с классом newtopic или форму с именем -newtopic и кнопкой submit с именем newtopic +При отсутствии тем на странице элементу с классом topiclist сервер +приписывает атрибут style="display: none;". + +При добавлении новой темы элемент с классом topic копируется и +вставляется непосредственно за предыдущим -Страница списка форумов (головная страница сайта, страница форума с -подразделами) +Кроме этого, cтраница должна иметь ссылку с классом newtopic или форму с именем +newtopic и кнопкой submit с именем newtopic -Устроена аналогично странице списка тем. +Список подфорумов устроен аналогично списку тем. Элемент списка форумов должен иметь класс forum, а форма/ссылка для -создания нового форума соотвесттвенно имя/класс newforum. +создания нового форума соотвесттвенно имя/класс newforum, а объемлющий +элемент, который скрывается при отсутствии подфорумов - класс forumlist + +В шаблоне элемента списка форумов может присутствовать элемент img +с классом logo. Если такой элемент обнаружен, то при наличии в +директории форума файла logo с расширением png, jpg или gif, в src +пропиcывается ссылка на этот файл. Иначе прописывается ссылка на +templates/1x1.gif Допускается также ситуация когда на одной странице присутствует и список форумов, и список тем. (В этом случае если физически отсутствуют либо те, либо другие, соответствующему элементу-шаблону выставляется -style="visibility: hidden"); +style="display: none"); Кроме этого на всех страницах рекомендуется иметь элемент-ссылку, который отображает текущее имя пользователя. Этот элемент должен @@ -244,12 +257,19 @@ signature_format). Поле format может принимать одно из Наличие URL в тексте проверяется независимо от формата. - Скрипт регистрации (операция login) + Скрипт входа в систему (операция login) Форма с именем login содержит поля name и password - Может также содержать checkbox с именем ipbind (привязка + Может также содержать checkbox с именем bindip (привязка авторизационной куки к IP) - (OpenID пока не описываем) + При авторизации по OpenID используется поле openidsite. + Его значение интерпретируется как шаблон для операции sprintf, который + должен содержать один спецификатор формата %s, куда подставляется имя + пользователя. + + Если поле openidsite имеет пустое значение, пользователь + рассматривается как локальный. Если непустое, то как + openid-пользователь. Кнопка submit называется login @@ -257,27 +277,77 @@ signature_format). Поле format может принимать одно из именем register) Содержит поля user pass1 pass2 comment - avatar (поле ввода URL) или avatarfile(file upload field) - email Может также содержать любые дополнительные поля информации о - пользователе (кроме поля status). Они будут сохранены в списке пользователей + пользователе. Они будут сохранены в списке пользователей и могут потом выводиться в шаблонах рядом с информацией об авторе. Скрытое поле required содержит список полей, которые обязательно требуются при регистрации. Поля user, pass1 и pass2 туда включать не следует. Скрытое поле ignore содержит список полей, которые НЕ НУЖНО - сохранять в качестве информации о пользователе. + сохранять в качестве информации о пользователе. Поля user, pass1, pass2 + и bindip туда включать не нужно. Так же если в форме присутствуют поля + avatar и avatarfile, поле avatarfile будет автоматически включено в + этот список, а поле avatar при наличии зааплоаженного файла будет + заменено на URL к этому файлу. + + Параметр restricted_userinfo в конфигурационном файле форума позволяет + задать список полей, которые пользователь не имеет права редактировать + сам, все равно в процессе регистрации или при редактировании профиля. + + Поля, которые, при их наличии, обрабатываются скриптом форума + специальным образом + + 1. avatar/avatarfile - картинка пользователя. Поле avatarfile + (зааплоаженная картинка) имеет приоритет над avatar (внешняя URL) + В случае если задано avatarfile, в информации о пользователе + сохраняется поле avatar с URL к этой картинке + + 2. signature - обычно поле с форматированным текстом. Дописывается в + конец каждого созданного данным пользователем сообщения + + 3. email - если не пусто, то проверяется на корректность посредством + модуля EMail::Valid + + 4. status - если имеет значение disabled, то данному пользователю + запрещен вход на форум до тех пор, пока администратор форума не изменит + статус. В случае, если требуется подтверждение регистрации модератором + рекомендуется прописывать это поле в restricted_user_info и указывать в + конфигурациии форума default_status = disabled, Скрипт отправки комментария - поля subject text (тэг textarea) +Операция reply + поля subject + text (тэг textarea) + text_format Можно также включать (динамически добавлять) поля file upload image1 image2 etc. - кнопка submit называется reply + кнопка submit называется reply. + Данная форма может также включать поля формы login. Т.е. + поддерживается аутентификация пользователя одновременно с отправкой + комментария. + + В силу технических ограничений, одновременно с регистрацией по OpenID + невозможен upload файлов и отправка комментариев длинной более 2-4Кб. + Точный предел размера комментария зависит от длины URL форума и + пределов размера URL, установленных при компиляции веб-сервера форума + и веб-сервера openid-сервера. + Скрипт создания новой темы или нового форума - поля subject text imageN и urlname. В последнее поле следует запретить + поля + subject + text + text_format + urlname. + При создании форума еще может присутствовать file upload field + logo. Зааплоаженный туда файл помещается в директрию форума + с именем logo и расширением соответствующим расширению исходного + файла. + + + В последнее поле следует запретить ввод символов нелатинского алфавита '/' и '?' Cкрипт просмотра списка пользователей (опция userlist) @@ -298,7 +368,7 @@ Cкрипт просмотра списка пользователей (опци В результате заполнения формы поле с именем moderators должно содержать список модераторов для данной темы (соответствующей - url страницы id) поле с именем administrators список всех + url страницы в pathinfo) поле с именем administrators список всех администраторов данного сайта. Скрипт редактирования свойств пользователя. -- 2.39.2