WooCommerce: как установить уникальный код для отложенных заказов

Диагностика задачи: зачем нужен уникальный код для отложенных заказов в WooCommerce

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

Проверить наличие уникального кода можно, посмотрев таблицу wp_posts и метаданные заказов в wp_postmeta. Если для отложенных заказов нет уникального идентификатора, задача актуальна.

Как добавить уникальный код к отложенным заказам в WooCommerce

Шаг 1. Создаём метаполе для хранения уникального кода

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

add_action('woocommerce_checkout_update_order_meta', 'wpbono_set_unique_pending_code');
function wpbono_set_unique_pending_code($order_id) {
    $order = wc_get_order($order_id);
    // Проверяем, что заказ в статусе 'on-hold' (отложенный)
    if ($order && $order->get_status() === 'on-hold') {
        $unique_code = 'PEND-' . $order_id . '-' . time();
        update_post_meta($order_id, '_unique_pending_code', $unique_code);
    }
}

Шаг 2. Автоматическое присвоение кода при смене статуса на отложенный

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

add_action('woocommerce_order_status_on-hold', 'wpbono_add_code_on_status_change');
function wpbono_add_code_on_status_change($order_id) {
    $unique_code = 'PEND-' . $order_id . '-' . time();
    update_post_meta($order_id, '_unique_pending_code', $unique_code);
}

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

1. Создайте тестовый заказ и установите ему статус on-hold (отложенный).
2. В админке WordPress перейдите в раздел заказов, откройте созданный заказ и в метаданных (Custom Fields) найдите ключ _unique_pending_code.
3. Убедитесь, что код отображается и уникален для каждого заказа.

Также можно проверить через базу данных MySQL:

SELECT post_id, meta_value FROM wp_postmeta WHERE meta_key = '_unique_pending_code';

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

• Код не присваивается заказу: Проверьте, что хуки woocommerce_checkout_update_order_meta и woocommerce_order_status_on-hold корректно подключены и активны. Также убедитесь, что статус заказа действительно on-hold.
• Код не уникален: Используйте time() или uniqid() для генерации уникального значения, не полагаясь только на ID заказа.
• Невидимость кода в админке: Включите отображение произвольных полей в редакторе заказов или используйте плагин для работы с метаданными, например Advanced Custom Fields.

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

• Храните уникальные коды только как метаданные заказов, чтобы не перегружать основную таблицу заказов.
• Генерируйте коды без использования пользовательского ввода, чтобы избежать XSS-уязвимостей.
• Для массовых операций (например, экспорт или синхронизация с CRM) делайте выборки по метаполю _unique_pending_code с индексами по meta_key в базе данных.

Сравнение вариантов реализации