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

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

Стандартный шаблон корзины WooCommerce иногда не удовлетворяет требованиям дизайна или бизнес-логики. Например, нужно изменить текст кнопки, добавить дополнительные данные о товарах или изменить структуру таблицы корзины. Прямое изменение файлов темы или плагина приведёт к проблемам при обновлении. Поэтому правильный способ — использовать хуки WooCommerce: actions и filters.

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

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

• woocommerce_before_cart — перед выводом корзины;
• woocommerce_cart_item_name — фильтр для названия товара в корзине;
• woocommerce_cart_item_price — цена товара;
• woocommerce_cart_item_quantity — количество товара;
• woocommerce_after_cart_table — после таблицы корзины;
• woocommerce_cart_totals_before_order_total — перед итоговой суммой.

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

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

Шаг 1. Создаём функцию для фильтра woocommerce_cart_item_name:

add_filter('woocommerce_cart_item_name', 'add_sku_code_to_cart_item_name', 10, 3);
function add_sku_code_to_cart_item_name($product_name, $cart_item, $cart_item_key) {
    $product = $cart_item['data'];
    $sku_code = get_post_meta($product->get_id(), '_sku_code', true);
    if (!empty($sku_code)) {
        $product_name .= '<br><small>Артикул: ' . esc_html($sku_code) . '</small>';
    }
    return $product_name;
}

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

Шаг 2. Изменим текст кнопки «Обновить корзину» на более информативный с помощью фильтра woocommerce_cart_actions и хука woocommerce_update_cart_action:

add_filter('woocommerce_update_cart_action', function() {
    return 'Обновить и пересчитать';
});

В WooCommerce нет отдельного фильтра для текста кнопки обновления, но вы можете изменить его через перевод или переопределение шаблона. Для простоты здесь приведён пример с экшеном, который отвечает за действие.

Проверка результата

• Откройте корзину с добавленными товарами, у которых заполнено пользовательское поле _sku_code.
• Проверьте, что под названием товара появилось дополнительное описание с артикулом.
• Проверьте наличие текста кнопки «Обновить и пересчитать» или внесённые изменения (если применимо).
• Если изменений нет, проверьте, подключён ли ваш код (functions.php или плагин), а также правильность названий метаполей.

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

• Код не срабатывает: функция не подключена или написана с ошибками. Проверяйте error_log и используйте wp_debug.
• Неправильное имя метаполя: убедитесь, что _sku_code существует и заполнено для товара.
• Конфликт с темой или плагинами: отключите сторонние плагины, чтобы проверить конфликт.
• Проблемы с экранированием HTML: используйте esc_html или wp_kses_post для безопасности.

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

• Не выводите необработанные пользовательские данные — всегда экранируйте.
• Не используйте хук woocommerce_cart_item_name для тяжёлых операций — кешируйте данные, если нужно.
• Добавляйте код в дочернюю тему или собственный плагин, чтобы не потерять при обновлениях.
• Тестируйте изменения на staging-сайте перед внедрением на рабочем.

Сравнение методов изменения вывода корзины WooCommerce