Как использовать хуки для изменения отсутствующих пользовательских данных в WooCommerce

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

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

Основные причины проблемы:

• Отсутствие сохранения дополнительных пользовательских данных в мета полях заказа.
• Некорректное добавление данных в форму оформления.
• Пропущенные хуки для сохранения и отображения данных.

Как проверить, что данные отсутствуют

Перейдите в админку WooCommerce → Заказы → откройте заказ и проверьте блок с деталями заказа. Если ваши пользовательские поля не отображаются, значит данные не сохраняются или не выводятся.

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

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

Используем хук woocommerce_after_order_notes для вывода дополнительного поля:

add_action('woocommerce_after_order_notes', 'wpmark_add_custom_checkout_field');
function wpmark_add_custom_checkout_field($checkout) {
    echo '<div id="wpmark_custom_checkout_field">';
    woocommerce_form_field('custom_note', array(
        'type'          => 'textarea',
        'class'         => array('custom-note form-row-wide'),
        'label'         => __('Дополнительное примечание'),
        'placeholder'   => __('Введите дополнительную информацию'),
        ), $checkout->get_value('custom_note'));
    echo '</div>';
}

2. Валидация введенных данных

Добавим проверку, чтобы поле не было пустым, если это необходимо:

add_action('woocommerce_checkout_process', 'wpmark_validate_custom_checkout_field');
function wpmark_validate_custom_checkout_field() {
    if (!$_POST['custom_note'] || trim($_POST['custom_note']) === '') {
        wc_add_notice(__('Пожалуйста, заполните дополнительное примечание.'), 'error');
    }
}

3. Сохранение данных в мета заказа

Используем хук woocommerce_checkout_update_order_meta:

add_action('woocommerce_checkout_update_order_meta', 'wpmark_save_custom_checkout_field');
function wpmark_save_custom_checkout_field($order_id) {
    if (!empty($_POST['custom_note'])) {
        update_post_meta($order_id, '_custom_note', sanitize_textarea_field($_POST['custom_note']));
    }
}

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

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

add_action('woocommerce_admin_order_data_after_billing_address', 'wpmark_display_custom_field_in_admin_order', 10, 1);
function wpmark_display_custom_field_in_admin_order($order){
    $custom_note = get_post_meta($order->get_id(), '_custom_note', true);
    if ($custom_note) {
        echo '<p><strong>Дополнительное примечание:</strong> ' . esc_html($custom_note) . '</p>';
    }
}

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

1. Перейдите на страницу оформления заказа и убедитесь, что поле «Дополнительное примечание» отображается.
2. Попробуйте оформить заказ с заполненным полем и без него (чтобы проверить валидацию).
3. В админке WooCommerce откройте созданный заказ и проверьте отображение дополнительного примечания.

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

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

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

• Всегда используйте функции очистки данных, такие как sanitize_textarea_field, для защиты от XSS и инъекций.
• Обрабатывайте пользовательские данные только после проверки nonce и прав, если добавляете в админке.
• Избегайте избыточных запросов к базе данных — сохраняйте и извлекайте данные только по необходимости.
• При масштабных доработках используйте кеширование мета данных WooCommerce.

Сравнение вариантов реализации