Top Object By Rating PRO - Позволяет выводит ТОП объектов (записей, изображений, видео ...) по рейтингу

Top Object By Rating PRO - позволит вам через шорткод выводить ТОП объектов на основе их рейтинга (стандартная система рейтинга recall).

Внимание! Дополнение строит ТОП на основе рейтинга recall, а значит у вас должно быть  активировано дополнение Rating System (идет в базовой версии recall)

На данный момент дополнение поддерживает вывод следующих объектов:

1. Записи - 5 шаблонов для вывода
2. Товары магазина recall - 1 шаблон
3. Изображения (галерея recall) - 1 шаблон
4. Видео (видео галерея recall) - 1 шаблон
5. Записи из групп recall - 1 шаблон

Все шаблоны максимально адаптивны и будут отлично смотреться как на ПК так и на телефонах.

На одной странице можно выводить сколь угодно ТОПов, они не будут конфликтовать между собой.

Шорткод для вывода ТОПа

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

type - тип объектов для которых строится ТОП.

Может быть: post, post_group, products, video, attachment

По умолчанию: ""

Пример: [ tobr type="video" ]

Важно! Это обязательный параметр, если вы ничего не укажите в type - ничего выводится не будет

template - какой шаблон использовать для вывода

Может быть: block, flex, flex-mini, list, list-mini

Внимание!

• шаблон block поддерживается всеми типами (записями, записями групп, товарами, видео, изображениями)
• шаблон list-mini поддерживается записями и товарами recall (post, products)
• Остальные шаблоны поддерживаются ТОЛЬКО записями типа post

По умолчанию: block

Пример: [ tobr type="video" template="block" ]

sorting - выводить ли перед ТОПом блок с сортировкой по датам, за которые строить ТОП

Может быть:

select - выводить выпадающим списком

line - выводить блоками в линию, ничего не указано - не выводить

По умолчанию: "" (пусто, не выводить)

Пример: [ tobr type="video" template="block" sorting="line" ]

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

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

<pre>

{previous_month}::Предыдущий месяц, 7::за 7 дней, 0::За все время

</pre>

т.е. запятыми мы разделяем отдельные опции, а символом "::" разделяем значение - читаемое название

По умолчанию: "" (пусто, использовать из настроек)

Пример: [ tobr type="video" template="block" sorting="line" sorting_period="{previous_month}::Предыдущий месяц, 7::за 7 дней, 0::За все время"  ]

period - За какой промежуток строить ТОП

Может быть:

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

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

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

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

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

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

По умолчанию: "30" (за последние 30 дней)

Пример: [ tobr type="video" template="block" period="{previous_month}" ]

cat_in  - позволяет строить ТОП только записями из из указанных категорий (указывать ID категорий)

Может быть: ID категории или список ID категорий, разделенных через запятую

Поддерживает типы записей: post, products

По умолчанию: "" (пусто, из всех категорий)

Пример: [ tobr type="post" template="block" cat_in="30,22,87,102" ]

author_in - позволяет строить ТОП только из тех объектов, которые принадлежат указанному (-ым) авторам

Может быть: ID пользователя или список ID через запятую

По умолчанию: "" (пусто, для всех авторов)

Пример: [ tobr type="video" template="block" author_in="1,8,987" ]

group_in - позволяет строить ТОП только из тех записей, которые опубликованы в указанных группах

Может быть: ID группы или список ID групп через запятую

По умолчанию: "" (пусто, из всех групп)

Пример: [ tobr type="post_group" template="block" group_in="1,8,987" ]

per_page - сколько элементов выводить на странице

Может быть: любое число

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

Пример: [ tobr type="video" template="block" per_page ="25" ]

paged - включать ли постраничную навигацию

Может быть: 1 - включено, "" - пусто, не включено

По умолчанию: "" (пусто, не включено)

Пример: [ tobr type="video" template="block" paged="1" ]

cache - включать ли кеширование recall

Может быть: 1 - включено, "" - пусто, не включено

По умолчанию: "" (пусто, не включено)

Пример: [ tobr type="video" template="block" cache="1" ]

cache_time - если кеширование включено, можно указать время жизни кеша в секундах

Может быть: любое число

По умолчанию: "3600" (1 час)

Пример: [ tobr type="video" template="block" cache="1" cache_time="7200" ]

Примеры внешнего вида

Стандартные записи

(type="post" template="flex")

(type="post" template="flex-mini")

(type="post" template="list")

(type="post" template="list-mini")

(type="post" template="block")

(type="post_group" template="block")

Товары магазина recall (type="products" template="block")

Изображения галереи recall (type="attachment" template="block")

Видео галереи recall (type="video" template="block")