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

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

WooCommerce построен на системе хуков (actions и filters), которые позволяют гибко изменять и расширять функциональность оформления заказа без правки исходного кода плагина. Это обеспечивает устойчивость к обновлениям и упрощает поддержку сайта.

Диагностика: когда и зачем изменять процесс оформления заказа

Частые задачи, требующие вмешательства через хуки:

• Добавление или удаление полей в форме оформления заказа
• Валидация пользовательских данных
• Изменение сообщений об ошибках или успешном оформлении
• Автоматическое заполнение полей на основе пользовательских данных
• Изменение поведения после размещения заказа (редиректы, уведомления)

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

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

• woocommerce_checkout_fields — фильтр для изменения полей формы
• woocommerce_after_checkout_validation — action для дополнительной валидации
• woocommerce_checkout_update_order_meta — action для сохранения дополнительных данных в мета заказа
• woocommerce_thankyou — action, вызываемый после оформления заказа, для вывода кастомного контента
• woocommerce_checkout_process — action для валидации перед сохранением заказа

Пошаговое решение: добавление и валидация нового поля «Номер телефона для связи»

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

add_filter('woocommerce_checkout_fields', 'wpdo_add_custom_checkout_field');
function wpdo_add_custom_checkout_field($fields) {
    $fields['billing']['billing_contact_phone'] = array(
        'type'        => 'text',
        'label'       => 'Номер телефона для связи',
        'required'    => true,
        'class'       => array('form-row-wide'),
        'priority'    => 120,
        'placeholder' => 'Введите номер телефона',
    );
    return $fields;
}

2. Добавляем валидацию поля

add_action('woocommerce_checkout_process', 'wpdo_validate_custom_checkout_field');
function wpdo_validate_custom_checkout_field() {
    if (empty($_POST['billing_contact_phone'])) {
        wc_add_notice(__('Пожалуйста, введите номер телефона для связи.'), 'error');
    } elseif (!preg_match('/^\+?\d{10,15}$/', $_POST['billing_contact_phone'])) {
        wc_add_notice(__('Введите корректный номер телефона.'), 'error');
    }
}

3. Сохраняем поле в мета заказа

add_action('woocommerce_checkout_update_order_meta', 'wpdo_save_custom_checkout_field');
function wpdo_save_custom_checkout_field($order_id) {
    if (!empty($_POST['billing_contact_phone'])) {
        update_post_meta($order_id, '_billing_contact_phone', sanitize_text_field($_POST['billing_contact_phone']));
    }
}

4. Отображаем поле в админке заказа

add_action('woocommerce_admin_order_data_after_billing_address', 'wpdo_display_custom_field_in_admin_order', 10, 1);
function wpdo_display_custom_field_in_admin_order($order){
    $phone = get_post_meta($order->get_id(), '_billing_contact_phone', true);
    if ($phone) {
        echo '<p><strong>Номер телефона для связи:</strong> ' . esc_html($phone) . '</p>';
    }
}

Проверка корректности работы

1. Откройте страницу оформления заказа, убедитесь, что появилось новое поле «Номер телефона для связи» и оно обязательное.
2. Попробуйте оформить заказ с пустым или некорректным номером — должно появиться сообщение об ошибке.
3. После успешного оформления заказа зайдите в админку WooCommerce — в деталях заказа должно отображаться сохранённое значение.

Частые ошибки при работе с хуками оформления заказа

• Неправильный приоритет фильтра: иногда поле не отображается, если приоритет установлен слишком низким или слишком высоким. Используйте диапазон 10-120 для полей.
• Отсутствие проверки данных: без валидации пользователь может отправить некорректные данные, что приведёт к ошибкам в заказах.
• Неиспользование функций санитизации: обязательно используйте sanitize_text_field() или аналогичные функции для сохранения данных.
• Попытка изменить поля напрямую в шаблонах: это ломает обновляемость WooCommerce, всегда используйте хуки.

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

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

Сравнение способов добавления поля в оформление заказа