wpsocial.ru wordpress WPSocial

Как добавить собственную таксономию в WordPress

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

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

Что такое собственная таксономия и когда она нужна

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

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

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

Например, для портфолио можно сделать таксономию «Тип работ», для каталога статей — «Тематика», для новостного раздела — «Регион». Это лучше, чем пытаться запихнуть всё в рубрики и метки, где структура быстро становится хаотичной.

Как зарегистрировать таксономию через functions.php или плагин

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

Перед изменениями сделайте резервную копию. Ошибка в PHP-коде может временно сломать сайт или админку, особенно если редактировать основной файл темы напрямую.

Ниже пример регистрации таксономии «Тип материала» для записей и произвольного типа записей portfolio. Если у вас другой тип записей, замените его в массиве post_types.

add_action( 'init', function() {
    register_taxonomy( 'material_type', array( 'post', 'portfolio' ), array(
        'labels' => array(
            'name'              => 'Типы материалов',
            'singular_name'     => 'Тип материала',
            'search_items'      => 'Искать типы материалов',
            'all_items'         => 'Все типы материалов',
            'edit_item'         => 'Редактировать тип материала',
            'update_item'       => 'Обновить тип материала',
            'add_new_item'      => 'Добавить новый тип материала',
            'new_item_name'     => 'Название нового типа материала',
            'menu_name'         => 'Типы материалов',
        ),
        'public'            => true,
        'hierarchical'      => true,
        'show_ui'           => true,
        'show_admin_column' => true,
        'show_in_rest'      => true,
        'rewrite'           => array( 'slug' => 'material-type' ),
    ) );
} );

Здесь важны несколько параметров:

  • material_type — системный ярлык таксономии. Он должен быть уникальным и обычно пишется латиницей с подчёркиванием или без пробелов;
  • post и portfolio — типы записей, к которым таксономия будет привязана;
  • hierarchical => true делает таксономию похожей на рубрики: можно создавать родительские и дочерние термины;
  • show_in_rest => true нужен, если вы используете редактор блоков или хотите, чтобы таксономия была доступна через REST API;
  • rewrite задаёт человекочитаемый URL-слуг для архивов таксономии.

Если вам нужна поведение как у меток, а не как у рубрик, поставьте hierarchical => false. Тогда термины будут плоскими, без вложенности.

Как выбрать настройки таксономии под вашу задачу

Не все параметры нужны всегда. На практике чаще всего решают три вопроса: нужна ли вложенность, должна ли таксономия отображаться в админке и нужна ли она в редакторе блоков.

ПараметрКогда включатьЧто меняется
hierarchicalЕсли нужны родительские и дочерние терминыТаксономия работает как рубрики
show_uiЕсли вы хотите управлять терминами из админкиПоявляется интерфейс в панели WordPress
show_admin_columnЕсли удобно видеть таксономию в списке записейДобавляется колонка в таблицу записей
show_in_restЕсли используется Gutenberg или REST APIТаксономия доступна современным интерфейсам WordPress

Если сайт старый и работает на классическом редакторе, show_in_rest не обязателен, но отключать его без причины обычно не стоит. Для новых проектов лучше оставлять его включённым.

Как вывести новую таксономию в теме

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

Если нужно вывести термины у конкретной записи, используйте get_the_terms(). Пример ниже безопасно проверяет, есть ли термины, и выводит ссылки на архивы таксономии:

$terms = get_the_terms( get_the_ID(), 'material_type' );

if ( ! empty( $terms ) && ! is_wp_error( $terms ) ) {
    echo '<ul class="post-material-types">';
    foreach ( $terms as $term ) {
        echo '<li><a href="' . esc_url( get_term_link( $term ) ) . '">' . esc_html( $term->name ) . '</a></li>';
    }
    echo '</ul>';
}

Если нужен архивный список всех терминов таксономии, можно использовать get_terms(). Это полезно для страниц-фильтров, навигации по разделам или отдельного блока в сайдбаре.

$terms = get_terms( array(
    'taxonomy'   => 'material_type',
    'hide_empty' => false,
) );

if ( ! empty( $terms ) && ! is_wp_error( $terms ) ) {
    echo '<ul class="material-type-list">';
    foreach ( $terms as $term ) {
        echo '<li><a href="' . esc_url( get_term_link( $term ) ) . '">' . esc_html( $term->name ) . '</a></li>';
    }
    echo '</ul>';
}

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

Что проверить после добавления таксономии

После сохранения кода не ограничивайтесь тем, что пункт появился в админке. Проверьте несколько вещей подряд:

  • таксономия отображается в меню нужного типа записей;
  • термины можно создать и привязать к записи;
  • в списке записей появилась колонка, если вы включили show_admin_column;
  • архив термина открывается по ссылке без ошибки 404;
  • на фронтенде выводятся нужные термины, если вы добавили шаблонный код.

Если архив таксономии даёт 404 после регистрации или изменения rewrite, обычно помогает сброс правил постоянных ссылок. Для этого достаточно зайти в Настройки → Постоянные ссылки и просто нажать кнопку сохранения без изменения параметров. Это безопаснее, чем вручную править конфигурацию.

Частые ошибки при создании таксономии

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

Ещё одна типичная проблема — конфликт ярлыка. Если material_type уже используется другой таксономией, плагином или кодом темы, WordPress может вести себя непредсказуемо. Ярлык должен быть уникальным.

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

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

Когда лучше сделать таксономию, а когда хватит рубрик или меток

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

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

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

×

AI-плагин

WPGPT
Сам создает статьи для вашего сайта WordPress

SEO и мета-теги

Парсинг конкурентов

Изображения

Комментарии

Подробнее