Разработка кастомных таксономий WordPress
Проблема: на сайте портфолио 300 проектов, каждый с разными технологиями и типами. Встроенные рубрики и метки не покрывают иерархию «Направление → Подкатегория → Тег». Без кастомных таксономий пришлось бы писать сотни дополнительных условий в WP_Query. По нашим оценкам, неправильная структура таксономий приводит к лишним 15-20 часам доработок в месяц. Настройка с нуля занимает 1-2 дня, а окупается за пару недель за счет ускорения фильтрации. Мы внедрили такие таксономии в 50+ проектах: от каталогов недвижимости (тип объекта, район, этаж) до корпоративных порталов с вакансиями (отдел, грейд, навык). Правильная таксономия ускоряет фильтрацию в 2-3 раза по сравнению с группировкой через мета-поля. Стоимость разработки одной таксономии с мета-полями — от 15 000 ₽, а экономия на лишних запросах может достигать 30 000 ₽ в месяц при нагрузке 100 000 просмотров. Оценим вашу задачу — свяжитесь для консультации.
Какие таксономии нужны вашему проекту?
Таксономия в WordPress — система классификации записей. Встроенные — «Рубрики» (иерархические) и «Метки» (плоские). Кастомная таксономия создаётся для любой другой группировки: технологии проектов, специализации вакансий, типы недвижимости, жанры фильмов. Правильно настроенная таксономия даёт ЧПУ-ссылки для каждой категории, фильтрацию в /wp-admin и параметры для WP_Query.
| Тип | Иерархичность | Примеры использования | Производительность (TTFB) |
|---|---|---|---|
| Иерархическая | Да | Категории товаров, рубрики блога, типы недвижимости | 0.8 с против 2.1 с у мета-полей |
| Плоская | Нет | Технологический стек, теги, жанры | 0.6 с при 1000 терминов |
Например, для каталога из 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% при увеличении числа запросов.
Пошаговая инструкция создания кастомной таксономии
- Определите структуру контента и сценарии фильтрации. Зафиксируйте, сколько терминов и уровней вложенности потребуется.
- Зарегистрируйте таксономию через
register_taxonomyв хукеinit. Укажите иерархичность, ЧПУ-маску иshow_in_rest => true. - Добавьте мета-поля к терминам через хуки
{taxonomy}_add_form_fieldsи{taxonomy}_edit_form_fields. Реализуйте сохранение черезcreated_{taxonomy}иedited_{taxonomy}. - Настройте шаблоны архива:
taxonomy-{taxonomy}.phpили в FSE —templates/taxonomy-{taxonomy}.html. Вставьте кастомные фильтры. - Оптимизируйте запросы: используйте индексы, кешируйте результаты, применяйте
fields => ids. При необходимости — выносите фильтрацию во внешний поиск.
Шаблон архива таксономии
WordPress находит шаблон архива по иерархии: taxonomy-{tax}-{term}.php → taxonomy-{tax}.php → taxonomy.php → archive.php. В FSE теме — аналогично через templates/taxonomy-project_category.html.
Что входит в работу
| Этап | Что делаем | Результат |
|---|---|---|
| Анализ | Изучаем структуру контента, типы записей, сценарии фильтрации | Схема таксономий и связей |
| Регистрация | Создаём таксономии, ЧПУ, привязку к CPT | Регистрационный код |
| Мета-поля | Добавляем поля для терминов (цвет, иконка, описание) | Hooks и формы |
| Шаблоны | Верстаем архивы таксономий и фильтры | Готовые страницы |
| Оптимизация | Настраиваем кеширование, индексы, проверяем EXPLAIN | Метрики скорости |
5 лет опыта, более 50 проектов с кастомными таксономиями — получите консультацию по вашей задаче. Мы подберём оптимальную структуру и реализуем её с учётом производительности.