Top object by rating - Позволяет отображать топ объектов по рейтингу

Top object by rating - позволит вам через шорткод отображать ТОП объектов по рейтингу, а так же создавать свои шаблоны вывода.

Как вы знаете рейтинг ставится не только пользователю, но и объекту этого пользователя, будь то: комментарий, пост, видео и т.п. - у вас может быть зарегистрировано что-то свое. Так вот для вывода этих объектов по рейтингу из предназначено это дополнение. Если же вам интересно отобразить топ пользователей, то можете посмотреть аналогичное дополнение: Top user by rating

Вывод ТОПа объектов

Осуществляется через шорткод [ top_object_rating ] который может принимать следующие атрибуты:

type - тип объекта (post, comment, video - плюс у вас может быть что-то свое)

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

templates - имя шаблона для вывода объектов.

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

По-умолчанию "block" в комплекте на данный момент 6 шаблонов и все они только для постов (type='post'):

block - вывод плиткой в 3 колонки

list - вывод горизонтальными линиями

flex-3 - вывод через display:flex в 3 колонки. Обязательно при использовании этого типа оберните вывод в блок с указанной высотой, например в < div style="height:300px;" >< /div >

mini-block - для сайдбара, вывод блоками по 1му

mini-block2 - аналог предыдущего, только 2 блока в линию

mini-list - минималистичный вид, просто нумерованный список

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

Для создания своего шаблона можете посмотреть готовые примеры в папке templates, которая внутри папки дополнение. Даете своему шаблону имя ОБЪЕКТ-tobr-ВАШЕИМЯ.php и помещаете его в папку /wp-content/wp-recall/templates/

Где ОБЪЕКТ - тип объекта (post,comment,video и т.п.)

ВАШЕИМЯ - имя шаблона, которое вы будете указывать в атрибуте templates

Так же хочу отметить что вы можете взять готовый шаблон дополнения и поместить его в папку /wp-content/wp-recall/templates/ даже не переименовывая, в таком случае он будет иметь больший вес перед подключением, чем тот что в папке с дополнением и вы сможете его редактировать.

sorting - включать или нет вывод списка для сортировки, по-умолчанию включено. (1 - включено, 0 - выключено)

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

При включении перед ТОПом объектов отобразится выпадающий список, в котором вы сможете выбрать за какой промежуток отобразить ТОП. Обновление ТОПа происходит через ajax без перезагрузки страницы. По-умолчанию selected установлено на "За месяц", однако если вы выберете свой промежуток времени через параметр day (ниже) то в селект добавится новый options с вашим кол-вом дней и он будет selected.

limit - Сколько объектов отображать.

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

day - За какой промежуток времени считать набранный рейтинг.

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

Если установить значение "all" то будет считаться рейтинг за все время.

exclude - id объектов которые стоит исключить из выборки

По-умолчанию "" - пусто

cat - id категорий через запятую,  из постов которых будет строиться рейтинг

По-умолчанию "" - пусто

paged - Включать или нет пагинацию, 1 - включить

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

cache_time - время кеширования ТОПа (по умолчанию 86400 - сутки) кеширование не распространяется на ajax

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

Примеры шаблонов:

[ top_object_rating type="post" templates="block"]

[ top_object_rating type="post" templates="list"]

[ top_object_rating type="post" templates="flex-3"]

[ top_object_rating type="post" templates="mini-block"]

[ top_object_rating type="post" templates="mini-block2"]

[ top_object_rating type="post" templates="mini-list"]