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

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

Часто при доработке интернет-магазина на WooCommerce возникает необходимость добавить или изменить функционал без редактирования исходного кода плагина или темы. Изменения напрямую в ядре WooCommerce приведут к проблемам при обновлениях. Ключевым инструментом для расширения функционала служат хуки — actions и filters. Они позволяют внедрять собственный PHP-код в нужные места.

Проверяем, что WooCommerce активен и хуки доступны

Для начала убедитесь, что плагин WooCommerce активен. Добавьте в functions.php вашей дочерней темы следующий код:

if ( ! class_exists( 'WooCommerce' ) ) {
    error_log( 'WooCommerce не активен' );
} else {
    error_log( 'WooCommerce работает' );
}

В логах сервера или через плагин Debug Bar проверьте сообщение. Если WooCommerce не активен, хуки работать не будут.

Пошаговое решение: добавление пользовательских функций через хуки

1. Добавление текста на страницу корзины с помощью action hook

Допустим, нужно вывести рекламное сообщение ниже списка товаров в корзине. Для этого используем хук woocommerce_cart_contents или woocommerce_after_cart_table. Добавьте в functions.php:

add_action( 'woocommerce_after_cart_table', 'custom_cart_message' );
function custom_cart_message() {
    echo '<p style="color:green; font-weight:bold;">Не забудьте проверить наличие купонов!</p>';
}

2. Изменение цены товара на лету с помощью фильтра

Если нужно динамически изменить цену продукта на странице товара, используйте фильтр woocommerce_product_get_price:

add_filter( 'woocommerce_product_get_price', 'custom_dynamic_price', 10, 2 );
function custom_dynamic_price( $price, $product ) {
    // Например, скидка 10% для товаров из категории 'sale'
    if ( has_term( 'sale', 'product_cat', $product->get_id() ) ) {
        $price = $price * 0.9;
    }
    return $price;
}

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

• Для сообщения в корзине: откройте страницу корзины, текст должен отображаться под списком товаров.
• Для изменения цены: проверьте страницу товара из категории «sale», цена должна быть на 10% ниже, чем в админке.
• Для отладки используйте error_log или плагин Query Monitor, чтобы убедиться, что функции выполняются.

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

• Неправильный приоритет в хуках — если функция не срабатывает, попробуйте изменить третий параметр в add_action или add_filter (например, с 10 на 20), чтобы изменить порядок выполнения.
• Отсутствие проверки класса WooCommerce — вызов функций WooCommerce без проверки может привести к фатальной ошибке. Всегда проверяйте class_exists('WooCommerce').
• Вызов хуков в неподходящем месте — убедитесь, что вы используете хуки, соответствующие нужному экрану (страница товара, корзина, оформление заказа и т.д.).
• Кэширование — если изменения не видны, очистите кэш плагинов и браузера.

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

• Не вставляйте необработанные данные в вывод — всегда используйте функции экранирования, например esc_html() или esc_attr().
• Старайтесь не перегружать хуки тяжелыми вычислениями и запросами, чтобы не замедлять загрузку страниц.
• Используйте is_admin() для ограничения выполнения кода только на фронтенде, если это уместно.
• Для сложных изменений лучше создавать собственный плагин, а не добавлять код в functions.php.

Сравнение подходов: плагин vs код в functions.php vs дочерняя тема