Шорткоды

Весь функционал плагина ABC Pagination работает через шорткод.

[abc_pagination]

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

Например, для выборки записей из рубрики с ID 3, нам нужно добавить атрибут cat:

[abc_pagination cat="3"]

Атрибуты задаются через пробел, значение атрибута задается в кавычках.

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

Настройки

Атрибуты для фильтрации совпадают с аргументами get_posts(), если нужны будут дополнительные — пишите в поддержку.

count по умолчанию: 1000
Ограничение на максимальное количество постов, чтобы не перегрузить сервер. Если у вас больше 1000, вы можете увеличить это значение

cat по умолчанию: пусто
Через запятую можно указать id нужных рубрик для вывода постов и со знаком минус для скрытия, например: cat=”4,7,-8″

category_name по умолчанию: пусто
Через запятую можно указать ярлыки (slug) рубрик для вывода постов, например: category_name=”seo,ogorod”

tag по умолчанию: пусто
Через запятую можно задать ярлыки (slug) нужных меток для вывода постов с этими тегами, например: tag=”seo,design,ogorod”

author по умолчанию: пусто
Через запятую можно указать id нужных авторов, например: author=”1,3,-4″

post_type по умолчанию: post
Через запятую можно указать типы нужных постов. Для вывода терминов из произвольного типа постов “Глоссарий” можно указать значение post_type="glossary"

exclude по умолчанию: пусто
Через запятую можно указать id нужных постов для скрытия

include по умолчанию: пусто
Через запятую можно указать id нужных постов для вывода

tax_query по умолчанию: пусто
Выборка из таксономий, аналог tax_query в WP_Query. Состоит из 3 значений, указанных через &. Например: taxonomy=people&field=slug&terms=bob

post_parent по умолчанию: пусто
ID родительской страницы, дочерние страницы для которой надо получить

Настройки > Список букв

show_letters по умолчанию: зависит от настроек плагина
Показать список букв

show_counts по умолчанию: зависит от настроек плагина
Показать количество постов для каждой буквы

show_search (с версии 1.2.0) по умолчанию: 0.
Включить поиск в алфавитном указателе. Поиск происходит по заголовкам постов.

alphabet (с версии 1.1.0) по умолчанию: пустая строка.
Если значение указано, задает порядок сортировки букв в списке, например, “абв 123”. Также буквы (и посты, названия которых начинаются на такие буквы), которые не включены в алфавит, не будут выводится. Поменять это поведение можно с помощью хука abc_pagination/functions/strict_match_alphabet

Настройки > Список постов

type по умолчанию: list
Тип вывода постов. Возможные значения: list, tabs или popup

show_tab_letter по умолчанию: 1
Показать букву в списке постов. Возможные значения: 0 или 1

show_post_link по умолчанию: 1
Включить ссылки на посты. Возможные значения: 0 или 1

show_post_thumb по умолчанию: 1
Показать миниатюры постов. Возможные значения: 0 или 1

show_post_excerpt по умолчанию: 0
Показать описание постов. Возможные значения: 0 или 1.

show_post_content по умолчанию: 0
Показать контент постов. Возможные значения: 0 или 1.

posts_short_title по умолчанию: 1
Использовать короткое название вместо заголовка. У каждой записи есть мета-поле, в котором можно задать короткое название для сортировки и вывода в алфавитном указателе. Если вы задали короткое название, то оно же будет использоваться для вывода на сайте. Если передать в этом атрибуте 0, то для вывода будет использоваться просто заголовок записи.

show_posts_limit (с версии 1.2.0) по умолчанию: -1
Позволяет ограничить вывод постов у каждой буквы указанным количеством и в случае превышения этого количества будет выводиться ссылка “показать еще”. Значение -1 убирает ограничение.

Внешний вид > Список букв

Почти все атрибуты ниже совпадают с CSS-свойствами (подробнее про свойства). Не забудьте указать единицы измерения.

Контейнер с буквами

letters_text_before (с версии 1.1.0) по умолчанию: пустая строка.
Текст для вывода перед буквами.

letters_text_after (с версии 1.1.0) по умолчанию: пустая строка.
Текст для вывода после букв

letters_gap по умолчанию: .5em (из настроек плагина)
Расстояние между буквами

letters_padding по умолчанию: .5em (из настроек плагина)
Внутренний отступ

letters_background по умолчанию: #eaeff6 (из настроек плагина)
Фоновый цвет блока

letters_justify_content по умолчанию: center (из настроек плагина)
Выравнивание букв, например: start, center, end, space-evenly, space-around, space-between

letters_border_radius по умолчанию: .5em (из настроек плагина)
Скругление у блока

Буквы

letter_padding по умолчанию: .3em .6em (из настроек плагина)
Внутренний отступ

letter_color по умолчанию: #ffffff (из настроек плагина)
Цвет букв (про цвета CSS)

letter_background по умолчанию: #74B423 (из настроек плагина)
Фон букв (про цвета CSS)

letter_hover_color (с версии 1.1.0) по умолчанию: #ffffff.
Цвет при наведении на букву.

letter_hover_background (с версии 1.1.0) по умолчанию: #5e9617.
Цвет фона при наведении на букву

letter_hover_effect (с версии 1.1.0) по умолчанию: пустая строка.
Возможные значения grow, shrink, push, pop, float

letter_border_width (с версии 1.1.0) по умолчанию: пустая строка.
Ширина рамки. Можно задавать значения с единицами измерения css, например 2px или 0.5em

letter_border_style (с версии 1.1.0) по умолчанию: solid
Стиль рами, возможные значения solid, dotted, dashed, double

letter_border_color (с версии 1.1.0) по умолчанию: пустая строка.
Цвет рамки.

letter_font_weight по умолчанию: bold (из настроек плагина)
Толщина шрифта

letter_font_size по умолчанию: 1em (из настроек плагина)
Размер шрифта

letter_border_radius по умолчанию: .3em (из настроек плагина)
Скругление углов

Внешний вид > Список постов

Буквы

tab_letter_width по умолчанию: auto (из настроек плагина)
Ширина буквы в списке постов, по умолчанию растягивается на всю ширину

tab_letter_margin по умолчанию: 1.5em 0 .5em (из настроек плагина)
Внешние отступы у буквы

tab_letter_padding по умолчанию: .3em 1em (из настроек плагина)
Внутренние отступы

tab_letter_font_weight по умолчанию: bold (из настроек плагина)
Толщина шрифта

tab_letter_font_size по умолчанию: 1.3em (из настроек плагина)
Размер шрифта

tab_letter_text_align по умолчанию: left (из настроек плагина)
Выравнивание текста, например: left, center, right

tab_letter_color по умолчанию: #111 (из настроек плагина)
Цвет буквы (про цвета CSS)

tab_letter_background по умолчанию: #eaeff6 (из настроек плагина)
Фон буквы (про цвета CSS)

tab_letter_border_radius по умолчанию: .2em (из настроек плагина)
Скругление углов

Посты

posts_image_height по умолчанию: 200px (из настроек плагина)
Высота миниатюр постов

posts_columns по умолчанию: 3 (из настроек плагина)
Колонки в десктопной версии

posts_columns_mobile по умолчанию: 1 (из настроек плагина)
Колонки в мобильной версии

posts_gap по умолчанию: .8em
Отступы между колонками

posts_title_font_weight с версии (1.1.0) по умолчанию:400
Толщина шрифта заголовка поста

posts_show_id с версии (1.2.0) по умолчанию: 0
Добавляет атрибут id у блоков с постами, который затем можно использовать в адресной строке браузера, например your-site.com/glossary/#termin-1

Атрибут name

Дополнительно можно указать атрибут name, чтобы задать дополнительный класс для блока .abc-pagination. Кроме класса этот атрибут может использоваться для определения, какой именно шорткод вызывается в хуке abc_pagination/get_posts/args.

Асинхронная подгрузука алфавитного указателя

ajax (с версии 1.2.0) по умолчанию 0. Если указать этот параметр, то указатель будет загружаться скриптом отдельно после отрисовки страницы.