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

Диагностика задачи: зачем кастомизировать данные продуктов WooCommerce

В стандартном WooCommerce атрибуты и метаданные продуктов ограничены базовой функциональностью. Часто требуется изменить данные продуктов динамически — например, менять цену, отображение атрибутов на странице товара или добавлять свои метаполя в процессе загрузки. Без понимания фильтров WooCommerce это сделать сложно.

Основная проблема: стандартные хуки не всегда очевидны, а попытки изменить данные через действия могут привести к нежелательным побочным эффектам или конфликтам с плагинами.

Основные фильтры для работы с данными продуктов WooCommerce

WooCommerce предоставляет несколько ключевых фильтров для изменения данных продуктов до их вывода или сохранения. Рассмотрим самые полезные из них:

• woocommerce_product_get_price — изменяет цену продукта до отображения
• woocommerce_product_get_regular_price — изменяет базовую цену без скидок
• woocommerce_product_get_sale_price — изменяет цену скидки
• woocommerce_product_get_attribute — позволяет изменить атрибут продукта при его получении
• woocommerce_product_get_description — фильтрует описание продукта

Например, чтобы динамически изменить цену всех продуктов, можно использовать фильтр woocommerce_product_get_price.

Пример: динамическое снижение цены на 10% для всех продуктов

add_filter('woocommerce_product_get_price', 'custom_discount_price', 10, 2);
function custom_discount_price( $price, $product ) {
    $discount = 0.9; // 10% скидка
    $new_price = $price * $discount;
    return round( $new_price, 2 );
}

Кастомизация атрибутов продуктов через фильтр

Атрибуты часто используются для фильтров и вариаций. Для изменения значений атрибутов динамически можно применить фильтр woocommerce_product_get_attribute. Он срабатывает при вызове метода $product->get_attribute().

Пример: добавление префикса к значению атрибута "цвет"

add_filter('woocommerce_product_get_attribute', 'custom_modify_color_attribute', 10, 3);
function custom_modify_color_attribute( $value, $attribute_name, $product ) {
    if ( strtolower($attribute_name) === 'цвет' ) {
        return 'Префикс - ' . $value;
    }
    return $value;
}

Пошаговое решение: как добавить и изменить атрибуты и метаданные продукта динамически

1. Определить, какой именно атрибут или метаполе надо изменить или добавить.
2. Выбрать соответствующий фильтр или хук WooCommerce для изменения этого значения.
3. Добавить код в файл functions.php активной темы или в собственный плагин.
4. Проверить, что фильтр корректно применился без ошибок.

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

add_action( 'woocommerce_process_product_meta', 'save_custom_product_meta', 10, 2 );
function save_custom_product_meta( $post_id, $post ) {
    if ( isset( $_POST['_custom_meta'] ) ) {
        update_post_meta( $post_id, '_custom_meta', sanitize_text_field( $_POST['_custom_meta'] ) );
    }
}

Добавьте соответствующее поле на странице редактирования продукта для ввода значения _custom_meta.

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

• Очистите кеш сайта и браузера, если используете кеширующие плагины.
• Откройте страницу продукта и проверьте, что цена/атрибуты изменились согласно вашей логике.
• Используйте инструменты разработчика, чтобы отследить вывод значения атрибутов и цены.
• Для проверки метаданных — используйте плагин Advanced Custom Fields или Query Monitor, либо сделайте запрос к базе данных:

SELECT meta_key, meta_value FROM wp_postmeta WHERE post_id = YOUR_PRODUCT_ID AND meta_key = '_custom_meta';

Частые ошибки при кастомизации данных WooCommerce и как их исправить

• Фильтр не срабатывает: проверьте приоритет хука и количество аргументов, передаваемых в функцию.
• Изменения не видны: очистите кеш, убедитесь, что фильтр добавлен в активной теме/плагине.
• Неправильный ключ атрибута: используйте точное имя атрибута, учитывая регистр и локализацию.
• Конфликты с другими плагинами: проверяйте, не переопределяют ли другие плагины эти фильтры.

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

• Не делайте тяжелых запросов внутри фильтров, которые вызываются часто (например, при получении цены).
• Используйте sanitize_text_field и другие функции очистки данных при сохранении пользовательских метаполей.
• Если меняете цену, учитывайте налоги и возможные скидки WooCommerce, чтобы не нарушить логику магазина.
• Для сложных изменений лучше использовать собственный плагин, а не functions.php, чтобы облегчить поддержку.

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