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

Обновление: 1 месяц назад

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

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

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

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

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

999
Продолжительная поддержка
по-умолчанию, поддержка приобретенного товара осуществляется в течении 6 месяцев с даты приобретения
В корзину

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

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

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

 

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

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

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

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

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

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

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

Доступные типы на данный момент:

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

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

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

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

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

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

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

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

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

За выставленные / полученные оценки рейтинга

За кол-во поставленных оценок (все и по типу)

За сумму поставленных оценок (все и по типу)

За кол-во полученных оценок (все и по типу)

За сумму полученных оценок (все и по типу)

За кол-во записей в определенной категории

За кол-во комментариев

За кол-во подписок

За кол-во подписчиков

За N дней с момента регистрации - выдается при логине, учитывается сколько дней прошло с момента регистрации

За кол-во созданных закладок

За кол-во закладок на все записи пользователя

За кол-во закладок на 1 запись пользователя

За кол-во вступлений в группы

За кол-во участников в 1 группе

За кол-во участников во всех группах

За кол-во тем на форуме PrimeForum

За кол-во ответов на форуме PrimeForum

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

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

Продается за рейтинг - Эти достижения юзер сможет купить за рейтинг

Продается за баланс - Эти достижения юзер сможет купить за баланс

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

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

Награда (баланс / рейтинг) - тут можно указать какую награду начислить юзеру за получение достижения

Награда (титул) - тут можно указать титул за получение достижения. Юзер в настройках профиля сам сможет выбрать какой титул из всех ему доступных показывать

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

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

 

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

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

 

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

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

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

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

Так же добавляется кнопка "Удалить достижения" где можно удалить и пользователя какие-либо выданные вручную достижения

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

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

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

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

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

Настройка вкладки "Все достижения" - возможность выбрать какие достижения отображаются на вкладках в ЛК (выданные вручную или автоматически или оба типа)

 

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

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

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

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

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

 

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

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

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

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

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

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

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

lk_all_achiev.php - шаблон вывода всех достижений юзера

lk_all_achiev_not_earn.php - шаблон вывода всех достижений юзера которые он не получил

userlist_achiev.php - шаблон вывода достижений в списке пользователей (а так же в конце записи, если у вас этот блок включен)

achieves_single_userlist.php - шаблон вывода списка юзеров на странице достижения (шорткод)

all_achieves_page.php - шаблон вывода достижений на странице со списком достижений (шорткод)

achieves_history.php - шаблон вывода истории получения достижений (шорткод)

achieves_shop.php - шаблон вывода достижений для продажи

при желании вы можете их скопировать в /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 достижения

 

Шорткод

Внимание! После установки шорткода зайдите в опции плагина и укажите страницу на которой размещен шорткод.

С помощью [ achieves_stats ] вы сможете просматривать:

Историю достижений

Список всех достижений, где так же отображается кол-во юзеров получивших достижение

Страницу достижения, где отображаются все пользователи получившие достижение

Шорткод [ achieves_shop ]

С его помощью вы сможете вывести достижения которые продаются за рейтинг / баланс

На странице шорткода есть ajax навигация, ajax фильтрация и ajax покупка

Пример работы шорткода: https://youtu.be/Mw14INpE1UY

Отображение достижений

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

 

Заключение

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

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

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

2.1.1

* Изменен шаблон отображения всплывающей подсказки достижения

2.1

* Фиксы нотисов php
* Изменено редактирование имени и описания достижения, теперь в описании можно использовать html
* Добавлены новые типы достижений которые можно покупать за рейтинг и баланс
* Добавлен шорткод [ achieves_shop ] с помощью которого можно выводить достижения доступные для покупки

2.0.1

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

1.9

* Изменен способ группировки достижений
* Добавлен новый тип награды за достижение: "Титул"

1.8.2

* Исправлена работа группировки достижений

1.8.1

*Достижение за регистрацию выдается корректно

1.8

*Добавлена возможность указать награду за получение достижения: Рейтинг и Баланс
*Изменен способ отображения всплывающей подсказки с описанием ачивки, теперь она всегда должна отображаться корректно
*Добавлена опция для группировки выводапоследних достижений юзера (см комментарии)

1.7

*Новые типы достижений:
За N дней с момента регистрации (выдается при логине юзера)
За кол-во подписок на пользователей
За кол-во подписчиков
За кол-во вступлений в группы
За кол-во участников в одной группе (выдается админу группы)
За кол-во участников во всех группах юзера
За кол-во созданных закладок
За кол-во закладок на ВСЕ записи юзера (считает сколько раз ВСЕ записи пользователя добавлялись в закладки)
За кол-во закладок на ОДНУ запись юзера (считает сколько раз ОДНА запись пользователя добавлялась в закладки)

1.6.1

*Небольшие фиксы стилей

1.6

*Добавлена постраничная навигация в список достижений в ЛК, ajax
*Добавлен вывод достижений в список пользователей и в блок автора на странице записи
*Добавлена возможность фильтровать достижения по типу в админке
*Добавлен шорткод [ achieves_stats ] который имеет 3 страницы:
1. (по-умолчанию) страница с историей достижений по всему сайту.
2. Страница со списком всех достижений на сайте, где так же отображается кол-во юзеров получивших это достижение
3. Страница достижения, где отображаются пользователи получившие это достижение
*Добавлены шаблоны для нового шорткода
*Добавлена возможность добавлять свой тип достижений
*Теперь список всех достижений (полученных и нет) в ЛК юзера кликабельны, они ведут на страницу достижений где можно посмотреть кто его получил
*Больше не помню, но что то еще делал

1.5

*Добавлены опции настроек отображения вкладок "Полученные достижения" и "Не полученные достижения"
*Добавлена новая кнопка в ЛК "Удалить достижение" - позволит вам удалять достижения пользователя, которые вы выдали в ручную.
*Добавлен новый тип достижений - "За кол-во постов в категории"

1.4

*Добавлена вкладка в область counter с достижениями пользователя. Внутри вкладки можно посмотреть все достижения пользователя и достижения которые он еще не получил
*Сабвкладки с достижениями пользователя и с не полученными достижениями пользователя имеют свой шаблон, можете копировать его к себе и изменять
*Исправлено отображение кнопки "Выдать достижений"
*Исправлено подключение скриптов в админке

1.3

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

1.2

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

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

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

Партнерская программа: Товар участвует в партнерской программе

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

5

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

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

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

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

не в сети 13 минут

Preci

534

1

Комментарии: 201Публикации: 36Регистрация: 11-11-2014Продаж/Покупок: 1095/36