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

Диагностика задачи: зачем изменять информацию о заказах в WooCommerce

В WooCommerce часто возникает необходимость кастомизировать данные заказов — добавить новые поля, изменить отображение информации в админке или на странице "Мои заказы" у пользователя. Использование хуков — наиболее чистый и рекомендуемый способ для таких изменений без правки исходных файлов плагина.

Основные хуки для изменения информации о заказах

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

• add_action — для добавления дополнительного функционала в определённые места;
• add_filter — для изменения данных перед выводом или сохранением;
• Специфичные хуки для заказов, например woocommerce_admin_order_data_after_billing_address (отображение в админке), woocommerce_order_get_items (фильтрация позиций заказа), woocommerce_email_order_meta (дополнительные данные в письмах).

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

Чтобы добавить пользовательское поле в заказ и отобразить его в админке, используем следующий код:

add_action('woocommerce_admin_order_data_after_billing_address', 'add_custom_field_to_admin_order', 10, 1);
function add_custom_field_to_admin_order($order){
    echo '<p><strong>Номер клиента:</strong> ' . esc_html( get_post_meta( $order->get_id(), '_client_number', true ) ) . '</p>';
}

// Сохраняем поле при сохранении заказа
add_action('woocommerce_process_shop_order_meta', 'save_custom_field_order');
function save_custom_field_order($order_id){
    if (isset($_POST['_client_number'])) {
        update_post_meta($order_id, '_client_number', sanitize_text_field($_POST['_client_number']));
    }
}

Этот код выводит в админке заказов дополнительное поле "Номер клиента" и сохраняет его при редактировании.

Пример: изменение данных товаров в заказе перед выводом

Иногда нужно изменить информацию о товарах в заказе, например, добавить метку к названию товара на странице "Мои заказы":

add_filter('woocommerce_order_item_name', 'append_custom_label_to_order_item', 10, 3);
function append_custom_label_to_order_item($item_name, $item, $is_visible) {
    $product = $item->get_product();
    if ($product && $product->is_on_sale()) {
        $item_name .= ' <span style="color: red;">(Акция)</span>';
    }
    return $item_name;
}

Пошаговое решение: как добавить и отобразить пользовательское поле в заказе

1. Определите место, где хотите отображать новое поле (админка, email, фронтенд).
2. Добавьте вывод поля с помощью add_action или add_filter.
3. Обеспечьте сохранение данных через соответствующий хук, например woocommerce_process_shop_order_meta.
4. Проверьте корректность отображения и сохранения на практике.

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

• Откройте заказ в админке WooCommerce — новое поле должно отображаться там.
• Измените значение поля и сохраните заказ — убедитесь, что данные сохранились.
• Посмотрите страницу "Мои заказы" на сайте — если меняли отображение, то изменения должны быть видны.

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

• Поле не отображается в админке: проверьте приоритеты хуков и правильность названия функции.
• Данные не сохраняются: убедитесь, что поле присутствует в форме и правильно обрабатывается в $_POST.
• Проблемы с безопасностью: всегда используйте sanitize_text_field или другие функции очистки входных данных.
• Конфликты с другими плагинами: проверяйте, нет ли переопределений хуков, используйте уникальные имена функций.

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

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

Сравнение способов добавления пользовательских данных в заказ

Метод	Преимущества	Недостатки	Когда использовать
Хуки WooCommerce (add_action, add_filter)	Чистая интеграция, совместимость с обновлениями, гибкость	Требует навыков PHP, может быть сложно для новичков	При необходимости кастомизации отображения и логики
Плагины для пользовательских полей	Простота, готовые интерфейсы	Может влиять на производительность, ограничения по кастомизации	Если нужна быстрая настройка без кода
Изменения шаблонов темы	Полный контроль над выводом	Обновления темы могут стирать изменения, сложность поддержки	Для мелких визуальных изменений