Как удалить пустые варианты атрибутов в WooCommerce с помощью кода

Диагностика проблемы с пустыми вариантами атрибутов в WooCommerce

Пустые варианты атрибутов в WooCommerce возникают, когда в каталоге товаров остаются опции, не связанные ни с одним товаром. Это приводит к ошибкам в фильтрах, некорректному отображению на страницах и снижению удобства для пользователей.

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

Как проверить пустые варианты атрибутов вручную

• Перейдите в админку WordPress → Товары → Атрибуты.
• Выберите нужный атрибут и откройте список терминов (вариантов).
• Обратите внимание на количество товаров, связанных с каждым вариантом. Если значение равно 0, вариант пустой.

Диагностика через базу данных

Можно выполнить SQL-запрос, который покажет варианты атрибутов без товаров:

SELECT t.term_id, t.name, tr.object_id FROM wp_terms t
LEFT JOIN wp_term_relationships tr ON t.term_id = tr.term_taxonomy_id
WHERE tr.object_id IS NULL
AND t.term_id IN (SELECT term_id FROM wp_term_taxonomy WHERE taxonomy LIKE 'pa_%');

Этот запрос покажет термины атрибутов, не связанных с товарами.

Пошаговое решение: удаление пустых вариантов атрибутов через PHP-код

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

function wp24_delete_empty_product_attributes() {
    $attribute_taxonomies = wc_get_attribute_taxonomies();
    foreach ( $attribute_taxonomies as $attribute ) {
        $taxonomy = wc_attribute_taxonomy_name( $attribute->attribute_name );
        $terms = get_terms( array(
            'taxonomy' => $taxonomy,
            'hide_empty' => false,
        ) );
        foreach ( $terms as $term ) {
            if ( ! $term->count ) {
                wp_delete_term( $term->term_id, $taxonomy );
            }
        }
    }
}
add_action( 'init', 'wp24_delete_empty_product_attributes' );

Как использовать: добавьте этот код в файл functions.php вашей активной темы или в отдельный плагин для кастомного кода. Код запускается на каждом инициализирующем запросе, но можно ограничить запуск, чтобы не нагружать сайт.

Оптимизация вызова для однократного запуска

Чтобы удалить пустые варианты однократно, можно добавить проверку флага в базе данных:

function wp24_delete_empty_product_attributes_once() {
    if ( get_option( 'wp24_attributes_cleaned' ) ) {
        return;
    }
    $attribute_taxonomies = wc_get_attribute_taxonomies();
    foreach ( $attribute_taxonomies as $attribute ) {
        $taxonomy = wc_attribute_taxonomy_name( $attribute->attribute_name );
        $terms = get_terms( array(
            'taxonomy' => $taxonomy,
            'hide_empty' => false,
        ) );
        foreach ( $terms as $term ) {
            if ( ! $term->count ) {
                wp_delete_term( $term->term_id, $taxonomy );
            }
        }
    }
    update_option( 'wp24_attributes_cleaned', 1 );
}
add_action( 'init', 'wp24_delete_empty_product_attributes_once' );

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

• Перейдите в WooCommerce → Атрибуты и откройте список вариантов. Пустых вариантов с 0 товаров быть не должно.
• Обновите страницу с фильтрами товаров — пустые варианты больше не должны отображаться.
• Проверьте, что на страницах товаров и в виджетах фильтрации отсутствуют пустые опции.

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

• Код не срабатывает: Убедитесь, что WooCommerce активен и функция wc_get_attribute_taxonomies() доступна.
• Удаляются нужные варианты: Проверьте, что условие ! $term->count корректно — оно удаляет только варианты без товаров. Если вариантов с нулевым счетчиком нет, удалять нечего.
• Проблемы с правами: Для удаления терминов требуется, чтобы пользователь имел соответствующие права. Код запускается в контексте сайта, поэтому обычно проблем не возникает.
• Пустые варианты появляются вновь: Возможно, при импорте или редактировании товаров создаются новые пустые варианты. Рекомендуется запускать код периодически или автоматизировать очистку.

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

• Запускать код удаления лучше вручную или по Cron, а не на каждом запросе. Для этого можно использовать WP-Cron или вызвать функцию вручную через админку.
• Перед удалением сделайте резервную копию базы данных, чтобы избежать потери данных.
• Если атрибутов много, разбейте удаление на части, чтобы не нагружать сервер.
• Для регулярной очистки пустых вариантов можно использовать WP-CLI и написать соответствующую команду.

Сравнение способов удаления пустых вариантов атрибутов