Плагин [CMTV] Criteria Builder 1.0.1

Описание

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

Существуют некоторые другие системы, использующие систему критериев XenForo: уведомления при показе баннера, рекламные акции для групп пользователей.

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

• Приз "Коллекционер" за добавление 100 закладок
• Приз "Ненавистник" за оставленные 333 :безумный: реакции
• Показывать баннер с текстом "Спасибо" пользователям, которые ответили более 1000 раз на форуме "Вопросы"
• Предоставьте пользователям права администратора для создания 888 тем на форуме "Не по теме"
• ОПИШИ ЗДЕСЬ СВОЮ МЕЧТУ_TROPHY_HERE

Короче говоря, Criterions Builder может выполнять все перечисленные выше действия и даже больше.

Это позволяет вам импортировать / экспортировать критерии так же просто, как импортировать / экспортировать смайлики.
Не нашли критерий, который вы хотели? Не большая проблема. Вы можете написать свой собственный, не покидая ACP!

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

Это дополнение с открытым исходным кодом. Посетите репозиторий GitHub для получения исходного кода.

Характеристики

Полный контроль со стороны ACP

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

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



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

Критерии могут быть импортированы из .xml файла. Это может быть набор критериев, загруженных с этого форума. Или, может быть, вы просто хотите перенести критерии с одного вашего форума на другой.

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



Теперь вам нужно выбрать, какие критерии импортировать, а какие обновить:




Вы также можете редактировать новые критерии прямо на странице "Разрешение":



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

Когда вы импортировали (или создали) некоторые критерии, вы можете выбрать их при создании награды / уведомления / поощрения группы пользователей:



Создание пользовательских критериев

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

Первым шагом является заполнение информации о критерии:



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



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

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

К счастью, Criterions Builder позволяет создавать "параметры критериев", значения которых можно задавать при создании трофея / уведомления и т.д.!

Таким образом, вам нужно создать критерий "Добавленные закладки" только с одним параметром: количеством добавленных закладок. Вы можете получить значение параметра в PHP-коде criterion!

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



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



В конструктор критериев встроено 8 параметров (другие могут быть легко добавлены с помощью дополнений):

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

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

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



Расширяемый

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

Более того, вы можете прослушать CMTV_CB_criteria_types событие, чтобы добавить поддержку вашего собственного типа критериев!
___

Установка

1. Загрузите дополнение
2. В панели управления администратора перейдите в раздел "Дополнения", нажмите "Установить / обновить из архива" и выберите загруженный архив дополнений

Импорт базовых критериев

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

Категория "Коммуникация":

• Отправленные сообщения
  • Несколько сообщений
  • Форумы
  • Отображается / Удаляется / модерируется
• Сообщения, размещенные в теме
  • Идентификатор потока
  • Отображается / Удаляется / модерируется
• Созданные темы
  • Несколько потоков
  • Форумы
  • Префиксы
  • Отображается / Удаляется / модерируется

Категория "Закладки":

• Добавлены закладки
  • Несколько закладок

Повторная установка

1. Удалите дополнение из ACP
2. Перейдите в корневую папку форума и удалите src/addons/CMTV/CriteriaBuilder и js/CMTV/CriteriaBuilder папки.

Вот и все!