Как установить уникальные идентификаторы для заказов WooCommerce

Диагностика проблемы с идентификаторами заказов WooCommerce

По умолчанию WooCommerce использует числовой идентификатор заказа, совпадающий с ID записи в базе данных WordPress. Это может привести к путанице или проблемам при интеграции с другими системами, если требуется уникальный и читаемый формат номера заказа. Часто возникает необходимость в кастомном префиксе, суффиксе, или в формате, включающем дату или другие параметры.

Чтобы понять, нужна ли кастомизация, проверьте текущий номер заказа в админке WooCommerce и в письмах клиентам. Если формат не соответствует требованиям бизнеса, стоит реализовать решение по изменению ID.

Пошаговое решение: добавление уникального формата номера заказа

Шаг 1. Изменение отображения номера заказа в админке и письмах

Добавьте следующий код в файл functions.php вашей темы или в кастомный плагин:

add_filter('woocommerce_order_number', 'custom_woocommerce_order_number', 10, 2);
function custom_woocommerce_order_number($order_id, $order) {
    // Пример: префикс WOOC + год + ID заказа с ведущими нулями
    $prefix = 'WOOC';
    $year = date('Y', strtotime($order->get_date_created()));
    $padded_id = str_pad($order_id, 6, '0', STR_PAD_LEFT);
    return $prefix . $year . '-' . $padded_id;
}

Этот фильтр переопределяет номер заказа для отображения, сохраняя при этом внутренний ID в базе. Пример: WOOC2024-000123.

Шаг 2. Обеспечение сохранения и поиска по кастомному номеру

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

add_action('woocommerce_checkout_update_order_meta', 'save_custom_order_number_meta');
function save_custom_order_number_meta($order_id) {
    $order = wc_get_order($order_id);
    $custom_number = 'WOOC' . date('Y', strtotime($order->get_date_created())) . '-' . str_pad($order_id, 6, '0', STR_PAD_LEFT);
    update_post_meta($order_id, '_custom_order_number', $custom_number);
}

Для поиска по новому номеру в админке понадобится доработка фильтров поиска или использование плагина, поддерживающего поиск по мета-полям.

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

• Создайте новый заказ через фронт или админку и убедитесь, что в списке заказов и в письмах отображается новый формат номера.
• Проверьте, что старые заказы не изменились и по ним отображается стандартный ID.
• Попробуйте найти заказ в админке по новому номеру, если реализовали сохранение мета-поля.

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

• Номер заказа не отображается в письмах: убедитесь, что шаблоны email используют фильтр woocommerce_order_number, а не напрямую выводят $order->get_id().
• Проблемы с поиском заказов по кастомному номеру: стандартный поиск по ID не работает с пользовательским форматом. Решение — использовать мета-поле и доработать поисковый запрос в админке.
• Конфликты с плагинами, которые используют ID заказа: не меняйте внутренний ID заказа, только отображаемое значение. Иначе возможны сбои в работе WooCommerce и сторонних расширений.

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

• Не храните пользовательские номера заказов как основной идентификатор записи, используйте мета-поля для дополнительного хранения.
• Кэшируйте результаты запроса, если реализуете поиск по мета-полям, чтобы избежать нагрузки на базу.
• Следите за длиной и уникальностью формата номера, чтобы не возникало коллизий.

Сравнение вариантов решения задачи