WooCommerce: автоматическое добавление метаданных к товарам через код

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

В стандартном WooCommerce управление метаданными товаров происходит вручную через админку или импорт CSV. Но в ряде случаев требуется программно добавлять или обновлять метаданные при создании или обновлении товара — например, для интеграции с внешними сервисами, SEO или кастомной логики отображения.

Частые симптомы, указывающие на необходимость автоматизации:

• Требуется назначать уникальные идентификаторы (не SKU) для интеграции с CRM.
• Необходимо динамически добавлять информацию по складу или производителю.
• Автоматическое заполнение SEO-полей для каждого товара.

Пошаговое решение: добавление и обновление метаданных товаров через хуки WooCommerce

1. Хук для автоматического добавления метаданных при создании товара

Используйте хук save_post_product — он вызывается при создании и обновлении товара.

add_action('save_post_product', 'wpai_add_custom_meta_to_product', 10, 3);
function wpai_add_custom_meta_to_product($post_ID, $post, $update) {
    // Проверяем, что это не авто-сохранение
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
        return;
    }

    // Проверяем права пользователя
    if (!current_user_can('edit_post', $post_ID)) {
        return;
    }

    // Пример: добавление мета-ключа 'custom_code' с уникальным значением
    if (!$update) { // если создается новый товар
        $custom_code = 'CC-' . $post_ID . '-' . wp_generate_password(4, false, false);
        update_post_meta($post_ID, 'custom_code', $custom_code);
    }
}

2. Обновление метаданных при изменении товара

Если нужно менять метаданные при каждом обновлении, уберите проверку !$update и добавьте логику обновления.

add_action('save_post_product', 'wpai_update_custom_meta_on_update', 20, 3);
function wpai_update_custom_meta_on_update($post_ID, $post, $update) {
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
        return;
    }
    if (!current_user_can('edit_post', $post_ID)) {
        return;
    }

    if ($update) {
        $meta_value = get_post_meta($post_ID, 'custom_code', true);
        if (!$meta_value) {
            $meta_value = 'CC-' . $post_ID . '-' . wp_generate_password(4, false, false);
            update_post_meta($post_ID, 'custom_code', $meta_value);
        }
    }
}

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

Чтобы проверить работу, создайте новый товар через админку WooCommerce и откройте его редактирование. В разделе «Произвольные поля» (если не отображается — включите в настройках экрана) найдите ключ custom_code с уникальным значением.

Альтернативно, выполните запрос к базе или добавьте временный вывод значения в шаблон:

echo get_post_meta(get_the_ID(), 'custom_code', true);

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

• Хук не срабатывает: убедитесь, что используете именно save_post_product — для товаров это правильный хук. Не путайте с save_post.
• Дублирование метаданных: добавляйте проверку на существование мета-значения перед обновлением, чтобы не создавать дубли.
• Проблемы с правами: всегда проверяйте current_user_can('edit_post', $post_ID), иначе код может не выполняться.
• Авто-сохранение: проверка DOING_AUTOSAVE обязательна, иначе метаданные будут обновляться при каждом авто-сохранении.

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

• Не храните чувствительные данные в метаданных без шифрования.
• Избегайте тяжелых операций (запросы к API, сложные вычисления) внутри хуков save_post_product, чтобы не замедлять сохранение товара.
• Для массового обновления метаданных используйте WP CLI или специально написанные скрипты с пакетной обработкой.

Сравнение вариантов добавления метаданных к товарам