WooCommerce: как удалить товары по атрибутам через код PHP

Диагностика задачи: зачем удалять товары по атрибутам

В WooCommerce иногда возникает необходимость массово удалить товары, соответствующие определённым атрибутам (например, цвет, размер, бренд). Это может понадобиться при смене ассортимента, очистке тестовых данных или исправлении ошибок импорта. Ручное удаление через админку неудобно и долго, особенно при большом количестве товаров.

Как программно найти товары по атрибутам

Атрибуты в WooCommerce — это таксономии с префиксом pa_. Например, атрибут «цвет» хранится как таксономия pa_color, а его значения — это термины в этой таксономии.

Чтобы найти ID товаров с нужным значением атрибута, выполняем WP_Query с таксономическим запросом:

$args = [
    'post_type' => 'product',
    'posts_per_page' => -1,
    'tax_query' => [
        [
            'taxonomy' => 'pa_color', // атрибут
            'field' => 'slug',
            'terms' => 'red' // значение атрибута
        ]
    ],
    'fields' => 'ids' // чтобы получить только ID
];

$query = new WP_Query($args);
$product_ids = $query->posts;

Пошаговое решение: удаление товаров по атрибутам

1. Определяем атрибут и его значение (например, pa_color = red).

2. Получаем ID товаров с этим атрибутом через WP_Query (пример выше).

3. Удаляем товары программно с помощью wp_delete_post().

foreach ($product_ids as $product_id) {
    wp_delete_post($product_id, true); // true — без возможности восстановления
}

4. Очистка метаданных и кэшированных данных происходит автоматически.

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

• Зайдите в админ-панель WooCommerce > Товары и убедитесь, что товары с указанным атрибутом отсутствуют.
• Можно повторно выполнить WP_Query из шага 2 — он должен вернуть пустой массив.
• Проверьте, что на сайте не отображаются удалённые товары.

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

• Ошибка: Неверное имя таксономии атрибута. Решение: убедитесь, что используется правильный префикс pa_ и slug атрибута. Проверить можно в админке WooCommerce > Атрибуты.
• Ошибка: Удаление не происходит из-за недостаточных прав. Решение: код должен запускаться с правами администратора или через WP-CLI.
• Ошибка: Товары не удаляются, а только скрываются. Решение: используйте wp_delete_post($id, true) для полного удаления, без перемещения в корзину.
• Ошибка: Зависания при большом количестве товаров. Решение: разбивайте удаление на партии (например, по 100 товаров за раз).

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

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

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