Criteria Builder 1.0.0

Описание

Если вы когда-нибудь пытались создать трофей, вы наверняка замечали вкладку "Присуждать трофей, если...". В ней вы можете указать условия (например, количество сообщений), которым нужно соответствовать для получения трофея.

Другие системы XenForo также используют систему критериев: объявления и повышения групп пользователей.

Проблема состоит в том, что доступных условий для выбора очень мало. Нет возможности создать по-настоящему интересные достижения. Вот небольшой список того, что вы не сможете сделать со стандартными условиями XenForo:

Достижение "Коллекционер" за добавление 100 закладок
Достижение "Ненавистник" за 333 недовольных реакций
Показывать баннер "Спасибо вам" пользователям, которые ответили больше тысячи раз в форуме "Вопросы"
Давать пользователям админские права за создание 888 тем в "Свободном общении"
ОПИШИТЕ ТРОФЕЙ СВОЕЙ МЕЧТЫ ЗДЕСЬ
Если коротко, Criteria Builder может сделать все вышеперечисленное и даже больше.

Аддон позволяет вам импортировать/экспортировать критерии также просто, как это делается со смайликами.

Не нашли подходящий критерий для импорта? Не проблема. Вы можете написать собственный!

Ваши возможности ограничены только вашей фантазией!

Все мои аддоны бесплатные...

Но если вы хотите

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



___

Ключевые моменты

Полный контроль из админ-панели

Нет нужды создавать критерии где-то вне форума и подключать их с помощью неудобного "Класс/метод" способа.

Вы можете импортировать, экспортировать и создавать критерии из одного места прямо в админ-панели:





Импорт критериев

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

Первым делом, перейдите на страницу "Импорт" и выберите .xml файл с критериями:





Далее, вам нужно указать, какие из новых критериев импортировать, а какие обновить. Да, код критериев может быть обновлен. Все как с аддонами.





Более того, вы можете редактировать некоторые значения критериев еще до их импорта:





Использование критериев

Когда вы импортировали (или создали) критерии, вы можете использовать их при создании трофея, объявления или повышения прав пользователя:





Создание критериев

Если вы знакомы с PHP, то можете создавать собственные критерии.

Сперва нужно указать базовую информацию о критерии:





После этого, вы можете писать PHP код прямо в админ-панели. Не нужно создавать .php файлы и загружать их в папку src :





Параметры критерия

Представьте, что вы хотите создать 3 трофея за добавление 1, 15 и 30 закладок на форуме. Чорт, похоже придется создавать три критерия с одинаковым кодом, меняя лишь число закладок...

К счастью, Criteria Builder позволяет создавать "параметры критериев", этакие поля, которые заполняются значениями на этапе создания трофея/объявления и так далее. То есть вы можете использовать один критерий для создания целого класса трофеев, просто меняя значения параметров!

Список параметров критерия:





Получение и использование значения параметра с помощью функции $get(PARAM_NAME) :





В Criteria Builder по умолчанию входят 8 типов параметров:

Текстовое поле (макс. длина, иконка, значение по умолчанию и соответствие регулярному выражению)
Число (макс. и мин. значения, стандартное значение, шаг)
Флажок (отмечен по умолчанию)
Выбор форума (Мульти/одиночный выбор)
Выбор группы пользователей (Мульти/одиночный выбор)
Выбор префикса темы
Выбор реакции
Дата и время + часовой пояс




Drag-and-drop сортировка

Установка значений "Порядка отображения" через отдельную страницу уже в прошлом. Теперь вы можете указать нужный порядок простым перетаскиванием революция :





Расширяемость

Можно создавать собственные типы параметров. Это настолько же просто, насколько просто создание собственных типов виджетов. Просто включите режим разработчика и создайте свой тип параметра на странице "Params definitions".

Более того, вы можете использовать евент CMTV_CB_criteria_types и добавить собственный тип критериев в Criteria Builder.

Установка

Скачайте аддон
В админ-панели перейдите на страницу "Аддоны", кликните по кнопке "Установить/обновить из архива" и выберите скачанный архив аддона
Импорт стартовых критериев

В загруженном архиве вы можете найти файл basic_criteria.xml . В нем есть 4 уже готовых критерия. Можете импортировать их (смотрите секцию "Импорт критериев" выше).

Категория "Communication":

Сообщений опубликовано
Количество сообщений
Форумы
Видимы/Удалены/Moderated?

Сообщений оставлено в теме
Количество сообщений
ID темы
Видимы/Удалены/Moderated?

Тем создано
Количество тем
Форумы
Префиксы
Видимы/Удалены/Moderated?

Категория "Bookmarks":

Закладок добавлено
Количество закладок

Удаление

Удалите аддон из админ-панели
Перейдите в корневую папку форума и удалите папки src/addons/CMTV/CriteriaBuilder и js/CMTV/CriteriaBuilder
Вот и все!

Все мои аддоны бесплатные...

Но если вы хотите

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