WordPress вывести все таксономии

Таксономии

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

Начну с того, что таксономии нужны для группировки постов.

Каким образом? Ну возьмём к примеру хэштеги в инстаграм — когда вы постите фото и присваиваете ему теги — это как раз и есть та самая группировка, о которой я говорю. По умолчанию WordPress тоже поддерживает теги для постов, а ещё рубрики. И их можно объединить одним словом — таксономии.

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

1. Стандартные таксономии в WordPress

Рубрики и метки

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

А теперь мне нужно донести одну важную мысль.

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

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

Рубрики ссылок

Если рубрики и метки в WordPress были нужны для группировки записей, то данная таксономия, как понятно из названия — для группировки ссылок.

Если вы недавно установили WP, то вы не найдёте их у себя в админке. Дело в том, что с версии 3.5 ссылки по умолчанию сделали отключенными. Но не удалили — вставьте следующий код в файл functions.php вашей темы и ссылки вновь появятся у вас в админке. Вполне возможно, что вы найдете им применение.

Форматы постов

Форматы на самом деле с трудом можно назвать таксономией, но фактически это так. На моём блоге им посвящён отдельный пост.

2. Пользовательские таксономии

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

Чуть подробнее про регистрацию таксономии

Техническую сторону регистрации я подробно описал в статье про функцию register_taxonomy(). Сейчас же мы рассмотрим несколько моментов.

Регистрация таксономии бывает нужна, когда требуется добавить еще один критерий группировки постов, в особенности — произвольных типов постов.

Пример: вы зарегистрировали тип записей — Автомобили, и их нужно группировать скажем по марке, стране и по объему двигателя (хотя объем лучше затолкать в произвольные поля).

Как присваивать таксономии к различным типам записей

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

Если же изменение параметров регистрирующей функции не в вашей власти (возьмем те же рубрики и метки), тогда вы можете и должны использовать register_taxonomy_for_object_type().

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

Другие примеры смотрите в описании функции, ссылку на которое я дал вам выше.

Вывод таксономий в виде списка

Вы знакомы с функцией wp_list_categories()? Если нет, то наверняка видели, как на блогах рубрики выводятся в столбик в виде списка (иногда еще справа в скобках указывается количество постов в рубрике).

Самое интересное, что функция wp_list_categories() позволяет выводить элементы любой таксономии, достаточно лишь указать название таксономии в параметрах функции.

Где же брать название таксономии?

• Если таксономию создавали вы сами, то этот вопрос у вас не должен возникать.
• Если же нет, то просто откройте страницу этой таксономии и посмотрите на ссылку в браузере:

Более сложный, но в то же время более удобный и настраиваемый вариант — функция get_terms(). Если бы мне предложили выбрать любимую функцию из кодекса, я бы выбрал её — она реально потрясающая.

Вывод постов из таксономии

Тут нам безусловно поможет WP_Query с параметром tax_query . Подробное описание и примеры смотрите здесь.

3. Плагины для работы с таксономиями

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

• Simple Taxonomies by Yoast,
• Pods,
• Types.

Некоторые из функций для работы с таксономиями

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Если вам нужна помощь с сайтом или разработка с нуля на WordPress / WooCommerce — пишите. Я и моя команда будем рады вам помочь!

Источник

get_terms() – функция для вывода элементов таксономий

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

Короче говоря вы можете вывести в любом виде рубрики с блога, метки, а также таксономии, созданные вами . Если же надо получить текущий элемент таксономии, то воспользуйтесь функциями get_query_var() (co значением параметра равным term — так вы получите ярлык текущего элемента таксономии) и get_term_by() (со значением первого параметра равным slug ).

Пример. Выводим отсортированные по имени рубрики в виде выпадающего списка

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

Вот что у меня получилось в результате выполнения этого кода на тестовом сайте:

Слева — сам список (открытый), а справа его HTML-код.

Синтаксис

$args
(строка|массив) параметры по типу, как в WP_Query, их тоже можно записать и в виде массива и в виде строки.

Параметры массива $args

taxonomy
(строка|массив) название таксономии или массив таксономий, например array( ‘category’, ‘post_tag’ ) .

number
(целое число) количество элементов, которые нужно вывести, по умолчанию выводятся все.

offset
(целое число) сколько элементов нужно пропустить, то есть если offset=2 , то начинаем с третьего.

include
(целое число|строка|массив) укажите ID элементов, которые нужно вывести, можно указать число, числа через запятую в виде строки или одномерный массив чисел, например так:

Если вы хотите исключить какие-то элементы, не пытайтесь использовать минус перед числом, просто смотрите следующий параметр.

exclude
(целое число|строка|массив) укажите ID элементов, которые нужно исключить.

exclude_tree
(целое число|строка|массив) если вы исключате родительские элементы и хотите сразу же исключить все дочерние, то этот параметр для вас.

orderby
(строка) сортировать по:

• id — по ID элементов (по умолчанию),
• count — по количеству постов,
• name — по имени,
• slug — по ярлыку,
• term_group — по значениям колонки term_group в таблице wp_terms базы данных,
• include — в том же порядке, в котором указаны элементы в параметре include,
• meta_value и meta_value_num – по значению произвольного поля,
• none — без сортировки;

order
(строка) порядок сортировки.

• ASC — по возрастанию (по умолчанию),
• DESC — по убыванию;

hide_empty
(логическое) нужно ли добавлять в результат также и пустые (без постов) рубрики/метки/элементы таксономий:

• true — не нужно (по умолчанию),
• false — нужно;

fields
(строка) в каком виде выводить результат:

all — массив объектов элементов таксономий (по умолчанию), после print_r() он будет выглядеть так:

slug
(строка) возвращает элементы, ярлыки которых совпадают с заданным значением.

hierarchical
(логическое) нужно ли включить в результат родительские элементы, даже если в них нет постов?

• 1 — нужно (по умолчанию),
• 0 — не нужно;

name__like
(строка) возвращает только те элементы, названия которых начинаются с заданного значения (без чувствительности в регистру), например:

search
(строка) возвращает только те элементы, названия которых содержат заданное значение (без чувствительности в регистру).

pad_counts
(логическое) влияет только на числовые значения количества постов в родительских элементах.

• 1 — количество постов родительского элемента суммируется с количеством постов дочерних элементов,
• 0 — не суммируется (по умолчанию);

get
(строка)

• all — вывести все элементы, вне зависимости от параметров offset , hide_empty , child_of (по умолчанию — пустая строка)

child_of
(целое число) вывести все элементы таксономии, которые являются дочерними для элемента с указанным ID вне зависимости от уровня вложенности.

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

meta_key
(строка) Укажите это значение ключа мета поля, если хотите получить только элементы таксономи, содержащие его.

meta_value
(строка) Значение мета поля элементов таксономии для указанного ключа meta_key .

meta_query
(массив) Работает так же, как и meta_query в WP_Query при выводе постов. О нём даже есть отдельный урок.

cache_domain
(строка) (с версии 3.2) если вы планируете использовать get_terms с указанными параметрами несколько раз, укажите в качестве значения cache_domain уникальную фразу, чтобы задействовать кэш (по умолчанию — «core»).

Возвращаемые значения

Если параметр fields не изменен, то функция возвращает массив объектов, каждый из которых содержит следующую информацию об элементе таксономии.

• term_id — ID рубрики/метки/элемента таксономии
• name — название
• slug — ярлык
• term_group — значение term_group из базы данных (особого применения пока что нет, в основном — в плагинах)
• term_taxonomy_id — ID таксономии
• taxonomy — название таксономии
• description — описание элемента (можно заполнить в админке при создании и редактировании)
• parent — ID родительского элемента
• count — количество записей

Выводим список из 5-и рубрик, отсортированных по количеству записей

В этом примере параметры функции задаются в виде массива:

Тот же самый пример, но только с заданными в виде строки параметрами:

Источник

get_the_taxonomies() WP 2.5.0

Получает все элементы всех таксономий связанных с записью. Получает массив HTML ссылок.

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

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

Работает с постами, новыми типами записей и с произвольными таксономиями — полный комплект.

Используйте обертку этой функции — the_taxonomies(), чтобы получить результат готовую строку для вывода на экран, а не массив.

Возвращает

Массив . Список таксономий, где ключ массива — это ярлык таксономии, а значение — это список элементов таксономии.

Использование

Параметры по которым нужно выводить (форматировать вывод) список таксономий. Может быть:

template(строка)
Шаблон вывода списка. Где %s — название таксономии, а %l — список элементов в формате указанном в параметре $term_template .
По умолчанию: ‘%s: %l.’

term_template(строка)
Формат вывода каждого элемента таксономии в списке. По умолчанию название термина, как ссылка на архив записей термина.
По умолчанию: ‘%2$s’ ,

По умолчанию: array()

Примеры

#1 Демонстрация работы для обычного поста

#2 Демонстрация работы для типа записи с таксономиями

#3 Изменим формат вывода

Чтобы изменить формат вывода, нужно указать параметры:

Источник

get_the_terms() WP 2.5.0

Получает элементы таксономии (термины), которые относятся к указанному посту (записи).

Эта функция может быть использована внутри Цикла WordPress. Или ей нужно передать ID поста, элементы таксономии которого нужно получить.

Функция полностью идентична wp_get_object_terms( $id, $taxonomy ). Разница в том, что эта функция работает с кэшем и тут есть фильтр get_the_terms.

Хуки из функции

Возвращает

• Массив WP_Terms объектов (терминов).
• false, если элементы не найдены или указанной записи не существует.
• WP_Error в остальных случаях.

Использование

Примеры

#1. Выведем ссылки на элементы таксономии ‘my_tax’, относящиеся к посту 10

Тоже самое можно сделать внутри Цикла WordPress:

Для каждого поста будут выведены связанные термины (как метки). Для этого укажем ID поста динамически ( $post->ID ):

#2. Получим только первый термин

Допустим, мы получили термины записи и нам нужно взять данные только одного термина (элемента таксономии). Но функция возвращает массив объектов (терминов). Пример ниже показывает как вытащить первый термин из массива.

#3. Получает термин верхнего уровня, для указанного или текущего поста в цикле

Это отдельная функция на базе get_the_terms()

Список изменений

Код get_the_terms() get the terms WP 5.8.1

Cвязанные функции

term (термины таксономий)

Для записей

Подскажите, пожалуйста, а из массива $cur_terms можно как-то вытащить данные без цикла foreach?

В примерах в посте сначала перебирается $cur_terms как $cur_term , а потом вытаскивается $cur_term->name . Конструкция $cur_terms[0]->name не работает.

Конструкция $cur_terms[0]->name не работает.

У вас на сервере старая версия PHP, вообще такая конструкция работает.

Можно еще так вытаскивать первый элемент массива, если индекс не известен:

Спасибо, за ответ. Вообще у меня 5.4, то есть не старая. Или 5.5 для этого надо?

Спасибо Kama! А можно каким-то образом исключить из цикла foreach термины верхнего уровня используя ID. У меня в таксономии иерархическая структура терминов.

P.S. Такую возможность имеет функция get_terms(): $args = array( ‘exclude’ => array (28, 29, 30, 31) ); , но она просто получает термины указанной таксономии. Мне же нужно получить термины, которые относятся к указанному посту и при этом исключить вывод терминов верхнего уровня.

Буду признателен за любую наводящую информацию.

Источник