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

Что делает хук woocommerce_before_add_to_cart_button и для чего он нужен

Хук woocommerce_before_add_to_cart_button срабатывает непосредственно перед кнопкой "Добавить в корзину" на странице товара в WooCommerce. Это удобное место для вывода дополнительной информации, полей, уведомлений или динамического изменения данных товара без редактирования шаблонов темы.

Диагностика задачи: зачем и когда применять этот хук

Часто нужно показать дополнительные параметры или изменить поведение товара на лету, например:

• Показывать предупреждение, если товар скоро закончится
• Добавлять дополнительное поле для выбора опции
• Отображать динамический текст или цены в зависимости от пользовательских данных
• Выводить кастомные сообщения при определённых условиях

Если изменить шаблоны темы неудобно или нежелательно, этот хук — идеальное решение.

Диагностика проблемы

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

• Вы подключаете код в functions.php дочерней темы или в плагине
• Вы не блокируете вывод кнопки добавления в корзину
• Нет конфликтов с другими плагинами, которые могут перехватывать вывод

Пошаговое решение: пример динамического изменения контента перед кнопкой

Добавим кастомное сообщение о скидке, если цена товара больше 1000 рублей.

add_action('woocommerce_before_add_to_cart_button', 'hueman_add_discount_notice_before_button');
function hueman_add_discount_notice_before_button() {
    global $product;
    if ( ! is_product() ) return; // только на странице товара

    $price = floatval( $product->get_price() );
    if ( $price > 1000 ) {
        echo '<div style="color: green; font-weight: bold; margin-bottom: 10px;">Поздравляем! Для этого товара действует скидка 5% при заказе от 3 штук.</div>';
    }
}

Добавление кастомного поля перед кнопкой

Добавим поле для выбора подарочной упаковки:

add_action('woocommerce_before_add_to_cart_button', 'hueman_add_gift_wrap_option');
function hueman_add_gift_wrap_option() {
    echo '<p><label><input type="checkbox" name="gift_wrap" value="yes" /> Подарочная упаковка (+200 руб.)</label></p>';
}

// Сохраняем поле в корзину
add_filter('woocommerce_add_cart_item_data', 'hueman_save_gift_wrap_cart_item_data', 10, 2);
function hueman_save_gift_wrap_cart_item_data($cart_item_data, $product_id) {
    if ( isset($_POST['gift_wrap']) && $_POST['gift_wrap'] === 'yes' ) {
        $cart_item_data['gift_wrap'] = true;
        $cart_item_data['unique_key'] = md5(microtime().rand()); // для уникальности
    }
    return $cart_item_data;
}

// Отображение в корзине и заказе
add_filter('woocommerce_get_item_data', 'hueman_display_gift_wrap_cart', 10, 2);
function hueman_display_gift_wrap_cart($item_data, $cart_item) {
    if ( ! empty($cart_item['gift_wrap']) ) {
        $item_data[] = array(
            'key'   => 'Подарочная упаковка',
            'value' => 'Да',
        );
    }
    return $item_data;
}

// Добавляем стоимость упаковки
add_action('woocommerce_before_calculate_totals', 'hueman_add_gift_wrap_price');
function hueman_add_gift_wrap_price($cart) {
    if ( is_admin() && ! defined('DOING_AJAX') ) return;

    foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
        if ( ! empty($cart_item['gift_wrap']) ) {
            $additional_price = 200; // стоимость упаковки
            $cart_item['data']->set_price( $cart_item['data']->get_price() + $additional_price );
        }
    }
}

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

• Перейдите на страницу товара, цена которого выше 1000 руб. — должно отобразиться сообщение о скидке перед кнопкой.
• Появится чекбокс «Подарочная упаковка» перед кнопкой «Добавить в корзину».
• Если поставить галочку и добавить товар в корзину, в корзине и при оформлении заказа отобразится информация о подарочной упаковке.
• Стоимость товара в корзине увеличится на 200 руб. при выборе упаковки.

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

• Хук не срабатывает: убедитесь, что код подключён в functions.php дочерней темы или в плагине и нет синтаксических ошибок.
• Поле не сохраняется в корзину: проверьте, что вы используете фильтр woocommerce_add_cart_item_data корректно и уникальный ключ для каждого товара задан.
• Стоимость не меняется в корзине: в хук woocommerce_before_calculate_totals передавайте объект корзины, не забудьте проверку is_admin() с исключением AJAX.
• Конфликты с другими плагинами: временно отключите другие плагины и проверьте работу кода, чтобы исключить конфликты.

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

• Используйте esc_html() и другие функции экранирования при выводе данных, если выводите пользовательский ввод.
• Минимизируйте вычисления внутри хуков, чтобы не замедлять загрузку страницы товара.
• Для сложных форм используйте AJAX, чтобы не перегружать страницу.
• Тестируйте код в режиме отладки и на staging-сервере перед внедрением на продакшн.

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