AUP плагин для NorrCompetition

1. Начинаем

Установочный пакет AUP плагина для NorrCompetition включает в себя плагин и набор правил. Продукт распространяется в двух версиях: для AltaUserPoints (форк от nordomgraph) и для классической версии AlphaUserPoints (от Bernard Gilly, теперь под управлением PamperME network).

  • plg_competition_aup.zip - версия для AltaUserPoints (форк)
  • plg_competition_aupp.zip - версия для оригинального AlphaUserPoints

2. Установка

Установочный пакет AUP плагина для NorrCompetition включает в себя плагин и набор правил в одном файле. Вам не требуется извлекать правила из архива и импортировать правила вручную.

2.1. Скачивание и установка плагина

Скачайте последнюю версию дистрибутива с сайта NorrNext и установите его как обычное расширение для Joomla. Перейдите в Панель Администратора > Расширения > Установка расширений и установите пакет plg_competition_aup.zip для AltauserPoints или plg_competition_aupp.zip в случае, если вы используете классическую версию AlphaUserPoints. Плагин интеграции будет включен автоматически после установки.

Все правила будут также автоматически импортированы в AUP компонент. В случае, если у вас уже установлены данные правила, то они будут обновлены. Мы рекомендуем создавать резервную копию сайта перед установкой обновлений.

2.2. Вкладка "Ключ скачивания"

Вкладка Ключ скачивания плагина уведомлений NorrCompetition
Вкладка 'Ключ скачивания' плагина уведомлений NorrCompetition

Ключ скачивания обеспечивает возможность оповещения администратора сайта о новой версии плагина и позволяет обновить его из админ.панели в несколько кликов. Укажите ключ скачивания для включения возможности обновления через встроенную в Joomla систему обновления расширений. Вы можете найти ваш ключ в списке подписок NorrCompetition на веб-сайте NorrNext.

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

Официальное руководство: Включаем обновление в один клик в коммерческих расширениях NorrNext

3. Список правил

3.1. Правила действий просмотра

  • Название: View Active Competition
  • XML название: view_competition_active.xml
  • Уникальное имя функции: plgaup_nc_view_competition_active
  • Описание: Присвоение баллов пользователю за просмотр активного конкурса.


  • Название: View Completed Competition
  • XML название: view_competition_completed.xml
  • Уникальное имя функции: plgaup_nc_view_competition_completed
  • Описание: Присвоение баллов пользователю, за просмотр завершённого конкурса.


  • Название: View Participant in Completed Competition
  • XML название: view_participant_completed.xml
  • Уникальное имя функции: plgaup_nc_view_participant_completed
  • Описание: Присвоение баллов пользователю за просмотр участника в активном конкурсе.


  • Название: View Participant in Active Competition
  • XML название: view_participant_active.xml
  • Уникальное имя функции: plgaup_nc_view_participant_active
  • Описание: Присвоение баллов пользователю за просмотр участника в завершённом конкурсе.


3.2. Правила действий участника

  • Название: Participant Approved
  • XML название: participant_approved.xml
  • Уникальное имя функции: plgaup_nc_participant_approved
  • Описание: Присвоение баллов пользователю, когда его участник был подтверждён.


  • Название: Participant Unapproved
  • XML название: participant_unapproved.xml
  • Уникальное имя функции: plgaup_nc_participant_unapproved
  • Описание: присвоение баллов пользователю, когда его участник был отправлен на модерацию.


  • Название: Participant Published
  • XML название: participant_published.xml
  • Уникальное имя функции: plgaup_nc_participant_published
  • Описание: Присвоение баллов пользователю, когда его участник был была опубликован.


  • Название: Participant Unpublished
  • XML название: participant_unpublished.xml
  • Уникальное имя функции: plgaup_nc_participant_unpublished
  • Описание: Присвоение баллов пользователю, когда его участник был снят с публикации.


  • Название: Participant Trashed
  • XML название: participant_trashed.xml
  • Уникальное имя функции: plgaup_nc_participant_trashed
  • Описание: Присвоение баллов пользователю, когда его участник был отклонён (отправлен в корзину).


3.3. Правила действий пользователя

  • Название: Vote for Participant
  • XML название: vote_user.xml
  • Уникальное имя функции: plgaup_nc_vote_user
  • Описание: Присвоение баллов пользователю за голосование.


  • Название: Voter to Participant
  • XML название: vote_submitter.xml
  • Уникальное имя функции: plgaup_nc_vote_submitter
  • Описание: Присвоение баллов автору участника, за которого был отдан голос.


  • Название: Viewer to Participant in Active Competition
  • XML название: view_participant_active_submitter
  • Уникальное имя функции: plgaup_nc_view_participant_active_submitter
  • Описание: Присвоение баллов автору участника за просмотр его участника в активном конкурсе.


  • Название: Viewer to Participant in Completed Competition
  • XML название: view_participant_completed_submitter
  • Уникальное имя функции: plgaup_nc_view_participant_completed_submitter
  • Описание: Присвоение баллов автору участника за просмотр его участника в завершённом конкурсе.


3.4. Application actions rules

  • Название: Submit Application Form
  • XML название: appform_submit.xml
  • Уникальное имя функции: plgaup_nc_appform_submit
  • Описание: Присвоение баллов пользователю за подачу заявки на конкурс.


AUP правила для NorrCompetition
Набор AUP правил для NorrCompetition

4. Настройка правил

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

4.1. Таб "Подробности"

  • ID: (non-edit)
  • Категория: вы можете назначить правило в категорию, выбрав нужную категорию из списка.
  • Название правила:название правила
  • Описание: описание правила
  • Тип плагина: короткое описание типа правила/плагина. Все предустановленные правила относятся к системе. По умолчанию это NorrCompetition

  • Уникальное имя функции (function name): уникальное имя функции для этого правила, напр. plgaup_purchaseitem (не рекомендуется менять)
  • Уровень пользователя: выбор начальной группы пользователей, для которых это правило будет отрабатывать по умолчанию. По умолчанию это “Public”.
  • Баллы: Назначить x баллов для этого правила. Добавление символа минус приведет к вычитанию баллов. (например: -1.00)
  • Фиксированные баллы: (Нет / Да): Укажите: фиксированное или неизвестное количество баллов
  • Процент: (Нет / Да): Применять проценты
  • Истекают: Введите дату для ограничения срока использования начисленных баллов по всем правилам или только указанным. При этом, если срок не установлен, то баллами можно будет воспользоваться без ограничений. Если срок указан для конкретного правила, то баллами, начисленными по этому правилу можно будет воспользоваться только до указанной даты (например, для использования с правилом Купить баллы через Paypal, как подписка)
  • Display activity (No / Yes): Display this activity on frontend listing (profile and activities lists)
  • Опубликовано: (Нет / Да): Статус правила.
  • Автоматическое утверждение: (Нет / Да): автоматическое утверждение
  • Метод: Выбор метода присвоения баллов
    • Единожды для пользователя
    • Раз в день для пользователя
    • Раз в день для отдельного пользователя из всех
    • Раз в неделю для пользователя
    • Раз в месяц для пользователя
    • Раз в год для пользователя
    • Всякий раз (по умолчанию)
  • Связать: связать ещё одно правило

4.2. Таб “Сообщение”

  • Отображать сообщение: (Нет / Да): Укажите, нужно ли отображать сообщение о произведённом действии.
  • Сообщение: Введите альтернативный текст сообщения для отображения во фронт-энде после начисления или списания баллов. Для использования сообщения по умолчанию - оставьте пустым. Можно использовать переменные {username} - имя пользователя и {points} - баллов для содержания сообщения.

4.3. Таб “Уведомление по e-mail”

  • Уведомление по e-mail (No / Yes): Отправка сообщения участнику о начислении/списании баллов
  • Тема: Вы можете использовать следующие переменные: {username} - имя пользователя, {points} - количество начисленных или списанных баллов и {newtotal} - остаток на счете, для составления темы сообщения.
  • Текст сообщения: Вы можете использовать следующие переменные: {username} - имя пользователя, {points} - количество начисленных или списанных баллов и {newtotal} - остаток на счете, для составления текста сообщения. {Datareference} используется для показа причины is used to show the reason (e.g. Rule custom points)
  • Формат: Формат e-mail письма. При выборе HTML, вы сможете использовать некоторые HTML переменные в тексте сообщения, доступные для e-mail.
  • Отправка копии Админам: Разрешить администраторам получать BCC копию по e-mail

5. Включение правил на стороне NorrCompetition

Итак, мы только что установили и настроили правила на стороне AUP, а теперь время включить AUP на стороне NorrCompetition. Это можно сделать через глобальные настройки, а можно выставить индивидуально для каждого конкурса. Перейдите в Панель Администратора > Компоненты > NorrCompetition > Настройки и нажмите на вкладку “Конкурс”. Найдите Настройки интеграции в нижней части области контента:

  • Интеграция с AUP - включить обработку определённых AUP правил для этого конкурса. Дополнительно необходимо установить NorrCompetition AUP Plugin.
Настройки интеграции AUP в NorrCompetition
Настройки интеграции AUP в NorrCompetition

Выберите "Да" если хотите, чтобы AUP правила обрабатывались во всех конкурсах. Если вам требуется ручной выбор, для каких конкурсов нужна интеграция с AUP, это можно сделать путем переопределения соответствующего параметра в настройках конкурса. Перейдите в режим редактирования конкурса и выберите таб "Основные параметры". В нижней части области контента найдите Настройки интеграции. У неё три состояния: Да, нет и По умолчанию. Таким образом, вы можете индивидуально включать, отключать интеграцию с AUP для конкретного конкурса или использовать глобальные настройки.

Настройки интеграции AUP в режиме редактирования конкурса - NorrCompetition
Настройки интеграции AUP в режиме редактирования конкурса

Это может быть полезным в случае, если вам потребуется исключить некоторые конкурсы из обработки правил AUP. Ну вот, всё готово. Теперь вы можете назначать правила AUP пользователям за действия, выполняемые ими в NorrCompetition.

6. Правила для JComments и Komento

Комментарии от социальных сетей (Вконтакте, Facebook или Google+) подгружаются как внешние скрипты и их события невозможно контролировать. Однако мы легко можем назначать баллы за действия, выполняемые в компонентах комментариев от сторонних разработчиков. Например, JComments или Komento. Оба компонента имеют набор правил как для
AlphaUserPoints, так и для AltaUserPoints (AUP).

6.1. JComments

6.1.1. Правила AlphaUserPoints

Перейдите на данную страницу и нажмите на ссылку Скачать JComments AlphaUserPoints 3.0 для Joomla 2.5+ для скачивания дистрибутива с официального сайта. Данный файл является установочным пакетом, который содержит набор правил и устанавливается через менеджер установок Joomla.

6.1.2. Правила AltaUserPoints

Откройте тему на форуме и скачайте файл plg_jcomments_altauserpoints.zip, прикреплённый к сообщению. Другой способ: вы можете скачать правила с сайта разработчика Nordmograph. Установочный пакет содержит все необходимые правила и устанавливается через менеджер установок Joomla.

6.1.3. Список правил

Оба дистрибутива для AlphaUserPoints и для AltaUserPoints включают следующие правила:

  • Add comment - Присвоение баллов за добавление пользователем комментария.
  • Comment has voted as bad - Присвоение баллов автору если комментарий получил негативный голос.
  • Comment has been deleted - Присвоение баллов автору за удаление его комментария.
  • Comment has been published - Присвоение баллов автору за публикацию его комментария.
  • Comment has been reported - Присвоение баллов автору если на его комментарий была оставлена жалоба другим пользователем.
  • Comment has been unpublished - Присвоение баллов автору за снятие его комментария с публикации.
  • Comment has voted as good - Присвоение баллов автору если его комментарий получил положительный голос.
  • Report comment - Присвоение баллов пользователю за жалобу на комментарий
  • Vote comment - Присвоение баллов пользователю при голосовании за комментарий.

6.2. Komento

6.2.1. Правила для AlphaUserPoints

Перейдите в файловый архив Stackideas и скачайте Komento AUP's rules. Данный архив не является установочным пакетом и содержит правила в формате .XML. Вам нужно распаковать архив, извлечь файлы и установить / импортировать правила вручную. После того, как скопируете файлы в соответствующую папку, перейдите в Панель Администратора > Расширения > AltauserPoints и нажмите на кнопку Автоматическое определение новых правил в панели инструментов.

Автоматическое определение новых правил в AltaUserPoints
Автоматическое определение новых правил в AltaUserPoints

6.2.2. Правила для AltaUserPoints

На текущий момент нет официального релиза правил для AltaUserPoints. Вы можете взять правила для AlphaUserPoints и переименовать в них классы или связаться с разработчиком расширения.

6.2.3. Список правил

Дистрибутив включает в себя следующие правила:

  • Comment added to article - Присвоение баллов автору статьи, если пользователь оставляет комментарий в данной статье.
  • Comment liked - Присвоение баллов автору комментария, если другому пользователю нравится комментарий.
  • Comment removed - Вычитание баллов у автора комментария если комментарий удалён.
  • Comment reported - Вычитание баллов у автора комментария если пользователь жалуется на комментарий.
  • Comment sticked - Добавление баллов автору если его комментарий закреплён.
  • Comment unliked - Вычитание баллов у автора комментария если пользователю не нравится комментарий.
  • Comment unreported - Вычитание баллов у автора комментария если пользователь отменяет жалобу на комментарий.
  • Comment unsticked - Вычитание баллов у автора комментария если его комментарий откреплен.
  • Like a comment - Добавление баллов автору если пользователю нравится комментарий.
  • Post new comment - Добавление баллов пользователю за добавление комментария.
  • Comment removed from article - Вычитание баллов у автора статьи если комментарий к данной статье удалён.
  • Reply comment - Добавление баллов пользователю если пользователь отвечает на комментарий.
  • Report Comment - Добавление баллов пользователю если пользователь подаёт жалобу на комментарий.
  • Unlike a comment - Вычитание баллов у пользователя если пользователю не нравится комментарий.
  • Unreport Comment - Добавление баллов пользователю если пользователь отменяет жалобу на комментарий.