Кастомні таксономії WordPress: реєстрація та мета-поля

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)
    );
}

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

За замовчуванням терміни виводяться в алфавітному порядку. Для ручного порядку використовуємо мета-поле '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

За нашими тестами, таксономії працюють у 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 проєктів з кастомними таксономіями — отримайте консультацію з вашого завдання. Ми підберемо оптимальну структуру та реалізуємо її з урахуванням продуктивності.