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

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

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

Какие хуки помогут добавить контент в корзину WooCommerce

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

• woocommerce_before_cart и woocommerce_after_cart — добавляют контент до и после всей корзины.
• woocommerce_cart_item_name — позволяет модифицировать название товара в корзине.
• woocommerce_cart_item_price — изменение цены товара в корзине.
• woocommerce_cart_item_thumbnail — изменение изображения товара.
• woocommerce_cart_item_quantity — кастомизация количества.
• woocommerce_cart_item_subtotal — изменение итоговой суммы по товару.
• woocommerce_cart_contents_total — изменяет сумму всех товаров в корзине.

Для добавления произвольных полей возле товара часто используют woocommerce_after_cart_item_name или woocommerce_before_cart_item_name.

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

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

Шаг 1. Записываем метаполе при добавлении товара в корзину (если оно динамическое):

add_filter('woocommerce_add_cart_item_data', 'add_custom_note_to_cart_item', 10, 3);
function add_custom_note_to_cart_item($cart_item_data, $product_id, $variation_id) {
    if (isset($_POST['custom_note']) && !empty($_POST['custom_note'])) {
        $cart_item_data['custom_note'] = sanitize_text_field($_POST['custom_note']);
        // Уникальный ключ, чтобы не объединять товары с разными заметками
        $cart_item_data['unique_key'] = md5(microtime().rand());
    }
    return $cart_item_data;
}

Шаг 2. Выводим пользовательское поле под названием товара в корзине:

add_filter('woocommerce_after_cart_item_name', 'display_custom_note_in_cart', 10, 3);
function display_custom_note_in_cart($cart_item, $cart_item_key, $cart_item_data) {
    if (!empty($cart_item['custom_note'])) {
        echo '<p class="custom-note" style="font-style:italic; font-size:0.9em; color:#666;">Заметка: ' . esc_html($cart_item['custom_note']) . '</p>';
    }
}

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

• Добавьте товар в корзину через фронтенд, передав поле custom_note через форму (например, дополнительное текстовое поле в шаблоне товара).
• Откройте страницу корзины — под названием товара должна появиться ваша заметка.
• Если заметка не отображается, проверьте, что данные действительно передаются и сохраняются в $cart_item_data.
• Для отладки используйте вывод массива корзины: print_r(WC()->cart->get_cart()) в шаблоне (кратковременно).

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

• Данные не сохраняются в корзине: проверьте, что используете уникальный ключ unique_key в woocommerce_add_cart_item_data, иначе WooCommerce объединит товары с одинаковыми параметрами.
• Поле не передается из формы: убедитесь, что name="custom_note" присутствует в форме добавления в корзину, и метод POST.
• HTML выводится некорректно: всегда используйте esc_html() или другие функции экранирования для вывода пользовательских данных.
• Кеширование мешает обновлению: отключите кеш страниц или используйте AJAX для динамического обновления корзины.

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

• Обязательно фильтруйте и экранируйте введённые пользователем данные (sanitize_text_field, esc_html).
• Не храните избыточные данные в сессии корзины, чтобы не перегружать базу.
• Для больших проектов реализуйте AJAX-обновление пользовательских данных в корзине, чтобы не перезагружать страницу.
• Проверяйте совместимость с плагинами кэширования и минификации — иногда они мешают динамическому выводу.

Сравнение способов добавления пользовательского контента в корзину WooCommerce