Удаление загружаемых картинок из WooCommerce после импорта товаров

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

При массовом импорте товаров в WooCommerce часто загружаются изображения, которые не используются, дублируются или создают нагрузку на сервер и базу данных. Из-за этого растет размер медиатеки, замедляется работа сайта, появляются проблемы с резервным копированием и обновлением. Особенно актуально, если импорт происходил из внешних источников или CSV, где не всегда корректно сопоставлены изображения.

Как понять, что картинки нужно удалить

• В медиатеке много изображений, не прикрепленных к товарам (проверьте через wp-admin/upload.php).
• Размер папки wp-content/uploads значительно увеличился после импорта.
• Экспорт товаров в CSV показывает пустые поля с изображениями, но в медиатеке есть загруженные файлы.
• В базе данных в таблице wp_postmeta есть записи изображений, которые не связаны с товарами.

Пошаговое решение: удаление ненужных изображений после импорта в WooCommerce

1. Создание резервной копии базы данных и файлов сайта

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

2. Поиск и удаление неиспользуемых изображений с помощью PHP-скрипта

В WordPress и WooCommerce изображения привязываются к товарам через мета-данные и посты вложения (post_type = 'attachment'). Чтобы найти неиспользуемые изображения, нужно:

• Получить все изображения, которые не связаны с товарами.
• Удалить эти изображения программно.

Пример кода для удаления неиспользуемых изображений (выполнить в файле темы или плагине):

function wc_delete_unused_images() {
    global $wpdb;
    // Получаем ID всех вложений
    $attachments = $wpdb->get_col("SELECT ID FROM {$wpdb->posts} WHERE post_type = 'attachment'");

    $deleted = 0;
    foreach ($attachments as $attachment_id) {
        // Проверяем, связана ли картинка с товаром
        $parent_id = wp_get_post_parent_id($attachment_id);
        if (!$parent_id || get_post_type($parent_id) !== 'product') {
            // Удаляем изображение без возможности восстановления
            wp_delete_attachment($attachment_id, true);
            $deleted++;
        }
    }
    return $deleted;
}

// Запуск функции
$deleted_count = wc_delete_unused_images();
echo "Удалено изображений: " . $deleted_count;

3. Очистка медиатеки и папки uploads от остаточных файлов

Функция wp_delete_attachment удаляет запись и сам файл. Но иногда файлы остаются из-за ошибок или нестандартных путей. Проверьте папку wp-content/uploads через FTP или файловый менеджер и удалите остаточные файлы вручную или через WP CLI:

wp media regenerate --yes
wp media delete $(wp media list --field=ID --format=csv --unattached)

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

Чтобы убедиться, что ненужные картинки удалены:

• Проверьте медиатеку — количество изображений должно уменьшиться.
• Проверьте размер папки wp-content/uploads — он должен стать меньше.
• Воспользуйтесь плагином Query Monitor или SQL-запросом для проверки количества вложений:

SELECT COUNT(*) FROM wp_posts WHERE post_type = 'attachment';

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

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

• Удаление нужных изображений: если изображения прикреплены не к товарам, а к страницам или другим постам, их можно случайно удалить. Решение — перед удалением проверять не только родителя, но и другие связи (например, через мета-данные).
• Недостаточно прав для удаления: скрипт не удаляет файлы из-за прав на файловой системе. Проверяйте права на папки и файлы, например, должны быть 755 для папок и 644 для файлов.
• Прерывание скрипта из-за большого количества файлов: разбивайте удаление на части или используйте WP CLI с ограничением по времени.

Практические советы по оптимизации и безопасности

• Всегда делайте бэкап перед массовыми удалениями.
• Используйте WP CLI для более безопасного и быстрого управления медиа.
• Настройте регулярную очистку медиатеки от неиспользуемых файлов, чтобы не накапливать «мусор».
• Ограничьте права доступа к папке uploads, чтобы избежать случайных изменений сторонними скриптами.
• При импорте товаров используйте проверенные плагины, которые не создают дублирующие изображения.

Сравнение способов удаления неиспользуемых изображений

Метод	Плюсы	Минусы
PHP-скрипт в теме/плагине	Гибкость, можно настроить логику удаления	Риск ошибки, требует навыков
WP CLI команды	Быстро, безопасно, подходит для больших сайтов	Требует доступа к консоли сервера
Плагины типа Media Cleaner	Удобный интерфейс, автоматизация	Может не корректно определять связи, нагрузка на сайт