Разработка кастомных таксономий WordPress

Разработка кастомных таксономий WordPress

Таксономия в WordPress — система классификации записей. Встроенные — «Рубрики» (иерархические) и «Метки» (плоские). Кастомная таксономия создаётся для любой другой группировки: технологии проектов, специализации вакансий, типы недвижимости, жанры фильмов. Правильно настроенная таксономия даёт ЧПУ-ссылки для каждой категории, фильтрацию в /wp-admin и параметры для WP_Query. Регистрация занимает несколько часов; полная настройка с мета-полями таксономии и кастомными страницами архива — 1 день.

Регистрация через register_taxonomy

add_action('init', function () {
    // Иерархическая таксономия (как рубрики)
    register_taxonomy('project_category', ['project'], [
        'labels' => [
            'name'              => 'Категории проектов',
            'singular_name'     => 'Категория',
            'search_items'      => 'Поиск категорий',
            'all_items'         => 'Все категории',
            'parent_item'       => 'Родительская категория',
            'parent_item_colon' => 'Родительская категория:',
            'edit_item'         => 'Редактировать',
            'update_item'       => 'Обновить',
            'add_new_item'      => 'Добавить категорию',
            'new_item_name'     => 'Новая категория',
            'menu_name'         => 'Категории',
        ],
        'hierarchical'          => true,
        'show_ui'               => true,
        'show_admin_column'     => true,
        'query_var'             => true,
        'rewrite'               => ['slug' => 'project-category', 'hierarchical' => true],
        'show_in_rest'          => true,
        'rest_base'             => 'project-categories',
    ]);

    // Плоская таксономия (как метки) — технологический стек
    register_taxonomy('tech_stack', ['project', 'case'], [
        'labels' => [
            'name'          => 'Технологии',
            'singular_name' => 'Технология',
            'add_new_item'  => 'Добавить технологию',
            'search_items'  => 'Поиск технологий',
            'all_items'     => 'Все технологии',
        ],
        'hierarchical'      => false,
        'show_ui'           => true,
        'show_admin_column' => true,
        'query_var'         => true,
        'rewrite'           => ['slug' => 'tech'],
        'show_in_rest'      => true,
    ]);
});

show_in_rest => true необходимо для работы таксономии в редакторе Gutenberg. show_admin_column => true добавляет колонку с терминами в список записей.

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

// Проекты категории "web" с тегом "react"
$projects = new WP_Query([
    'post_type'      => 'project',
    'posts_per_page' => 12,
    'tax_query'      => [
        'relation' => 'AND',
        [
            'taxonomy' => 'project_category',
            'field'    => 'slug',
            'terms'    => 'web',
        ],
        [
            'taxonomy' => 'tech_stack',
            'field'    => 'slug',
            'terms'    => ['react', 'next-js'],
            'operator' => 'IN',
        ],
    ],
    'orderby'        => 'date',
    'order'          => 'DESC',
]);

Мета-поля для терминов таксономии

Начиная с WordPress 4.4 у терминов таксономии есть мета-поля через add_term_meta/get_term_meta. Пример: добавляем иконку и цвет к категории проекта:

// Поля на странице добавления термина
add_action('project_category_add_form_fields', function (string $taxonomy): void {
    ?>
    <div class="form-field">
        <label for="term-color">Цвет категории</label>
        <input type="color" id="term-color" name="term_color" value="#1a1a2e">
        <p>Цвет для отображения в списке и на карточках проектов</p>
    </div>
    <div class="form-field">
        <label for="term-icon">Иконка (SVG-код или dashicons-класс)</label>
        <input type="text" id="term-icon" name="term_icon" value="">
    </div>
    <?php
});

// Поля на странице редактирования термина
add_action('project_category_edit_form_fields', function (WP_Term $term): void {
    $color = get_term_meta($term->term_id, 'color', true) ?: '#1a1a2e';
    $icon  = get_term_meta($term->term_id, 'icon', true);
    ?>
    <tr class="form-field">
        <th><label for="term-color">Цвет</label></th>
        <td><input type="color" id="term-color" name="term_color" value="<?= esc_attr($color) ?>"></td>
    </tr>
    <tr class="form-field">
        <th><label for="term-icon">Иконка</label></th>
        <td><input type="text" id="term-icon" name="term_icon" value="<?= esc_attr($icon) ?>"></td>
    </tr>
    <?php
});

// Сохранение
add_action('created_project_category', 'save_project_category_meta');
add_action('edited_project_category', 'save_project_category_meta');

function save_project_category_meta(int $term_id): void {
    if (isset($_POST['term_color'])) {
        update_term_meta($term_id, 'color', sanitize_hex_color($_POST['term_color']));
    }
    if (isset($_POST['term_icon'])) {
        update_term_meta($term_id, 'icon', sanitize_text_field($_POST['term_icon']));
    }
}

Использование на фронтенде:

$terms = get_the_terms(get_the_ID(), 'project_category');
foreach ($terms as $term) {
    $color = get_term_meta($term->term_id, 'color', true) ?: '#ccc';
    $icon  = get_term_meta($term->term_id, 'icon', true);
    printf(
        '<a href="%s" class="tag" style="--tag-color:%s">%s%s</a>',
        esc_url(get_term_link($term)),
        esc_attr($color),
        $icon ? '<span class="tag__icon">' . esc_html($icon) . '</span>' : '',
        esc_html($term->name)
    );
}

Кастомный порядок терминов

По умолчанию термины выводятся в алфавитном порядке. Для ручного порядка используем term_order через плагин или мета-поле:

add_action('edited_project_category', function (int $term_id): void {
    if (isset($_POST['term_order'])) {
        update_term_meta($term_id, 'order', absint($_POST['term_order']));
    }
});

// Сортировка при выводе
$terms = get_terms([
    'taxonomy'   => 'project_category',
    'hide_empty' => false,
    'meta_key'   => 'order',
    'orderby'    => 'meta_value_num',
    'order'      => 'ASC',
]);

Таксономия на нескольких CPT

Одна таксономия может обслуживать несколько типов записей — «техстек» сразу для проектов и кейсов. После регистрации можно добавить тип к существующей таксономии:

register_taxonomy_for_object_type('tech_stack', 'case');

Шаблон архива таксономии

WordPress находит шаблон архива по иерархии: taxonomy-{tax}-{term}.php → taxonomy-{tax}.php → taxonomy.php → archive.php. В FSE теме — аналогично через templates/taxonomy-project_category.html.

Производительность

Запросы по таксономиям с большим количеством терминов и записей могут быть медленными. Несколько правил:

• Всегда используйте 'fields' => 'ids' в get_terms(), если нужны только ID
• При tax_query с несколькими таксономиями — проверьте план запроса через EXPLAIN
• Для публичных фильтров с большими архивами — выносить в Elasticsearch или кешировать результаты через Redis