Saitistika 4.0.Руководство разработчика.2005

RelArticles – связь с другими материалами. В настоящее время не используется. Оставлена для совместимости.

Основные хранимые процедуры

Sait_Articles_GetMaterial

Классы

UML-диаграмма

Рисунок 27. UML-диаграмма классов модуля «Контент»

Список классов

CArticle

CMaterial

CMaterials

Примеры использования

Пример 1.

Вывод списка материалов на фронтофисе

Dim i

Dim aMaterialList If FolderID<>0 then

Dim oAL: set oAL = New CMaterials ' класс со списком материалов oAL.GetInfo FolderID, UserInfo.UserID ' заполнение обьекта класса

for i=0 to oAL.count

%><%=oAL.Title(i)%> [<%=left( oAL.PubDate(i),10)%>] <%=SystemInfo.SiteUrl&oAL.Url(i)&VbCrLf%><%=oAL.ShortComment(i)&VbCrLf&VbCrLf%> <%

next end if

Пример 2.

Отображение материала на фронтофисе.

Dim oMaterial : Set oMaterial = New CMaterial If Not oMaterial.GetInfo(matId) Then

UserSession.NewEvent "NF", UserInfo.UserID, "DM", 0, "", 0, "", true, true Response.Redirect "/errors/404.htm"

End If oMaterial.pNo = pNo

oMaterial.Query = QSS("query")

If RTest(oMaterial.Rights, 0, crRF + crWF + crCF) Then UserSession.FailPageLoad "article authorization"

Response.Redirect _SystemInfo.URLAuthPage&"&err=accessdeny&backpage="&_ Server.URLEncode(MakeSelfRefUrl("&matid="&matid))

End If oMaterial.Show

Буклет

Логика работы

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

Функциональность состоит из 4-х страниц (шагов). Пользователь последовательно переходит по страницам, нажимая на соответствующие кнопки, таким образом функциональность похожа на обыкновенный визард.

Шаг 1 : Выбор разделов Шаг 2 : Выбор материалов

Шаг 3 : Сортировка выбранных страниц Шаг 4 : Генерация буклета

Шаг 1: Выбор разделов

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

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

Шаг 2: Выбор материалов

В результате поста с предыдущей страницы формируется строка, содержащая идентификаторы разделов, которые были отмечены. Эта строка запоминается в объекте Session с уникальным (случайным) ключом, и далее этот ключ используется при переходах между различными страницами буклета.

Сама страница содержит древовидный список выбранных ранее разделов и вложенных в них материалов.

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

<input type="checkbox" name="prn" value="{@id}"> - для разделов <input type="checkbox" name="prn" value="0{@id}"> - для материалов

В аттрибуте action формы постинга передается ключ, по которому в объекте Session сохранены выбранные на первом шаге разделы.

Шаг 3: Сортировка выбранных страниц

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

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

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

На странице выводится список отмеченных ранее разделов и материалов. «Отсортированности» удается добиться за счет того, что в результатах поста переменные идут в той последовательности, в которой они находятся в HTML-коде. Меняя DOM-структуру HTMLа яваскриптом можно этого добиться.

Шаг 4: Генерация буклета

Так же как и на странице сортировки, через переданный ключ страница получает список идентификаторов отмеченных разделов и материалов.

Для распечатки используется функция PrintFolder, располагающаяся в файле print-versions.asp В этой функции определены версии для печати всех «распечатываемых» разделов. Также в самом файле хранится массив PrintableFiles, содержащий имена скриптов, которые можно распечатывать. Для использования PrintFolder необходимо включить на странице все использующиеся инклюды.

Отображение чекбоксов в дереве элементов

При отображении дерева в booklet.xsl передается список имен скриптов, которые берутся из массива PrintableFiles. При отображении раздела шаблон проверяет, есть ли filename раздела среди переданных имен.

Версия для печати

Версия для печати конкретного раздела работает через ту же функцию, что и страница генерации буклета.

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

1.Добавляем в массив PrintableFiles имя главного файла типа.

2.Добавляем в функцию PrintFolder логику вывода, соответствующую новому типу разделов.

3.Добавить новые инклюды (если они нужны) на страницу версии для печати и страницу генерации буклета

XSL-шаблоны

Интерактивные модули

Голосования

Логика работы

Бэкофис

1.При незаполнении даты начала и завершения голосования в первое поле подставляется текущая дата, во второе текущая дата + 10 дней.

2.Чем выше приоритет голосования, тем выше вероятность отображения голосования на фронтофисе

3.Нельзя редактировать дату начала голосования, если голосование уже стартовало и есть хотя бы один вариант ответа на него. Также нельзя редактировать дату начала уже закончившихся голосований.

4.Чтобы изменить состояние голосования из закончившегося в текущее нужно поменять дату его окончания.

5.Если на голосование уже отвечали то нелья менять варианты ответа.

Фронтофис

1.Голосования появляются на фронтофисе по следующему алгоритму

1.1.Выбираются все голосования для текущего сервера фронтофиса

1.2.Исключаются голосования

1.2.1.Которые есть в Cookies у пользователя как «те, на которые он уже проголосовал»

1.2.2.Для которых в списке последних 100 IP есть значение, равное IP пользователя

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

2.При нажатии на кнопку голосования

2.1.Засчитывается вариант ответа пользователя

2.2.Пользоателю ставится кука голосования

2.3.IP пользователя записывается в список последних IP, с которых голосовали этого голосование

3.При показе результатов голосования сумма процентов по вариантам ответов для голосований с выбором одного варианта ответа равна 100%. Для голосований с несколькими вариантами ответа может быть больше 100%.

База данных

Рисунок 28. Диаграмма таблиц базы данных модуля «Голосования»

Описания таблиц

Votings – таблица хранений голосований

Хранимые процедуры

Простые. Описание не требуется.

Классы

UML-диаграмма

Форумы

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

Логика работы

1.При создании нового форума некоторые его настройки копируются из таблиц настроек форума по умолчанию – ForumDf

и ForumsBannedIPDf.

2.Для блокировки пользователя по нику используются объектные права на форум. Отправлять сообщения в форум могут только пользователи, имеющие право на запись (ФО) на этот форум. Пользователей, имеющих право управление (ФО) на форум, заблокировать через значок блокировки по нику нельзя.

3.В поле IP таблицы ForumsBannedIP могут находиться как IP, так и маски IP. Пользователи, IP которых свопадает с одним из IP или одной из масок IP этой таблицы, не имеют права отправки сообщений в форум.

4.Сообщения в форуме представляются в виде дерева, при этом корневыми элементами дерева являются темы форума (идентификатор темы для текущего сообщения находится в поле Thread таблицы ForumsPostings), а дочерние сообщения связаны с родительским по полю Parent таблицы ForumsPostings.

5.Если у сообщения стоит флаг Notify (уведомлять об ответах на сообщение по электронной почте), то при ответе на это сообщение или его дочерние сообщения пользователя с Email, отличным от Email автора этого сообщения автору сообщения высылается письмо с уведомлением. Уведомление работает только для премодерируемых форумов.

6.В постмодерируемом форуме сообщение выводится как не одобренное менеджером интерактивов, пока его флаг IsValid не будет установлен в 1.

7.Большинство страниц бэкофиса форумов реализованы на устаревшей технологии MAE, используемой в ранних версиях Сайтистики. Тенденции развития Сайтистики таковы, что от использования данной технологии постепенно отказываются.

База данных

Диаграмма таблиц