Плагин позволяет реализовать систему рейтингов (репутации) для пользователей на сайте. Каждый пользователь может повысить/понизить уровень репутации другого пользователя за его действия на сайте!

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

Выглядит репутация пользователя, как прямоугольник со значением репутации возле имени пользователя. Цвет прямоугольникак может менятся в зависимости от уровня репутации пользователя.

Возможности плагина:

• изменение рейтинга пользователя

• показ репутации на страницах сайта и т.д.

• показ списка пользователей и их голоса в окне.

• комментирование изменения репутации.

• удаление голосов рейтинга администратором.

• изменение цвета гаджета, в зависимости от значения репутации.

1. Скачайте архив и распакуйте его.
2. Папку Karma с его содержимым залейте на свой сайт в папку plugins.
3. Установите плагин из админ-панели.
4. Зайдите в настройки плагина и установите значения, необходимые вам.
5. Если вы хотите изменинить внешний вид, то в файле karma/js/karma.css находятся css правила оформления окон кармы.
6. Если вы хотите что-то переделать под свой дизайн, то в папке karma/tpl находятся 2 файла, отвечающие за внешний вид. karma.gadget.tpl - это шаблон гаджета кармы и karma.popup.tpl - это шаблон всплывающего окна кармы.
7. Установка завершена. Вставьте необходимые теги на своем сайте. см. вкладку теги.

##Теги в шаблонах темы движка

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

###Для страниц:

{PAGE_OWNER_KARMA} - page.tpl - гаджет

{LIST_ROW_OWNER_KARMA} - page.list.tpl (В блоке LIST_ROW ) - гаджет

###Для пользователей

{USERS_DETAILS_KARMA} - users.details.tpl- гаджет

{USERS_ROW_KARMA} - users.tpl (в блоке USERS_ROW ) - гаджет

{USERS_TOP_KARMA} - users.tpl (в блоке MAIN) - сортировка по репутации.

###Для форума

{FORUMS_POSTS_ROW_USERKARMA} - forums.posts.tpl (в блоке FORUMS_POSTS_ROW )- гаджет

###Для комментариев

{COMMENTS_ROW_AUTHOR_KARMA} - comments.tpl (в блоке COMMENTS_ROW )- гаджет

Так как плагин использует функцию движка для определения тега пользователя, то можно использовать подключение гаджета кармы и в плагинах. Например для плагина pagelist в шаблоне можно прописать:

{PAGE_ROW_OWNER_KARMA} - pagelist.tpl (В блоке PAGE_ROW ) - гаджет

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

{PHP|karma_self()} - гаджет

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

##Настройка плагина Разрешить отдавать голос за одно сообщение более одного раза ?

если вы поставите НЕТ, то пользователь не сможет изменять репутацию за один и тот-же (к примеру) комментарий.

В каких секциях форума не выводить репутацию ?

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

Множитель голоса:

Рассчитывается как [Уровень репутации пользователя, который изменяет карму] * [Множитель голоса].

Т.е. Если репутация = 4 * множитель = 0.5, то уровень голоса будет = 2 (40.5=2) Если репутация 0, то она автоматически приравнивается к минимальному значению голоса (см. настройки) Если репутация = 4 * множитель = 0.1, то уровень голоса будет = 0.4 (40.1=0.4) и т.д.

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

Максимальное значение голоса:

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

Макс. количество записей на странице:

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

Через какой промежуток времени можно изменить рейтинг повторно (anti-flood), часов:

Установка времени в часах, через которое один и тот-же пользователь, сможет повторно изменить репутацию. Одному и тому-же пользователю. Это поможет исключить накрутки репутации в целом.

Минимальное количество постов для изменения репутации другим пользователям:

Соответственно это показатель участия пользователя в жизни сайта. Тем самым мы ограничиваем накрутки рейтинга. Минимальное количество постов - это минимальное количество сообщений пользователя на сайте (комментарии, страницы, посты на форуме), для разрешения изменять репутацию другим пользователям.

Закрывать окно после изменения рейтинга ?:

если включено, то окно изменения репутации автоматически закроется черз 2 сек. после успешного изменения.

Начисляемый балл за вход на сайт:

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

Комментировать изменение репутации?

эта настройка включает обязательное комментирование изменения репутации. Данный комментарий виден в списке голосов репутации.

Разрешить показ в комментариях ?

будет ли отображаться гаджет кармы в комментариях.

Использовать css файл плагина:

данная настройка подключает css файл внешнего вида кармы. Если вы хотите использовать свой дизайн, то скопируйте данные из файла plugins/karma/js/karma.css и вставьте в свой основной css файл с вашими правками. И отключите этот пункт.

Минимальное значение голоса:

минимальное значение голоса при изменении репутации. Даже если расщет через множитель дасть меньший показатель.

Разрешить показ на форуме ?

разрешить отображать гаджет кармы в постах форума.

Разрешить показ на страницах ?

разрешить отображать гаджет кармы на страницах и списках страниц.

Использовать дополнительные поля пользователя?

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

P/S включение данной функции добавляет количество запросов к базе данных.

Разрешить понижать репутацию, пользователям с отрицательной репутацией ?

соответственно если не разрешить, то пользователь с отрицательным значением репутации, не сможет изменять е другим. (Антиместь ;) )

Цветовые пороги репутации:

Тут вам необходимо указать пороги, при которых цвет гаджета кармы будет менять цвет.

первое значение : Уровень репутации, при котором она будет считаться плохой. К примеру поставьте 0 . И гаджеты пользователей, у которых репутация меньше 0 будут красными. (Плохая репутация) Можете к примеру поставить -1, тогда репутация меньше -1 будет считаться плохой и будет красной.

второе значение: Уровень репутации, при котором она будет считаться хорошей. К примеру поставьте 5. И гаджеты пользователей, у которых репутация больше 5 будут оранжевыми. (Хорошая репутация)

третье значение: Уровень репутации, при котором она будет считаться jочень хорошей. К примеру поставьте 20. И гаджеты пользователей, у которых репутация больше 20 будут зелеными. (Очень хорошая репутация) .

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

Таким образом исходя из примера:

При значении репутации меньше нуля - гаджет красный. При значении репутации от 0 до 5 - гаджет будет серым. При значении репутации от 5 до 20 - гаджет будет оранжевым. При значении репутации от 20 и выше - гаджет будет зеленым.

P/S Если вы не хотите использовать множитель в расчетах добовляемого голоса и хотите его сделать фиксированным, то поставьте одинаковые значения для Минимального и Максимального значения голоса.