Как использовать хуки WooCommerce для кастомизации поля оплаты

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

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

Как найти нужные хуки для кастомизации поля оплаты

WooCommerce использует хуки (actions и filters) для вставки и обработки полей. Для поля оплаты чаще всего используются хуки, связанные с checkout, например, woocommerce_review_order_before_payment, woocommerce_checkout_fields и woocommerce_checkout_update_order_meta.

Чтобы определить, какой хук подходит, можно:

• Изучить исходники WooCommerce: templates/checkout/payment.php и includes/class-wc-checkout.php.
• Включить отладку с add_action('woocommerce_review_order_before_payment', function() { error_log('Hook fired'); });

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

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

add_filter('woocommerce_checkout_fields', 'wpmarketing_add_custom_payment_field');
function wpmarketing_add_custom_payment_field($fields) {
    $fields['billing']['billing_payment_comment'] = array(
        'type' => 'text',
        'label' => 'Комментарий к оплате',
        'required' => false,
        'class' => array('form-row-wide'),
        'priority' => 25,
    );
    return $fields;
}

2. Сохранение значения поля в мета-данных заказа

add_action('woocommerce_checkout_update_order_meta', 'wpmarketing_save_custom_payment_field');
function wpmarketing_save_custom_payment_field($order_id) {
    if (!empty($_POST['billing_payment_comment'])) {
        update_post_meta($order_id, '_billing_payment_comment', sanitize_text_field($_POST['billing_payment_comment']));
    }
}

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

add_action('woocommerce_admin_order_data_after_billing_address', 'wpmarketing_display_custom_payment_field_admin', 10, 1);
function wpmarketing_display_custom_payment_field_admin($order) {
    $comment = get_post_meta($order->get_id(), '_billing_payment_comment', true);
    if ($comment) {
        echo '<p><strong>Комментарий к оплате:</strong> ' . esc_html($comment) . '</p>';
    }
}

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

• Откройте страницу оформления заказа, проверьте, что появилось новое поле «Комментарий к оплате».
• Заполните поле и оформите заказ.
• В админке WooCommerce откройте заказ, убедитесь, что комментарий отображается в данных биллинга.

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

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

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

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

Сравнение способов добавления поля оплаты в WooCommerce