Рубрик и тегов хватает для обычного блога, но для каталога, портфолио или справочника часто нужны другие способы группировки. Например, проекты можно распределять по типам, книги — по жанрам, а объекты каталога — по районам. Для этого в WordPress создают собственную таксономию: она хранит термины и связывает их с записями или пользовательским типом записей.
Таксономию регистрируют кодом, обычно в небольшом собственном плагине. Ниже — пример таксономии «Тип проекта», связанной с типом записей portfolio. Если такого типа на сайте нет, замените его на существующий, например post, либо сначала зарегистрируйте тип записей портфолио.
Что подготовить перед регистрацией
У таксономии есть внутренний ключ, название для интерфейса и набор терминов, которые редактор будет назначать материалам. Ключ — не подпись, которую видит посетитель, а идентификатор для кода. В примере это project_type. Используйте уникальное имя из латинских букв, цифр и подчёркиваний; ключ таксономии не должен превышать 32 символа.
Также решите, нужна ли иерархия. Иерархическая таксономия работает по принципу рубрик: у термина могут быть дочерние термины. Неиерархическая похожа на теги. Для типов проектов обычно достаточно плоского списка, поэтому в примере используется hierarchical => false. Если нужны уровни вроде «Жилые объекты → Квартиры», установите значение true.
Код лучше разместить в собственном плагине или в плагине функциональности сайта. Если добавить его в functions.php темы, таксономия перестанет регистрироваться при смене темы, а назначенные термины останутся в базе данных.
Регистрируем таксономию
Создайте файл плагина, например site-structure.php в отдельной папке внутри wp-content/plugins. Вставьте в него код ниже, изменив подписи и, если необходимо, ключ типа записей. Тип записей portfolio должен уже регистрироваться на сайте.
<?php
/**
* Plugin Name: Site Structure
* Description: Таксономия типов проектов.
*/
function wpexamples_register_project_type_taxonomy() {
$labels = array(
'name' => 'Типы проектов',
'singular_name' => 'Тип проекта',
'search_items' => 'Искать типы проектов',
'all_items' => 'Все типы проектов',
'edit_item' => 'Изменить тип проекта',
'update_item' => 'Обновить тип проекта',
'add_new_item' => 'Добавить тип проекта',
'new_item_name' => 'Название типа проекта',
'menu_name' => 'Типы проектов',
);
register_taxonomy(
'project_type',
array( 'portfolio' ),
array(
'labels' => $labels,
'public' => true,
'hierarchical' => false,
'show_admin_column' => true,
'show_in_rest' => true,
'rewrite' => array( 'slug' => 'project-type' ),
)
);
}
add_action( 'init', 'wpexamples_register_project_type_taxonomy', 20 );Функция запускается на хуке init — в этот момент WordPress регистрирует типы записей и таксономии. Приоритет 20 помогает выполнить регистрацию после обычной регистрации типа записей на стандартном приоритете 10. Если ваш тип записей регистрируется позже, измените приоритет так, чтобы таксономия подключалась после него.
Параметр show_in_rest включает поддержку REST API и позволяет использовать таксономию в редакторе блоков. show_admin_column добавляет колонку с типом проекта в список записей в админке. Параметр rewrite задаёт часть адреса архива: при указанном значении URL термина будет выглядеть примерно как example.ru/project-type/residential/. Фактический адрес зависит от настроек постоянных ссылок и конфигурации сайта.
Чтобы подключить таксономию к нескольким типам записей, перечислите их ключи в массиве, например array( 'portfolio', 'post' ). Это не создаёт новые типы записей — только делает термины доступными для уже зарегистрированных типов.
Включаем плагин и добавляем термины
Загрузите файл плагина в папку сайта, затем откройте в админке раздел «Плагины» и активируйте Site Structure. В меню типа записей портфолио появится пункт «Типы проектов». Если он не появился, проверьте, что ключ portfolio совпадает с фактическим ключом типа записей и что плагин активен.
Добавьте несколько терминов, например «Жилые объекты» и «Коммерческие объекты». После этого при создании или редактировании проекта можно будет назначить ему один или несколько типов. Если таксономия иерархическая, интерфейс будет выглядеть как список с выбором родительского термина; у неиерархической обычно используется поле ввода и список существующих терминов.
Обновляем постоянные ссылки и проверяем архив
После добавления или изменения параметра rewrite WordPress нужно обновить правила постоянных ссылок. В админке откройте «Настройки → Постоянные ссылки» и нажмите «Сохранить изменения», не меняя остальные настройки. Это обновит правила маршрутизации. Не вызывайте flush_rewrite_rules() при каждой загрузке страницы: операция ресурсоёмкая; её используют при активации или деактивации плагина, а для обычной проверки достаточно сохранить настройки постоянных ссылок.
Откройте созданный термин в админке и перейдите по ссылке просмотра, если она доступна. Архив должен показывать записи, которым назначен этот термин. WordPress выбирает шаблон для архива таксономии по иерархии шаблонов: сначала ищет файл вида taxonomy-project_type.php в активной теме, затем использует более общие шаблоны архива. Если специального шаблона нет, сайт всё равно может вывести архив через общий шаблон темы.
Если архив возвращает ошибку 404, сначала сохраните настройки постоянных ссылок ещё раз. Затем проверьте, что у термина есть назначенные записи, а тип записей публичный и зарегистрирован с поддержкой архивов, если для него требуется отдельная страница архива. На некоторых хостингах или при нестандартной настройке веб-сервера правила постоянных ссылок могут работать иначе; в таком случае проверьте конфигурацию ЧПУ для используемого сервера.
Выводим термины рядом с записью
Наличие таксономии в админке не означает, что она автоматически появится в карточке проекта. Добавьте вывод в шаблон темы в том месте, где нужно показать назначенные типы. Например, этот фрагмент выводит названия терминов со ссылками на их архивы:
<?php
$project_types = get_the_term_list(
get_the_ID(),
'project_type',
'',
', '
);
if ( $project_types && ! is_wp_error( $project_types ) ) {
echo '<div class="project-types">' . $project_types . '</div>';
}
?>get_the_term_list() возвращает список терминов для текущей записи, а каждый термин ведёт на свой архив. Фрагмент рассчитан на шаблон внутри цикла WordPress; если вызвать его вне цикла, передайте вместо get_the_ID() ID нужной записи.
Если нужно получить записи по термину
Архив таксономии WordPress формирует автоматически. Если же нужно вывести отдельный список, например на странице каталога, используйте WP_Query с параметром tax_query. В запросе ниже выбираются проекты с термином residential:
<?php
$projects = new WP_Query(
array(
'post_type' => 'portfolio',
'tax_query' => array(
array(
'taxonomy' => 'project_type',
'field' => 'slug',
'terms' => 'residential',
),
),
)
);
if ( $projects->have_posts() ) {
while ( $projects->have_posts() ) {
$projects->the_post();
the_title( '<h2>', '</h2>' );
}
wp_reset_postdata();
}
?>Замените residential на фактический slug термина. После цикла вызывается wp_reset_postdata(), чтобы восстановить глобальные данные текущей записи для остального шаблона. Для подбора терминов по их названию или ID измените значение параметра field и передайте соответствующее значение в terms.
Что учитывать при изменении структуры
Переименование видимых подписей не меняет внутренний ключ таксономии. А вот изменение ключа или rewrite-slug влияет на код и адреса архивов. Перед таким изменением проверьте шаблоны, запросы, ссылки в меню и внешние ссылки на архивы; после правки обновите постоянные ссылки. Если важно сохранить прежние URL, заранее настройте перенаправления.
Термины хранятся отдельно от записей, поэтому деактивация плагина с регистрацией таксономии обычно не удаляет данные, но убирает таксономию из интерфейса и с сайта до повторной регистрации. Не удаляйте плагин и не меняйте код без резервной копии, если структура уже используется редакторами. Для устойчивой схемы сайта держите регистрацию таксономии в собственном плагине и выбирайте её тип, иерархию и URL до массового добавления материалов.