r11 - 13 Apr 2005 - 09:33:22 - SodzOYou are here: TWiki >  Clearmail Web > Rating
В cvs на revenge в папке clearmail/projects/SpamCop/ лежит файл:
exampleUsingRating - пример работы с модулем и формат использования функций

Понятия и обозначения

  • $uin -- строка, уникальный идентификатор пользователя (User Identification Name), создается функцией ???? из модуля ???
  • $iscore -- внешнее представление рейтинга пользователя, целое число от 0 до 100, значение 0 означает, что пользователю совсем нельзя доверять, 100 означает, что пользователю оказано безграничное доверие
  • $ratingdir -- дирректория в которой хранятся все файлы, относящиеся к рейтингу пользователя

Описание функций модуля ClearMail::Rating

makeUser ($uin)

Функция makeUser создает новоого пользователя по заданному идентификатору пользователя $uin. Рейтинг нового пользователя устанавливается равным умолчательному начальному значению (которое задается равным 0)

Особые случаи Если пользователь с идентификатором $uin уже существует, то функция возвращает "User with uin=$uin is already exist in "$ratingdir" folder!"

$bool = checkUser ($uin)

Функция checkUser проверяет, что пользователь с именем $uin существует. Если это так, то функция возвращает $bool = 1, в противном случае -- $bool = 0

$iscore = score ($uin)

Функция score возвращает внешний вид рейтинга $iscore пользователя с именем $uin.

Особые случаи Если пользователь с идентификатором $uin не существует, то функция возвращает "Could not find user in "$ratingdir" folder!"

increaseRating ($uin)

Функция increaseRating увеличивает рейтинг пользователя с именем $uin. Функция создана как средство повышения доверия к пользователя ("поощрение" за единичный очередной случай обоснованной жалобы).

Особые случаи Если пользователь с идентификатором $uin не существует, то функция возвращает "Could not find user in "$ratingdir" folder!"

decreaseRating ($uin)

Функция decreaseRating уменьшает рейтинг пользователя с именем $uin. Функция создана как средство уменьшения доверия к пользователя ("наказание" за единичный очередной случай необоснованной жалобы).

Особые случаи Если пользователь с идентификатором $uin не существует, то функция возвращает "Could not find user in "$ratingdir" folder!"

setRating ($uin, $iscore)

Здесь $iscore может быть строкой, задающей целое число от 0 до 100 (включительно). Функция setRating меняет рейтинг пользователя с именем $uin таким образом, что выполнение (сразу после данного вызова функции) оператора

$iscore1 = score ($uin)

приведет к результату $iscore1 очень близкому к значению $iscore.

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

Особые случаи Если пользователь с идентификатором $uin не существует, то функция возвращает "Could not find user in "$ratingdir" folder!". Если значение $score не является строкой, задающей целое число от 0 до 100 (включительно), то функция возвращает "Rating hasn't represent by number from 0 to 100!"

Внимание ! Руководство по установки:

  • системный администратор должен поместить конфигурационный файл config в /etc/clearmail/
В cvs на revenge лежит в: clearmail/projects/lib/ClearMail/
  • системный администратор должен поместить модули Config.pm, Rating.pm, Utils.pm в папку пакета ClearMail
В cvs на revenge лежит в: clearmail/projects/lib/ClearMail/

(!) При не выполнении соответствующийх правил по установки, разработчик не несет ответсвенности за ошибки!

-- SodzO - 02 Nov 2004

-- Main.abram - 17 Nov 2004

-- SodzO - 29 Nov 2004

-- SodzO - 23 Jan 2005

Edit | WYSIWYG | Attach | Printable | Raw View | Backlinks: Web, All Webs | History: r11 < r10 < r9 < r8 < r7 | More topic actions
 
Powered by TWiki

This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback