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

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

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

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

Диагностика: как понять, что метаданные необходимы для решения задачи

Если в вашем магазине нужно:

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

то использование метаданных — правильное решение.

Как проверить наличие и структуру метаданных

Для просмотра всех метаданных товара можно использовать следующий код в файле темы или плагина:

add_action('woocommerce_single_product_summary', function() {
    global $product;
    $meta = get_post_meta($product->get_id());
    echo '<pre>' . print_r($meta, true) . '</pre>';
}, 25);

Это выведет массив всех метаданных для текущего товара. Там будет видно, какие ключи и значения уже используются.

Пошаговое добавление и использование метаданных в WooCommerce

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

Используем хук woocommerce_product_options_general_product_data для добавления поля:

add_action('woocommerce_product_options_general_product_data', function() {
    woocommerce_wp_text_input([
        'id' => '_custom_product_code',
        'label' => __('Код производителя', 'woocommerce'),
        'desc_tip' => true,
        'description' => __('Введите код производителя для интеграций.', 'woocommerce'),
    ]);
});

2. Сохранение значения метаполя

add_action('woocommerce_process_product_meta', function($post_id) {
    $custom_code = isset($_POST['_custom_product_code']) ? sanitize_text_field($_POST['_custom_product_code']) : '';
    update_post_meta($post_id, '_custom_product_code', $custom_code);
});

3. Использование метаданных в выводе на фронтенде

Допустим, нужно вывести код производителя на странице товара:

add_action('woocommerce_single_product_summary', function() {
    global $product;
    $code = get_post_meta($product->get_id(), '_custom_product_code', true);
    if ($code) {
        echo '<p><strong>Код производителя:</strong> ' . esc_html($code) . '</p>';
    }
}, 20);

4. Использование метаданных в логике скидок

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

add_action('woocommerce_cart_calculate_fees', function($cart) {
    if (is_admin() && !defined('DOING_AJAX')) return;
    foreach ($cart->get_cart() as $cart_item) {
        $product_id = $cart_item['product_id'];
        $code = get_post_meta($product_id, '_custom_product_code', true);
        if ($code === 'SPECIAL123') {
            $discount = $cart_item['line_total'] * 0.1;
            $cart->add_fee('Скидка по коду производителя', -$discount);
        }
    }
});

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

• В админке товара должно появиться новое поле и сохраняться после обновления.
• При выводе товара на сайте должен отображаться ваш метаданные (например, код производителя).
• Если реализована логика скидок, то в корзине должна автоматически появляться скидка на товары с нужным кодом.
• Можно проверить метаданные напрямую через базу данных в таблице wp_postmeta или с помощью плагина типа Adminer или WP phpMyAdmin.

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

• Метаданные не сохраняются — проверьте, что woocommerce_process_product_meta правильно подключен, а данные из $_POST доступны и корректно фильтруются.
• Метаданные не выводятся на фронтенде — убедитесь, что используете правильный хук для вывода (например, woocommerce_single_product_summary) и что ключ метаданных совпадает.
• Функция скидок не работает — проверьте, что хук woocommerce_cart_calculate_fees не вызывается в админке и что условия в коде правильно распознают метаданные.
• Формат данных в метаданных — используйте правильные функции для сериализации (если массивы) и экранирования при выводе.

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

• Всегда фильтруйте и валидируйте данные, получаемые через $_POST, чтобы избежать XSS и инъекций.
• Используйте префиксы для своих метаданных (например, _custom_product_code), чтобы избежать конфликтов с плагинами.
• Для массового импорта метаданных используйте WP CLI или специализированные плагины, чтобы не перегружать сайт.
• Кэшируйте результаты частых вызовов get_post_meta при сложных расчетах скидок для ускорения работы корзины.

Сравнение способов реализации хранения дополнительной информации о товарах