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

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

Проблема: на сайте портфолио 300 проектов, каждый с разными технологиями и типами. Встроенные рубрики и метки не покрывают иерархию «Направление → Подкатегория → Тег». Без кастомных таксономий пришлось бы писать сотни дополнительных условий в WP_Query. По нашим оценкам, неправильная структура таксономий приводит к лишним 15-20 часам доработок в месяц. Настройка с нуля занимает 1-2 дня, а окупается за пару недель за счет ускорения фильтрации. Мы внедрили такие таксономии в 50+ проектах: от каталогов недвижимости (тип объекта, район, этаж) до корпоративных порталов с вакансиями (отдел, грейд, навык). Правильная таксономия ускоряет фильтрацию в 2-3 раза по сравнению с группировкой через мета-поля. Стоимость разработки одной таксономии с мета-полями — от 15 000 ₽, а экономия на лишних запросах может достигать 30 000 ₽ в месяц при нагрузке 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. Пример: добавляем иконку и цвет к категории проекта. Добавление мета-полей к таксономии — от 10 000 ₽ за 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 проектов с кастомными таксономиями — получите консультацию по вашей задаче. Мы подберём оптимальную структуру и реализуем её с учётом производительности.