Как использовать WooCommerce хуки для добавления дополнительной функциональности

Что такое хуки в WooCommerce и зачем они нужны

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

Разница между action и filter

• Action — выполняет произвольный код в определенный момент (например, после оформления заказа).
• Filter — изменяет данные перед выводом или сохранением (например, изменить текст кнопки).

Диагностика: как понять, какой хук использовать

Первый шаг — определить, на каком этапе нужно вмешаться. Например, если нужно добавить информацию на страницу товара — ищем action, который вызывается при выводе контента товара. Для изменения текста кнопок — фильтры, которые отвечают за локализацию или шаблон.

Используйте официальную документацию WooCommerce и плагин Show Hooks для визуального определения хуков на страницах.

Пошаговое решение: добавляем кастомное сообщение на страницу корзины

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

add_action('woocommerce_cart_contents', 'wplab_custom_cart_message');
function wplab_custom_cart_message() {
    echo '<div style="margin-top:20px; padding:10px; background:#f9f9f9; border:1px solid #ddd;">Обратите внимание: доставка рассчитывается при оформлении заказа.</div>';
}

Разместили код в functions.php вашей дочерней темы или в отдельном плагине.

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

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

Использование фильтра для изменения текста кнопки «Добавить в корзину»

Пример: нужно заменить стандартный текст кнопки на странице товара.

add_filter('woocommerce_product_single_add_to_cart_text', 'wplab_change_add_to_cart_text');
function wplab_change_add_to_cart_text() {
    return 'Купить сейчас';
}

Этот фильтр применяется только к кнопке на странице отдельного товара.

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

• Откройте страницу любого товара.
• Кнопка должна содержать новый текст «Купить сейчас».
• Если не изменилось, проверьте приоритеты и конфликты с другими плагинами.

Частые ошибки при работе с WooCommerce хуками

• Неправильное имя хука — часто встречается из-за устаревшей информации или опечаток. Используйте актуальную документацию и утилиты для поиска.
• Добавление кода в неподходящее место — functions.php дочерней темы предпочтительнее, чем родительской или напрямую в плагинах, чтобы избежать потери изменений при обновлении.
• Конфликты с другими плагинами — отключайте плагины по очереди, чтобы выявить конфликт.
• Отсутствие проверки условий — добавляйте проверки на страницы, где должен сработать код, чтобы избежать ошибок на других страницах.

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

• Минимизируйте количество хук-обработчиков. Чем меньше функций подключено, тем быстрее работает сайт.
• Не загружайте тяжелые операции в хуках, вызываемых часто (например, в циклах). Используйте отложенную обработку.
• Проверяйте права пользователя внутри функций, если код меняет данные или выводит конфиденциальную информацию.
• Используйте nonce и проверки безопасности при обработке запросов через AJAX или формы.

Сравнение способов добавления функционала: хуки vs шаблоны