WooCommerce: правильная настройка иерархии атрибутов и фильтров для товаров

Почему важна иерархия атрибутов в WooCommerce

Иерархия атрибутов позволяет структурировать товары по уровням, облегчая покупателям навигацию и поиск нужного варианта. Например, для одежды это может быть: Категория > Цвет > Размер. Неправильно настроенная иерархия ведёт к дублированию фильтров, запутанности и снижению конверсии.

Диагностика проблем с иерархией атрибутов и фильтров

• Фильтры не отображают дочерние атрибуты или показывают все на одном уровне
• При выборе родительского атрибута не фильтруются товары с дочерними значениями
• Фильтры WooCommerce работают медленно или приводят к ошибкам базы данных
• Некорректное присвоение атрибутов товарам, мешающее логике иерархии

Для проверки используйте консоль разработчика браузера (F12) и запросы к базе через phpMyAdmin или WP-CLI.

Как правильно создать иерархию атрибутов в WooCommerce

1. Создание родительских и дочерних значений атрибутов

WooCommerce по умолчанию не поддерживает иерархию внутри атрибутов, но можно использовать таксономии для атрибутов с иерархией.

Пример: создаём таксономию с иерархическими терминами и связываем её с товарами.

function register_hierarchical_product_attribute() {
    register_taxonomy(
        'pa_material', // slug атрибута
        'product',
        array(
            'hierarchical' => true,
            'label' => 'Материал',
            'show_ui' => true,
            'query_var' => true,
            'rewrite' => array('slug' => 'material'),
        )
    );
}
add_action('init', 'register_hierarchical_product_attribute', 10);

После регистрации добавьте термины с иерархией через админку: например, Ткань > Хлопок, Ткань > Лен.

2. Присвоение иерархических атрибутов товарам

В редакторе товара выбирайте термины иерархической таксономии. Важно не дублировать значения на разных уровнях.

Настройка фильтров для иерархических атрибутов

Использование плагина для AJAX-фильтрации с поддержкой иерархий

Для корректного отображения иерархии и динамической подгрузки рекомендуем использовать плагин Clearfy Pro или специализированные фильтры с поддержкой родительских-детских связей.

Если хотите реализовать самостоятельно, пример для вывода иерархии с AJAX:

add_action('wp_ajax_filter_products', 'ajax_filter_products');
add_action('wp_ajax_nopriv_filter_products', 'ajax_filter_products');

function ajax_filter_products() {
    $tax_query = array();
    if (!empty($_POST['material_term'])) {
        $material_term = sanitize_text_field($_POST['material_term']);
        $tax_query[] = array(
            'taxonomy' => 'pa_material',
            'field' => 'slug',
            'terms' => $material_term,
            'include_children' => true // ключевой параметр
        );
    }
    $args = array(
        'post_type' => 'product',
        'tax_query' => $tax_query,
    );
    $query = new WP_Query($args);

    if ($query->have_posts()) {
        while ($query->have_posts()) {
            $query->the_post();
            wc_get_template_part('content', 'product');
        }
    } else {
        echo '<p>Товары не найдены.</p>';
    }
    wp_die();
}

Проверка результата после внедрения

• В админке добавьте иерархические термины для атрибута и присвойте товары.
• На странице магазина проверьте, что фильтр выводит родительские термины с возможностью раскрытия дочерних.
• Выберите родительский термин — должны отфильтроваться товары с дочерними терминами.
• Проверьте работу AJAX-фильтра без перезагрузки страницы.

Частые ошибки и как их исправить

• Ошибка: Фильтр не учитывает дочерние термины.
  Причина: Параметр include_children в tax_query не установлен или равен false.
  Исправление: Убедитесь, что include_children => true в запросах WP_Query.
• Ошибка: Атрибуты не отображаются в фильтрах.
  Причина: Таксономия не зарегистрирована с параметром hierarchical => true.
  Исправление: Зарегистрируйте кастомную таксономию с иерархией, как показано выше.
• Ошибка: Медленная работа фильтров.
  Причина: Отсутствие индексов в базе или чрезмерное количество запросов.
  Исправление: Используйте кеширование и оптимизируйте запросы, например, через WP Object Cache.

Практические советы по производительности и безопасности

• Используйте серверное кеширование и плагин кеша для снижения нагрузки при фильтрации.
• При AJAX-запросах фильтрации обязательно используйте wp_nonce_field для защиты от CSRF.
• Ограничьте число одновременно отображаемых фильтров, чтобы не перегружать интерфейс.
• Регулярно очищайте базу от неиспользуемых терминов и метаданных.

Сравнение вариантов реализации иерархии фильтров