Розробка користувацьких таксономій WordPress
Таксономія в WordPress — система класифікації записів. Вбудовані — "Рубрики" (ієрархічні) та "Мітки" (плоскі). Користувацька таксономія створюється для будь-якої іншої групування: технології проектів, спеціалізації вакансій, типи нерухомості, жанри фільмів. Правильно налаштована таксономія дає URL-адреси для кожної категорії, фільтрацію в /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