Как автоматически изменять метаданные WooCommerce при обновлении заказа

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

В WooCommerce часто возникает задача автоматического обновления дополнительных данных заказа при изменении его статуса или других параметров. Например, нужно обновить внутренние метки для аналитики, добавить временную метку изменения или записать пользовательские комментарии. Ручное редактирование неудобно и prone to errors, поэтому автоматизация с помощью хуков — лучший выбор.

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

1. Выбор подходящего хука

Для отслеживания обновления заказа оптимально использовать хук woocommerce_update_order. Он срабатывает при любом обновлении объекта WC_Order.

2. Пример кода для автоматического обновления метаданных

add_action('woocommerce_update_order', 'update_order_custom_meta_on_change', 10, 1); 
function update_order_custom_meta_on_change( $order_id ) {
    if ( ! $order_id ) {
        return;
    }
    $order = wc_get_order( $order_id );
    if ( ! $order ) {
        return;
    }
    // Добавим или обновим метаданные
    $current_time = current_time('mysql');
    update_post_meta( $order_id, '_custom_meta_last_updated', $current_time );
    
    // Пример: обновим мета поле, если статус изменился на "completed"
    if ( $order->get_status() === 'completed' ) {
        update_post_meta( $order_id, '_custom_meta_completed_flag', 'yes' );
    }
}

3. Альтернативный хук для смены статуса

Если нужно реагировать именно на смену статуса, лучше использовать woocommerce_order_status_changed:

add_action('woocommerce_order_status_changed', 'on_order_status_changed_update_meta', 10, 4);
function on_order_status_changed_update_meta( $order_id, $old_status, $new_status, $order ) {
    if ( $new_status === 'completed' ) {
        update_post_meta( $order_id, '_custom_meta_completed_at', current_time('mysql') );
    }
}

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

Чтобы проверить, что метаданные обновляются корректно:

• В админке WordPress перейдите в раздел «Заказы».
• Откройте заказ, измените его статус (например, на «Завершён»).
• Используйте плагин «Advanced Custom Fields» или «WP All Import» для просмотра метаданных, либо через базу данных (таблица wp_postmeta).
• Проверьте наличие и корректность значений полей _custom_meta_last_updated и _custom_meta_completed_flag.

Также можно добавить логирование для отладки:

error_log('Order ' . $order_id . ' meta updated at ' . current_time('mysql'));

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

• Нет обновления метаданных: Проверьте, вызывается ли хук. Для этого временно добавьте error_log в функцию.
• Неверный ID заказа: Убедитесь, что функция получает правильный $order_id, и что заказ существует.
• Конфликт с кешированием: Если сайт использует кеширование, метаданные могут не сразу отображаться. Очистите кеш после теста.
• Неверный формат данных: Для даты используйте current_time('mysql') или timestamp. Не сохраняйте сложные объекты без сериализации.

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

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

Сравнение вариантов реализации обновления метаданных