Разработка кастомных таксономий WordPress: от регистрации до оптимизации

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

Проблема: на сайте портфолио 300 проектов, каждый с разными технологиями и типами. Встроенные рубрики и метки не покрывают иерархию «Направление → Подкатегория → Тег». Без кастомных таксономий пришлось бы писать сотни дополнительных условий в WP_Query. По нашим оценкам, неправильная структура таксономий приводит к лишним 15-20 часам доработок в месяц. Настройка с нуля занимает 1-2 дня, а окупается за пару недель за счет ускорения фильтрации. Мы внедрили такие таксономии в 50+ проектах: от каталогов недвижимости (тип объекта, район, этаж) до корпоративных порталов с вакансиями (отдел, грейд, навык). Правильная таксономия ускоряет фильтрацию в 2-3 раза по сравнению с группировкой через мета-поля. Стоимость разработки одной таксономии с мета-полями — от $140–200, а экономия на лишних запросах может достигать $270–390 в месяц при нагрузке 100 000 просмотров. Оценим вашу задачу — свяжитесь для консультации.

Какие таксономии нужны вашему проекту?

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

Например, для каталога из 10 000 товаров с 5 уровнями иерархии таксономия работает в 2.5 раза быстрее, чем вложенные мета-поля (TTFB снижается с 2.1 с до 0.8 с). Регистрация через register_taxonomy занимает несколько часов; полная настройка с мета-полями и кастомными страницами архива — 1 день.

Как регистрировать кастомную таксономию?

Регистрация выполняется в хуке init через функцию register_taxonomy(). Официальная документация WordPress рекомендует указывать все метки интерфейса, чтобы таксономия выглядела естественно в админ-панели. Для корректной работы с Gutenberg обязательно show_in_rest => true. Вот пример регистрации иерархической и плоской таксономии в одном сниппете:

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. Пример: добавляем иконку и цвет к категории проекта. Добавление мета-полей к таксономии — от $90–130 за 5 полей, включая интерфейс в админке и вывод на фронтенде.

// Поля на странице добавления термина
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)
    );
}

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

По умолчанию термины выводятся в алфавитном порядке. Для ручного порядка используем мета-поле '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',
]);

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

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

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

Сравнение производительности: кастомная таксономия с WP_Query работает в 2–3 раза быстрее, чем аналогичная фильтрация через мета-поля, благодаря встроенным индексам базы данных. Использование индексов и кеширования снижает стоимость хостинга на 30-40% при увеличении числа запросов.

Пошаговая инструкция создания кастомной таксономии

1. Определите структуру контента и сценарии фильтрации. Зафиксируйте, сколько терминов и уровней вложенности потребуется.
2. Зарегистрируйте таксономию через register_taxonomy в хуке init. Укажите иерархичность, ЧПУ-маску и show_in_rest => true.
3. Добавьте мета-поля к терминам через хуки {taxonomy}_add_form_fields и {taxonomy}_edit_form_fields. Реализуйте сохранение через created_{taxonomy} и edited_{taxonomy}.
4. Настройте шаблоны архива: taxonomy-{taxonomy}.php или в FSE — templates/taxonomy-{taxonomy}.html. Вставьте кастомные фильтры.
5. Оптимизируйте запросы: используйте индексы, кешируйте результаты, применяйте fields => ids. При необходимости — выносите фильтрацию во внешний поиск.

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

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

Что входит в работу

5 лет опыта, более 50 проектов с кастомными таксономиями — получите консультацию по вашей задаче. Мы подберём оптимальную структуру и реализуем её с учётом производительности.