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

Что такое хук woocommerce_before_add_to_cart_button и зачем он нужен

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

Диагностика задачи: когда использовать этот хук

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

• всплывающие подсказки или предупреждения перед кнопкой
• кастомные поля выбора опций, не предусмотренные стандартом
• информацию о гарантии, скидках или сроках доставки
• вызов кастомных функций с динамическим контентом

— то woocommerce_before_add_to_cart_button — лучший выбор.

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

1. Откройте файл functions.php вашей дочерней темы или подключаемого плагина.

2. Добавьте следующий код:

add_action('woocommerce_before_add_to_cart_button', 'wpurok_custom_before_add_to_cart');
function wpurok_custom_before_add_to_cart() {
    echo '<div class="wpurok-custom-info" style="margin-bottom:10px;color:#444;font-weight:bold;">Бесплатная доставка при заказе от 5000 руб.</div>';
}

3. Сохраните изменения и обновите страницу товара на сайте.

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

add_action('woocommerce_before_add_to_cart_button', 'wpurok_stock_notice');
function wpurok_stock_notice() {
    global $product;
    if ( $product->is_in_stock() ) {
        echo '<p style="color:green;font-weight:bold;">Товар в наличии. Закажите сейчас!</p>';
    } else {
        echo '<p style="color:red;">Товар временно отсутствует</p>';
    }
}

Как проверить, что решение работает

• Откройте любую страницу товара на сайте.
• Проверьте, что перед кнопкой "Добавить в корзину" появился ваш кастомный текст.
• Для динамического варианта измените наличие товара в админке и обновите страницу, чтобы увидеть изменение текста.
• Используйте инструменты разработчика браузера (F12) для проверки структуры и стилей.

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

• Добавление кода не в дочернюю тему или плагин — при обновлении темы изменения пропадут.
• Отсутствие глобальной переменной $product в функции — приведет к ошибкам или пустому выводу.
• Вывод сложного HTML без оберток и стилей — может сломать верстку страницы.
• Подключение к хуку вне контекста страницы товара — код не сработает.

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

• Всегда экранируйте выводимый HTML, если данные берутся из пользовательского ввода.
• Минимизируйте тяжелые операции внутри хука, чтобы не замедлять загрузку страницы.
• Если добавляете скрипты или стили, регистрируйте их отдельно и подключайте только на страницах товаров.
• Для сложных полей используйте woocommerce_form_field() для корректного отображения и валидации.

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

Метод	Описание	Плюсы	Минусы
Хук woocommerce_before_add_to_cart_button	Добавление кода через functions.php или плагин	Простота, гибкость, не требует правки шаблонов	Требует базовых знаний PHP, ограничен контекстом страницы товара
Правка шаблона single-product/add-to-cart/simple.php	Внесение изменений в файл шаблона темы	Полный контроль над выводом HTML	Сложнее обновлять, риск потерять изменения при обновлении темы
Использование плагинов с визуальным редактором	Добавление контента через плагины типа Elementor, WooBuilder	Удобно для неразработчиков, визуальный контроль	Может снизить производительность, менее гибко для сложных задач