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

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

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

Обзор хуков для вывода в корзине WooCommerce

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

• woocommerce_before_cart — перед всей формой корзины.
• woocommerce_after_cart — после всей формы корзины.
• woocommerce_cart_contents — внутри таблицы корзины, после списка товаров.
• woocommerce_cart_totals_before_order_total — перед суммой заказа.
• woocommerce_cart_totals_after_order_total — после суммы заказа.

Выбор хука зависит от того, где именно нужна информация.

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

Допустим, нужно вывести предупреждение, если сумма заказа менее 1000 рублей.

1. Добавляем функцию в файл functions.php темы или в собственный плагин:

add_action('woocommerce_before_cart', 'show_minimum_order_notice');
function show_minimum_order_notice() {
    $minimum = 1000; // минимальная сумма заказа
    $cart_total = WC()->cart->get_subtotal();
    if ( $cart_total < $minimum ) {
        echo '<div class="woocommerce-message" style="background:#ffebe8; color:#d63638; padding:10px; margin-bottom:20px;">';
        echo 'Минимальная сумма заказа — 1000 ₽. Добавьте товаров на ' . wc_price($minimum - $cart_total) . ' для оформления заказа.';
        echo '</div>';
    }
}

2. Обновите страницу корзины и убедитесь, что при сумме ниже 1000 рублей появляется сообщение.

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

Чтобы проверить, что хук сработал:

• Откройте корзину на сайте.
• Добавьте товаров на сумму меньше 1000 рублей.
• Проверьте, что вверху корзины появилось красное предупреждение.
• Увеличьте сумму заказа выше 1000 рублей — сообщение должно исчезнуть.

Расширение: добавляем динамическое сообщение возле каждого товара в корзине

Для вывода дополнительной информации возле каждого товара используйте хук woocommerce_cart_item_name, который позволяет фильтровать название товара в корзине.

add_filter('woocommerce_cart_item_name', 'add_custom_text_to_cart_item', 10, 3);
function add_custom_text_to_cart_item($product_name, $cart_item, $cart_item_key) {
    $product = $cart_item['data'];
    $sku = $product->get_sku();
    if ( $sku ) {
        $product_name .= '<br><small>Артикул: ' . esc_html($sku) . '</small>';
    }
    return $product_name;
}

Этот код добавляет артикул товара под его названием в корзине.

Чек-лист: как правильно работать с хуками WooCommerce в корзине

• Используйте официальные хуки WooCommerce, не изменяйте шаблоны напрямую.
• Пишите код в дочерней теме или в плагине, чтобы сохранять изменения при обновлениях.
• Проверяйте наличие корзины и объекта WC()->cart перед использованием.
• Используйте функции WooCommerce для получения цен и данных (например, wc_price()).
• Тестируйте на разных устройствах и браузерах.

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

1. Сообщение не выводится в корзине

Причина: функция подключена неправильно или хук указан с ошибкой. Проверьте, что add_action использует правильное имя хука (woocommerce_before_cart) и что код загружается (например, в functions.php дочерней темы).

2. Выводится на всех страницах, а не только в корзине

Добавьте проверку в функцию:

if ( !is_cart() ) return;

3. Неправильные суммы из-за использования get_subtotal()

Для точного расчёта используйте WC()->cart->total или WC()->cart->get_cart_contents_total(), учитывая налоги и скидки.

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

• Не выполняйте тяжёлых запросов в хуках, вызываемых на каждой загрузке корзины.
• Экранируйте вывод HTML, чтобы избежать XSS (esc_html(), esc_attr()).
• Кэшируйте результаты, если выполняете сложные вычисления.
• Тестируйте совместимость с используемой темой и плагинами.

Сравнение вариантов вывода дополнительной информации в корзине WooCommerce