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

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

Хук woocommerce_before_add_to_cart_button позволяет вставлять дополнительный код или изменять поведение перед выводом кнопки «Добавить в корзину» на странице товара WooCommerce. Это полезно, если нужно добавить динамические элементы, например, поля ввода, дополнительные опции, сообщения или изменить данные товара перед добавлением в корзину.

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

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

Если вы попробовали добавить кастомный код и не видите изменений на странице товара, значит, либо хук не сработал, либо код размещён не в том месте.

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

add_action('woocommerce_before_add_to_cart_button', function() { echo '<p>Хук работает!</p>'; });

Добавьте этот код в functions.php вашей дочерней темы или в плагин. После обновления страницы товара вы должны увидеть текст "Хук работает!" перед кнопкой "В корзину".

Пошаговое руководство по добавлению динамического поля с передачей данных в корзину

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

add_action('woocommerce_before_add_to_cart_button', 'add_custom_text_field_to_product');
function add_custom_text_field_to_product() {
    echo '<label for="custom_text_field">Введите текст:</label>';
    echo '<input type="text" id="custom_text_field" name="custom_text_field" value="" />';
}

2. Проверяем и валидируем данные при добавлении в корзину

add_filter('woocommerce_add_to_cart_validation', 'validate_custom_text_field', 10, 3);
function validate_custom_text_field($passed, $product_id, $quantity) {
    if (isset($_REQUEST['custom_text_field']) && sanitize_text_field($_REQUEST['custom_text_field']) === '') {
        wc_add_notice('Пожалуйста, введите текст в дополнительное поле.', 'error');
        return false;
    }
    return $passed;
}

3. Добавляем данные поля в данные корзины

add_filter('woocommerce_add_cart_item_data', 'add_custom_text_field_cart_item_data', 10, 2);
function add_custom_text_field_cart_item_data($cart_item_data, $product_id) {
    if (!empty($_REQUEST['custom_text_field'])) {
        $cart_item_data['custom_text_field'] = sanitize_text_field($_REQUEST['custom_text_field']);
        // Чтобы избежать слияния товаров с разными данными
        $cart_item_data['unique_key'] = md5(microtime().rand());
    }
    return $cart_item_data;
}

4. Отображаем данные поля в корзине и на странице оформления заказа

add_filter('woocommerce_get_item_data', 'display_custom_text_field_cart', 10, 2);
function display_custom_text_field_cart($item_data, $cart_item) {
    if (isset($cart_item['custom_text_field'])) {
        $item_data[] = array(
            'key' => 'Дополнительный текст',
            'value' => wc_clean($cart_item['custom_text_field'])
        );
    }
    return $item_data;
}

5. Сохраняем данные в заказ

add_action('woocommerce_add_order_item_meta', 'add_custom_text_field_order_items', 10, 3);
function add_custom_text_field_order_items($item_id, $values, $cart_item_key) {
    if (isset($values['custom_text_field'])) {
        wc_add_order_item_meta($item_id, 'Дополнительный текст', $values['custom_text_field']);
    }
}

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

• Обновите страницу товара и убедитесь, что перед кнопкой «В корзину» отображается новое поле.
• Попробуйте добавить товар в корзину без заполнения поля — должна появиться ошибка.
• Добавьте товар с заполненным полем, перейдите в корзину — в списке товаров должно быть видно введённое значение.
• Оформите заказ и проверьте в админке WooCommerce в деталях заказа наличие дополнительного поля у товара.

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

• Поле не отображается — возможно, код добавлен в неподходящий файл или тема переопределяет шаблон. Проверьте подключение кода и используйте отладку с выводом тестового текста.
• Данные не проходят в корзину — убедитесь, что имя поля name="custom_text_field" совпадает везде, и нет конфликтов с другими плагинами.
• Товары с разными значениями поля сливаются — используйте уникальный ключ в cart_item_data, как показано выше.
• Не отображается дополнительная информация в заказе — используйте правильный хук woocommerce_add_order_item_meta и проверяйте сохранение в базе.

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

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

Сравнение вариантов реализации динамических полей в WooCommerce