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

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

Мета-записи (post meta) — это дополнительные пользовательские данные, которые хранятся в базе данных WordPress вместе с основными данными записи (поста, товара и т.п.). В WooCommerce мета-записи широко используются для хранения информации о товарах, заказах, клиентах и других сущностях. Правильное использование мета-записей позволяет автоматизировать процессы, например, менять статус заказа, добавлять теги, запускать сторонние интеграции и т.д.

Где хранятся мета-записи в базе данных

Мета-записи хранятся в таблице wp_postmeta. Каждая запись связана с конкретным товаром или заказом через post_id. Для заказов тип записи — shop_order, для товаров — product.

Диагностика: как проверить, какие мета-записи есть у товара или заказа

Чтобы узнать, какие мета-записи есть у конкретного товара или заказа, можно использовать несколько способов:

• Через phpMyAdmin выполнить запрос:
  

  SELECT meta_key, meta_value FROM wp_postmeta WHERE post_id = ID_ТОВАРА_ИЛИ_ЗАКАЗА;

• Использовать плагин Show Post Meta, который выводит все мета-данные записи в админке.
• Добавить временный отладочный код в functions.php:
  

  add_action('admin_notices', function() {
      global $post;
      if (!$post) return;
      $meta = get_post_meta($post->ID);
      echo '<pre>' . print_r($meta, true) . '</pre>';
  });

Пошаговое решение: автоматическое изменение статуса заказа при изменении мета-записи

Задача: при добавлении или изменении определённой мета-записи у заказа автоматически менять его статус на «выполнен».

1. Подключаем хук для отслеживания обновления мета-записи

add_action('updated_post_meta', 'auto_change_order_status_on_meta', 10, 4);
add_action('added_post_meta', 'auto_change_order_status_on_meta', 10, 4);

function auto_change_order_status_on_meta($meta_id, $post_id, $meta_key, $meta_value) {
    // Проверяем, что это заказ WooCommerce
    $post = get_post($post_id);
    if (!$post || $post->post_type !== 'shop_order') {
        return;
    }

    // Название нужной мета-записи
    $target_meta_key = '_custom_order_flag';

    if ($meta_key === $target_meta_key && $meta_value === 'yes') {
        $order = wc_get_order($post_id);
        if ($order && $order->get_status() !== 'completed') {
            $order->update_status('completed', 'Автоматическое изменение статуса при установке флага.');
        }
    }
}

2. Добавляем мета-запись вручную для теста

В админке или через код можно добавить мета-запись:

update_post_meta($order_id, '_custom_order_flag', 'yes');

После этого статус заказа должен автоматически поменяться на «выполнен».

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

Чтобы убедиться, что скрипт работает корректно:

1. Создайте тестовый заказ в WooCommerce.
2. Добавьте мета-запись _custom_order_flag со значением yes через консоль или админку.
3. Обновите страницу заказа и проверьте, что статус изменился на «выполнен».
4. Проверьте логи WooCommerce или debug.log на наличие уведомления из update_status.

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

• Хук не срабатывает. Проверьте, что подключены оба хука added_post_meta и updated_post_meta. Иногда мета-записи обновляются без вызова этих хуков (например, через прямой SQL-запрос), тогда код не сработает.
• Заказ не найден. Убедитесь, что $post->post_type === 'shop_order'. Иногда ID указывает на другой тип записи.
• Неправильное имя мета-записи. Проверьте, что используете корректное имя мета-ключа. Ошибка в регистре или опечатка приведут к игнорированию события.
• Статус не меняется. Убедитесь, что статус доступен для установки. Например, нельзя переключить заказ из статуса «выполнен» обратно в «обработка» без дополнительного кода.

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

• Не используйте тяжелые запросы внутри хуков мета-данных. Для более сложных операций лучше ставить задачи на выполнение через WP-Cron.
• Проверяйте права пользователя, если мета-запись меняется из фронтенда. Добавляйте проверки nonce и capability.
• Если автоматизация зависит от большого объема заказов, используйте кеширование и ограничения, чтобы не перегружать сервер.

Сравнение способов автоматизации с помощью мета-записей