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

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

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

Без правильной настройки такие изменения либо не сохраняются, либо не отображаются на странице корзины и оформления заказа, из-за особенностей работы WooCommerce с объектами корзины.

Какой хук использовать для изменения данных товаров в корзине

Основной хук для динамического изменения данных товара в корзине — woocommerce_add_cart_item_data. Он срабатывает при добавлении товара в корзину и позволяет добавить свои данные в массив товара.

Для изменения данных уже добавленного товара применяют фильтр woocommerce_get_cart_item_from_session — он восстанавливает данные из сессии и дает возможность модифицировать их при загрузке корзины.

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

add_filter('woocommerce_add_cart_item_data', 'add_custom_data_to_cart_item', 10, 3);function add_custom_data_to_cart_item($cart_item_data, $product_id, $variation_id) {    $custom_value = isset($_POST['custom_field']) ? sanitize_text_field($_POST['custom_field']) : '';    if (!empty($custom_value)) {        $cart_item_data['custom_field'] = $custom_value;        // Для уникальности позиции корзины, чтобы избежать слияния товаров        $cart_item_data['unique_key'] = md5(microtime().rand());    }    return $cart_item_data;}

Этот код добавляет в массив данных корзины пользовательское поле custom_field, если оно передано через форму товара.

Восстановление данных из сессии при обновлении корзины

add_filter('woocommerce_get_cart_item_from_session', 'get_custom_data_from_session', 20, 2);function get_custom_data_from_session($cart_item, $values) {    if (isset($values['custom_field'])) {        $cart_item['custom_field'] = $values['custom_field'];    }    return $cart_item;}

Это гарантирует, что данные custom_field не потеряются при перезагрузке страницы корзины или оформлении заказа.

Как вывести пользовательские данные в корзине и на странице оформления заказа

Чтобы пользователь видел дополнительную информацию, нужно добавить вывод данных в шаблоны WooCommerce.

add_filter('woocommerce_get_item_data', 'display_custom_cart_item_data', 10, 2);function display_custom_cart_item_data($item_data, $cart_item) {    if (isset($cart_item['custom_field'])) {        $item_data[] = array(            'key' => __('Дополнительная информация', 'woocommerce'),            'value' => wc_clean($cart_item['custom_field'])        );    }    return $item_data;}

Этот фильтр добавляет строку с ключом и значением в список данных товара в корзине и на оформлении заказа.

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

1. Добавьте товар в корзину с заполненным пользовательским полем (например, через кастомную форму на странице товара).

2. Перейдите в корзину — рядом с товаром должна появиться дополнительная информация.

3. Обновите страницу оформления заказа — данные должны сохраняться и отображаться.

4. Проверьте, что для разных значений поля создаются отдельные позиции в корзине (важно, если это предусмотрено).

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

• Данные не сохраняются после обновления страницы корзины — забыли добавить фильтр woocommerce_get_cart_item_from_session для восстановления данных из сессии.
• Товары объединяются в корзине, несмотря на разницу в пользовательских данных — не добавлен уникальный ключ unique_key в woocommerce_add_cart_item_data.
• Данные не выводятся в корзине — не реализован фильтр woocommerce_get_item_data для отображения пользовательских данных.
• Ошибка безопасности при обработке пользовательских данных — не применена очистка входных данных через sanitize_text_field или аналогичные функции.

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

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

Сравнение подходов: использование плагинов vs. кастомный код