WooCommerce: Автоматическое обновление атрибутов товара при изменении заказа

Диагностика проблемы: почему атрибуты товара не обновляются автоматически

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

Проверить проблему можно так: в админке WooCommerce откройте заказ, измените вариацию товара и сохраните заказ. Если атрибуты товара остались прежними, значит, автоматическое обновление не настроено.

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

1. Подключаем хук для обновления данных при сохранении заказа

Используем хук woocommerce_process_shop_order_meta, который срабатывает при сохранении заказа в админке. В функции-обработчике обновим атрибуты товаров в позиции заказа.

2. Получаем позиции заказа и обновляем атрибуты

Для каждого товара в заказе получаем объект WC_Product, затем с помощью метода get_attributes() забираем актуальные атрибуты и сохраняем их в метаданные позиции.

Пример кода для functions.php или кастомного плагина:

add_action('woocommerce_process_shop_order_meta', 'update_order_items_attributes_on_save', 20, 1);
function update_order_items_attributes_on_save($order_id) {
    $order = wc_get_order($order_id);
    if (!$order) return;

    foreach ($order->get_items() as $item_id => $item) {
        $product = $item->get_product();
        if (!$product) continue;

        $attributes = $product->get_attributes();
        $attr_data = [];
        foreach ($attributes as $attr_name => $attribute_obj) {
            // Получаем название и значение атрибута для вариативного товара
            if ($product->is_type('variation')) {
                $taxonomy = $attribute_obj->get_name();
                if (taxonomy_is_product_attribute($taxonomy)) {
                    $terms = wp_get_post_terms($product->get_id(), $taxonomy, ['fields' => 'names']);
                    $attr_data[$taxonomy] = $terms;
                } else {
                    $attr_data[$taxonomy] = $product->get_attribute($taxonomy);
                }
            } else {
                // Для простых товаров сохраняем текстовое значение
                $attr_data[$attr_name] = $attribute_obj->get_options();
            }
        }

        // Сохраняем атрибуты в метаданные позиции заказа
        wc_update_order_item_meta($item_id, '_product_attributes_snapshot', maybe_serialize($attr_data));
    }
}

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

1. В админке WooCommerce откройте существующий заказ с товарами.

2. Измените вариацию товара или добавьте новый товар в заказ.

3. Сохраните заказ.

4. Проверьте метаданные позиции заказа (через wc_get_order_item_meta или плагин для просмотра метаданных). Должен появиться ключ _product_attributes_snapshot с актуальными атрибутами.

5. На фронтенде (если выводите эти данные) убедитесь, что атрибуты соответствуют изменённым товарам.

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

• Ошибка: Атрибуты не обновляются – функция не срабатывает.
  Причина: Хук подключён неправильно или конфликт с другими плагинами.
  Решение: Проверьте приоритет хука, отключите конфликтующие плагины, убедитесь что функция подключена в нужном месте.
• Ошибка: Атрибуты сериализуются некорректно и не читаются.
  Причина: Неправильное использование maybe_serialize или сохранение в неверном формате.
  Решение: Всегда сериализуйте сложные данные перед сохранением, десериализуйте при выводе.
• Ошибка: Атрибуты не соответствуют вариации товара.
  Причина: Не учтена специфика вариаций и таксономий.
  Решение: Используйте wp_get_post_terms для таксономий атрибутов вариаций, а не только свойства объекта.

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

• Не сохраняйте весь объект продукта в метаданных заказа — только необходимые атрибуты, чтобы не перегружать базу.
• Используйте сериализацию данных для хранения сложных массивов, чтобы избежать ошибок при сохранении в базу.
• Обрабатывайте функцию только для тех заказов, где действительно изменились позиции, чтобы избежать лишней нагрузки.
• Защитите функцию от вызова вне админки, если обновление требуется только при ручном редактировании.

Сравнение вариантов обновления атрибутов товара в заказе