Top User By Rating PRO - Дополнение позволит вам строить ТОП пользователей сайта по рейтингу

Top User By Rating PRO - дополнение для WP recall, которое позволит вам выводить ТОП пользователей вашего сайта по рейтингу.

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

Параметры шорткода

Для вывода ТОПа используется шорткод [ tubr ], который может принимать следующие параметры:

template - шаблон вывода (список шаблонов с примерами смотрите ниже)

По-умолчанию "block"

sorting - Может быть 1 или 0  - определяет выводить ли перед ТОПом select для сортировки по времени

По-умолчанию - 1 (включено)

paged - Может быть 1 или 0 - определяет выводить ли постраничную навигацию

По-умолчанию - 0 (выключено)

per_page - Любое число - определяет сколько пользователей будет выводиться на странице (если навигация выключена, то просто сколько пользователей будет отображаться)

По-умолчанию - 50

period - Определяет за какой промежуток времени строить топ пользователей.

0 - за все время

Любое число больше 0 - за данное кол-во дней

from_date:to_date - за данный промежуток. Например 01.03.2019:01.04.2019 - за март 2019 года

{current_week} - Текущая неделя

{current_month} - Текущий месяц

{previous_week} - Предыдущая неделя

{previous_month} - Предыдущий месяц

По-умолчанию - 30 (30 дней)

rating_type - типы рейтинга, которые участвуют при построении топа (можно указывать несколько через запятую) Например если вы хотите построить ТОП учитывая только рейтинг комментариев, укажите "comment", если комментариев и постов, то укажите "comment,post"

По-умолчанию - все

cache_time - Время кеширования, если включено кеширование recall (в секундах)

По-умолчанию - 21600

exclude - ID пользователей, которые будут исключены из ТОПа (можно указывать несколько через запятую)

include - ID пользователей, из которых будет состоять ТОП (можно указывать несколько через запятую) - например если вы хотите провести конкурс среди 5 определенных пользователей, кто их них наберет больше рейтинга за неделю. Тогда укажите ID этих пользователей и в ТОПе будут только они.

exclude_role - роли пользователей которые будут исключены из ТОПа (можно указывать несколько через запятую)

10 - Admin, 7 - Editor, 2 - Author, 1 - Contributor, 0 - Subscriber

include_role - роли пользователей из которых будет состоять ТОП

10 - Admin, 7 - Editor, 2 - Author, 1 - Contributor, 0 - Subscriber

Место пользователя в ТОПе

При включении соотв. опции в настройках дополнения вы сможете выводить в ЛК пользователя его место в общем рейтинге

Важно! После включения вывода места, не забудьте в настройках указать страницу где размещен шорткод с ТОПом за все время (с параметром period="0")

Опции дополнения

На странице настроек recall появится раздел Tubr PRO где вы сможете настроить дополнение:

Первые 2 опции мы разобрали в предыдущем разделе.

Исключить пользователей / исключить роли - позволит вам исключить данных пользователей при подсчете места пользователя в общим рейтинге в ЛК.

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

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

В настройках фильтрации вы сможете настроить выпадающее меню фильтрации ТОПа

Например если вы не хотите отображать фильтр "За 3 месяца", то просто удалите соотв. строчку в настройках.

А если вы хотите добавить новый фильтр, например за декабрь 2019 года, то добавьте в опции новую строчку:

01.12.2019:31.12.2019 => За декабрь 2019

Так же вы можете менять фильтры местами, или же менять их названия.

Доступные шаблоны

Имя шаблона нужно указывать в параметре шорткода template="ИМЯ ШАБЛОНА"

Имя: block

Имя: block2

Имя: list

Имя: list2

Имя: circle

Имя: mini

Примеры шорткодов

Важно! После копирования шорткода не забывайте убирать пробелы между квадратными скобками.

Шорткод с выводом ТОПа за текущий месяц, используя шаблон circle, с постраничной навигацией и 30 пользователями на странице:

<pre>

[ tubr paged="1" per_page="30" template="circle" period="{current_month}" ]

</pre>

Шорткод вывода ТОП 10 пользователей за все время, без постраничной навигации, без фильтра, исключив пользователя с ID 1, используя шаблон mini

<pre>

[ tubr paged="0" per_page="10" template="mini" period="0" exclude="1" sorting="0" ]

</pre>