Документация

Обновление: 6 дней назад

Версия файла: 1.3

Поддержка WP-Recall: 15.9.0 и выше

Приобрели: 3 раз

Активных установок: 3

Добавлено в закладки: 3

Написание этого дополнения я задумал еще весной, но тогда я не мог придумать варианта реализации и вот, спустя более чем пол года мои знания немного улучшились и я наконец смог это сделать.

С помощью дополнения Система достижений для WordPress вы сможете создавать свои достижения, указывая им имя, описание и изображение. А затем выбирать способ выдачи достижений - автоматически или вручную.

Теперь давайте по пунктам.

 

Создание достижений

Для создания достижения вам надо перейти в админку и открыть страницу wp-recall->система достижений.

Форма добавления пока спартанская, но, надеюсь, понятная.

Описание полей в форме добавления

Имя: Название достижения. (Например: За 10 комментариев или Самый активный комментатор!)

Описание: Описание достижения. Оно будет отображаться в подсказке при наведении на достижение.

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

Доступные типы на момент релиза:

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

Стандартные типы записей (post) - Достижение будет выдаваться только за записи типа "post" (стандартные записи wordpress)

Кастомные типы записей  - достижение будет выдаваться только за записи типа, который указан в скобках. На выбор будут доступны ВСЕ типы постов которые зарегистрированы у вас на сайте. Например на моем тестовом сайте выбор такой:

Кастомные типы записей (forum) - Количество созданных форумов bbpress

Кастомные типы записей (topic) - Количество созданных тем на форуме bbpress

Кастомные типы записей (reply) - Количество созданных ответов на форуме bbpress

Кастомные типы записей (products) - Количество добавленных товаров (это из магазина recall)

Кастомные типы записей (video) - Количество добавленных видео (это видео recall)

Кастомные типы записей (post-group) - Количество записей в группах (группы recall)

Группы - Достижение будет выдаваться за количество созданных групп (группы recall)

За регистрацию - Достижение будет выдаваться за регистрацию на сайте

Разное - Этот тип достижения стоит выбирать если вы хотите создать свое достижение с РУЧНОЙ выдачей.

Счетчик: Количество необходимое для получения достижения. Например если вы выбрали тип "Комментарии" - то количество комментариев, если тип "Все записи" - то количество записей любого типа, если тип "Кастомные типы записей (post-group)" то количество записей в группах и т.д.

Статус: Тут вы можете выбрать выдавать достижение автоматически или только вручную

Изображение: Тут необходимо указать id изображения достижения. Нажав на кнопку "Вставить изображение" откроется стандартное окошко изображений wordpress, где вы сможете выбрать изображение или загрузить новое.

 

Редактирование достижений

На данный момент для редактирования достижений доступны только 2 поля: имя и описание. Что бы отредактировать их - просто кликните по нужному имени или описанию 2 раза и у вас появится возможность его отредактировать. Затем нажмите "Сохранить" и изменения сохранятся.

 

Ручная выдача достижений

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

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

Нажав на кнопку "Наградить" пользователь получит выбранное достижение.

 

Опции плагина

На данный момент их немного

На момент релиза доступны опции:

Кто может выдавать достижения? - По умолчанию их может выдавать только супер администратор, тут вы можете указать id пользователей которым будет доступна эта возможность. Указывайте каждого пользователя в новом поле.

Уведомлять при получении достижения? - Если включить, то пользователь получит уведомление при получении достижения. По-умолчанию выкл.

Настройки отображения - количество последний достижений, которое нужно отображать

 

Как выдаются достижения?

Было 2 варианта решения: либо при совершении действия считать сколько у юзера постов, комментариев и т.п. и выдавать все доступные му ачивки, либо вводить новый счетчик и выдавать достижения по нему.

Я выбрал 1ый вариант, т.к. при введении нового счетчика все пользователи начинали бы свою статистику с нуля и могли, например, на 1010 комментарии получить ачивку за 10 комментариев - мне показалось это не правильным.

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

Благодаря такому подходу подсчет работает только в момент совершения действия, во время серфинга по сайту ничего не считается.

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

 

Где выводятся достижения?

На данный момент доступны выводы в личном кабинете и на форуме PrimeForum

 

Как выводятся достижения?

Через функцию подключение шаблона wp-recall

В папке с дополнением/templates на момент релиза есть 2 шаблона:

lk_achiev.php - шаблон вывода в личном кабинете

primeforum_achiev.php - шаблон вывода на форуме PrimeForum

при желании вы можете их скопировать в /wp-content/wp-recall/templates и отредактировать под свой сайт.

Внутри шаблона доступен массив $achiev;

$achiev['name'] - имя достижения

$achiev['descr'] - описание достижения

$achiev['type'] - тип достижения

$achiev['count'] - счетчик для получения достижения

$achiev['img_url'] - url изображения достижения

$achiev['status'] - статус достижения (1 - автоматически, 0 - вручную)

$achiev['date'] - дата получения достижения юзером

$achiev['ID'] - ID достижения

 

Заключение

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

Цена на дополнение так же вырастет по мере роста функционала, так что если вы сомневаетесь, то учитывайте это.

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

Стандартная. Выбрать архив с дополнением и нажать "Установить". Или ручками поместить папку дополнения в /wp-content/wp-recall/add-on/

1.3

*Добавлены новые типы достижений:
За темы на форуме PrimeForum
За ответы на форуме PrimeForum
*Добавлены настройки уведомления.
Если вы включите уведомления, то вам будет предложено настроить шаблон уведомлений
В заголовке уведомления вы можете подставить %name% - будет заменено на имя полученного достижения
В содержании уведомления вы можете подставить %name%, %descr% - будет заменено на описание достижения и %img% - будет заменено на иконку достижения
*Добавлена возможность редактировать иконку изображения. Для этого просто кликните по иконке 2 раза и откроется стандартный медиаредактор wordpress, где вы сможете загрузить новое изображение или выбрать из существующих
*В личном кабинете перед достижениями пользователя добавлен текст "Достижения"
*Переписаны обращения в базе

1.2

*Добавлены новые типы достижений:
За количество полученного рейтинга (любой тип)
За количество полученного рейтинга (по типу рейтинга)
За сумму полученного рейтинга (любой тип)
За сумму полученного рейтинга (по типу рейтинга)
*Фикс отображения кнопки "Выдать достижение", которая показывалась всем юзерам
*Фикс поля "Счетчик" (disabled не сбрасывался после добавления ачивки)
*Добавлена навигация в админку со списком достижений. Теперь настранице отображается 20 достижений (навигация ajax без обновления страницы)
= 1.1 =
*Добавлены новые типы достижений:
За количество выставленного рейтинга (любой тип)
За количество выставленного рейтинга (по типу рейтинга)
За сумму выставленного рейтинга (любой тип)
За сумму выставленного рейтинга (по типу рейтинга)
*Фикс достижения за регистрацию
= 1.0 =
*Релиз

Условия поддержки: На форуме

Контактные данные: Личные сообщения

Авторство: Товар опубликован его непосредственным автором

0

Форум поддержки:

При возникновении проблемы, создайте соответствующую тему на форуме поддержки товара

Помните! Данный продукт защищен авторским правом, его нарушение влечет за собой административную и уголовную ответственность

Автор публикации

322

1

Комментарии: 155Публикации: 32Регистрация: 11-11-2014Продаж/Покупок: 861/29