Автоматическая очистка метаданных WooCommerce после удаления плагинов

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

После удаления плагинов, которые расширяют функционал WooCommerce, часто остаются «мусорные» метаданные в базе данных. Они занимают место, замедляют запросы и могут конфликтовать с другими плагинами или кастомными решениями. Особенно это актуально для плагинов, добавляющих кастомные поля к заказам, товарам или пользователям.

Чтобы проверить наличие таких данных, можно выполнить SQL-запросы к таблицам wp_postmeta и wp_usermeta с фильтрацией по ключам, связанным с удалённым плагином (обычно ключи содержат префикс или название плагина).

SELECT DISTINCT meta_key FROM wp_postmeta WHERE meta_key LIKE '%pluginprefix_%';

Если запрос возвращает множество записей, значит данные остались и их надо почистить.

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

Использование хука register_uninstall_hook

WordPress позволяет запускать код при удалении плагина через файл uninstall.php или функцию register_uninstall_hook. Для плагинов WooCommerce можно реализовать удаление кастомных метаданных заказов, товаров и пользователей.

Пример кода для очистки метаданных с префиксом myplugin_:

function myplugin_uninstall_cleanup() {
    global $wpdb;
    // Удаляем метаданные заказов
    $wpdb->query(
        $wpdb->prepare(
            "DELETE FROM {$wpdb->postmeta} WHERE meta_key LIKE %s",
            'myplugin_%'
        )
    );
    // Удаляем метаданные пользователей
    $wpdb->query(
        $wpdb->prepare(
            "DELETE FROM {$wpdb->usermeta} WHERE meta_key LIKE %s",
            'myplugin_%'
        )
    );
}

register_uninstall_hook(__FILE__, 'myplugin_uninstall_cleanup');

Удаление метаданных из заказов WooCommerce с кастомными полями

Если плагин добавлял поля к заказам, можно дополнительно очистить их через API WooCommerce:

function myplugin_clear_order_meta() {
    $args = [
        'limit' => -1,
        'status' => 'any',
        'return' => 'ids',
    ];
    $orders = wc_get_orders($args);
    foreach ($orders as $order_id) {
        $order = wc_get_order($order_id);
        foreach ($order->get_meta() as $key => $value) {
            if (strpos($key, 'myplugin_') === 0) {
                $order->delete_meta_data($key);
            }
        }
        $order->save();
    }
}

Этот код можно вызвать внутри функции очистки, чтобы гарантировать удаление метаданных через API.

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

Для проверки успешного удаления метаданных:

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

Дополнительно можно использовать WP-CLI для быстрого поиска метаданных:

wp post meta list --keys=myplugin_*

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

• Неправильный префикс метаданных: убедитесь, что вы используете точный префикс, совпадающий с тем, что использовал плагин.
• Удаление в неправильном хуке: функция очистки должна быть привязана к register_uninstall_hook или в uninstall.php.
• Отсутствие прав доступа к базе: убедитесь, что код выполняется с нужными правами для удаления данных.
• Кеширование: если после удаления метаданные отображаются, очистите кеш сайта и базы данных.

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

• Перед удалением данных сделайте бэкап базы — это позволит откатить изменения в случае ошибки.
• Используйте транзакции или разбивайте удаление на части, чтобы избежать таймаутов при большом объёме данных.
• Проверяйте наличие зависимостей перед удалением, чтобы не удалить необходимые данные.
• Для автоматизации удаления незавершённых или устаревших метаданных можно настроить WP-Cron с аналогичным кодом.

Сравнение методов очистки метаданных WooCommerce