Стандартна форма оформлення замовлення WooCommerce не підходить для кожного магазину. Іноді потрібно запитати додатковий телефон, зручний час доставки, ім'я одержувача подарунка або іншу інформацію. Зробити це можна за допомогою PHP-коду без встановлення окремого плагіна.

Коротка відповідь
Щоб додати поле користувача в WooCommerce без плагінів, спочатку визначте тип оформлення замовлення. Для класичної форми використовуйте фільтр woocommerce_checkout_fields та хуки збереження замовлення. Для блокового оформлення Checkout Block використовуйте Additional Checkout Fields API. Після реєстрації поля перевірте його валідацію, збереження, відображення на замовлення та сумісність з HPOS.
Які поля можна додати у WooCommerce
Найчастіше магазини додають додатковий телефон, ідентифікаційний номер компанії, інтервал доставки, інструкції кур'єру, вибір подарункової упаковки або ім'я подарунка. Не варто робити необов'язкову інформацію обов'язковою: довга форма ускладнює покупку.
| Тип | Приклад |
|---|---|
| Текст | Ім'я одержувача подарунку |
| Телефон | Додатковий номер |
| Випадаючий список | Час доставки |
| Прапорець | Подарункова упаковка |
| Дата | Бажана дата доставки |
Спочатку визначте тип оформлення замовлення
Відкрийте у WordPress сторінку оформлення замовлення. Якщо вона містить шорткод [woocommerce_checkout]використовується класична форма. Якщо на сторінці встановлено блок Checkout, використовується блокова форма. Це важливо: фільтр woocommerce_checkout_fields не додає поля до інтерфейсу Checkout Block.
Приклади нижче призначені для розміщення в functions.php активної дочірньої теми. Перед редагуванням створіть резервну копію та перевірте зміни на тестовому сайті. У існуючий файл functions.php не потрібно повторно вставляти тег PHP, що відкриває.
Додавання полів у класичну форму WooCommerce

Додатковий телефон покупця
Наступний код додає необов'язкове поле до групи платіжних даних:
add_filter( 'woocommerce_checkout_fields', 'myshop_add_extra_phone' );
function myshop_add_extra_phone( $fields ) {
$fields['billing']['billing_extra_phone'] = array(
'type' => 'tel',
'label' => 'Дополнительный телефон',
'placeholder' => 'Введите номер телефона',
'required' => false,
'class' => array( 'form-row-wide' ),
'priority' => 115,
);
return $fields;
}
Параметр required визначає обов'язковість, priority порядок виведення, а form-row-wide зазвичай розтягує поле на ширину рядка.
Збереження додаткового телефону на замовлення
Одного виведення поля недостатньо: потрібно зберегти значення. Використовуємо об'єкт замовлення та його API, сумісний із HPOS.
add_action( 'woocommerce_checkout_create_order', 'myshop_save_extra_phone', 10, 2 );
function myshop_save_extra_phone( $order, $data ) {
if ( isset( $_POST['billing_extra_phone'] ) && is_string( $_POST['billing_extra_phone'] ) ) {
$phone = sanitize_text_field( wp_unslash( $_POST['billing_extra_phone'] ) );
$order->update_meta_data( '_billing_extra_phone', $phone );
}
}
Виведення телефону у картці замовлення
add_action( 'woocommerce_admin_order_data_after_billing_address', 'myshop_show_extra_phone' );
function myshop_show_extra_phone( $order ) {
$phone = $order->get_meta( '_billing_extra_phone' );
if ( $phone !== '' ) {
echo '<p><strong>Дополнительный телефон:</strong> ' . esc_html( $phone ) . '</p>';
}
}
Випадаючий список часу доставки
У класичній формі можна додати список часових інтервалів:
add_filter( 'woocommerce_checkout_fields', 'myshop_add_delivery_time' );
function myshop_add_delivery_time( $fields ) {
$fields['billing']['billing_delivery_time'] = array(
'type' => 'select',
'label' => 'Удобное время доставки',
'required' => false,
'class' => array( 'form-row-wide' ),
'priority' => 120,
'options' => array(
'' => 'Выберите время',
'09:00-12:00' => '09:00–12:00',
'12:00-15:00' => '12:00–15:00',
'15:00-18:00' => '15:00–18:00',
),
);
return $fields;
}
add_action( 'woocommerce_checkout_create_order', 'myshop_save_delivery_time', 10, 2 );
function myshop_save_delivery_time( $order, $data ) {
if ( ! isset( $_POST['billing_delivery_time'] ) || ! is_string( $_POST['billing_delivery_time'] ) ) {
return;
}
$value = sanitize_text_field( wp_unslash( $_POST['billing_delivery_time'] ) );
$allowed = array( '09:00-12:00', '12:00-15:00', '15:00-18:00' );
if ( in_array( $value, $allowed, true ) ) {
$order->update_meta_data( '_billing_delivery_time', $value );
}
}
Список дозволених значень перевіряється на сервері: покупець може змінити дані форми через інструменти розробника.
Прапорець «Подарунок»
add_filter( 'woocommerce_checkout_fields', 'myshop_add_gift_wrap' );
function myshop_add_gift_wrap( $fields ) {
$fields['order']['myshop_gift_wrap'] = array(
'type' => 'checkbox',
'label' => 'Добавить подарочную упаковку',
'required' => false,
'priority' => 25,
);
return $fields;
}
add_action( 'woocommerce_checkout_create_order', 'myshop_save_gift_wrap', 10, 2 );
function myshop_save_gift_wrap( $order, $data ) {
$enabled = isset( $_POST['myshop_gift_wrap'] ) && '1' === sanitize_text_field( wp_unslash( $_POST['myshop_gift_wrap'] ) );
$order->update_meta_data( '_myshop_gift_wrap', $enabled ? 'yes' : 'no' );
}
Цей код лише зберігає вибір. Якщо упаковка платна, потрібно окремо додати вартість замовлення.
Поле після приміток до замовлення
Для виведення поля в окремій позиції можна використовувати woocommerce_after_order_notes.
add_action( 'woocommerce_after_order_notes', 'myshop_add_customer_source' );
function myshop_add_customer_source( $checkout ) {
woocommerce_form_field( 'myshop_customer_source', array(
'type' => 'text',
'label' => 'Как вы узнали о магазине?',
'placeholder' => 'Например, Google',
'required' => false,
'class' => array( 'form-row-wide' ),
), $checkout->get_value( 'myshop_customer_source' ) );
}
add_action( 'woocommerce_checkout_create_order', 'myshop_save_customer_source', 10, 2 );
function myshop_save_customer_source( $order, $data ) {
if ( isset( $_POST['myshop_customer_source'] ) && is_string( $_POST['myshop_customer_source'] ) ) {
$value = sanitize_text_field( wp_unslash( $_POST['myshop_customer_source'] ) );
$order->update_meta_data( '_myshop_customer_source', $value );
}
}
Як змінити стандартні поля оформлення замовлення
Зробити компанію необов'язковою
add_filter( 'woocommerce_checkout_fields', 'myshop_optional_company' );
function myshop_optional_company( $fields ) {
if ( isset( $fields['billing']['billing_company'] ) ) {
$fields['billing']['billing_company']['required'] = false;
}
return $fields;
}
Перейменувати коментар до замовлення
add_filter( 'woocommerce_checkout_fields', 'myshop_rename_order_comments' );
function myshop_rename_order_comments( $fields ) {
if ( isset( $fields['order']['order_comments'] ) ) {
$fields['order']['order_comments']['label'] = 'Комментарий для менеджера';
}
return $fields;
}
Змінити порядок полів
add_filter( 'woocommerce_checkout_fields', 'myshop_reorder_checkout' );
function myshop_reorder_checkout( $fields ) {
if ( isset( $fields['billing']['billing_phone'] ) ) {
$fields['billing']['billing_phone']['priority'] = 15;
}
if ( isset( $fields['billing']['billing_email'] ) ) {
$fields['billing']['billing_email']['priority'] = 20;
}
return $fields;
}
Видалити непотрібне поле
add_filter( 'woocommerce_checkout_fields', 'myshop_remove_company' );
function myshop_remove_company( $fields ) {
unset( $fields['billing']['billing_company'] );
return $fields;
}
Важливо: не видаляйте без перевірки країну, індекс або адресу доставки. Ці дані можуть брати участь у розрахунку податків, тарифів доставки та перевірках платіжних систем.
Додавання полів у WooCommerce Checkout Block

Блокове оформлення замовлення використовує окремий механізм. woocommerce_register_additional_checkout_field(). Він дозволяє реєструвати поля в областях contact, address и order. На відміну від класичної форми, збереження зареєстрованих полів обробляється самим API.
Текстове поле "Ім'я одержувача подарунка"
add_action( 'woocommerce_init', 'myshop_register_gift_recipient' );
function myshop_register_gift_recipient() {
if ( ! function_exists( 'woocommerce_register_additional_checkout_field' ) ) {
return;
}
woocommerce_register_additional_checkout_field( array(
'id' => 'myshop/gift-recipient',
'label' => 'Имя получателя подарка',
'location' => 'order',
'type' => 'text',
'required' => false,
) );
}
Ідентифікатор поля повинен включати власний простір імен та унікальну назву, наприклад myshop/gift-recipient.
Список, що випадає в Checkout Block
add_action( 'woocommerce_init', 'myshop_register_customer_source' );
function myshop_register_customer_source() {
if ( ! function_exists( 'woocommerce_register_additional_checkout_field' ) ) {
return;
}
woocommerce_register_additional_checkout_field( array(
'id' => 'myshop/customer-source',
'label' => 'Откуда вы узнали о нас?',
'location' => 'order',
'type' => 'select',
'required' => false,
'options' => array(
array( 'value' => 'google', 'label' => 'Поиск Google' ),
array( 'value' => 'social', 'label' => 'Социальные сети' ),
array( 'value' => 'friends', 'label' => 'Рекомендация знакомых' ),
array( 'value' => 'other', 'label' => 'Другой источник' ),
),
) );
}
Прапорець «Це подарунок»
add_action( 'woocommerce_init', 'myshop_register_is_gift' );
function myshop_register_is_gift() {
if ( ! function_exists( 'woocommerce_register_additional_checkout_field' ) ) {
return;
}
woocommerce_register_additional_checkout_field( array(
'id' => 'myshop/is-gift',
'label' => 'Это подарок',
'location' => 'order',
'type' => 'checkbox',
'required' => false,
) );
}
Читайте також:
5 найкращих плагінів криптовалютних платежів для WooCommerce
Вибір бажаної дати доставки
add_action( 'woocommerce_init', 'myshop_register_delivery_date' );
function myshop_register_delivery_date() {
if ( ! function_exists( 'woocommerce_register_additional_checkout_field' ) ) {
return;
}
woocommerce_register_additional_checkout_field( array(
'id' => 'myshop/delivery-date',
'label' => 'Желаемая дата доставки',
'location' => 'order',
'type' => 'date',
'required' => false,
) );
}
Вибір дати сам не гарантує доступність доставки. Для обмеження вихідних, свят та зайнятих інтервалів буде потрібна додаткова логіка перевірки.
Отримання значення додаткового поля Checkout Block
Для читання даних скористайтеся сервісом CheckoutFields. Наступний фрагмент передбачає, що змінна $order вже містить об'єкт WC_Order.
$checkout_fields = \Automattic\WooCommerce\Blocks\Package::container()->get(
\Automattic\WooCommerce\Blocks\Domain\Services\CheckoutFields::class
);
$value = $checkout_fields->get_field_from_object(
'myshop/gift-recipient',
$order,
'other'
);
Для полів області order використовується група other. Для адресних полів застосовуються відповідні групи billing и shipping. Не слід самостійно припускати формат внутрішніх ключів метаданих блокових полів.
Валідація користувацьких полів
Нові поля потрібно перевіряти на сервері, особливо якщо вони використовуються при доставці, виставленні документів або передачі даних до зовнішніх систем.
Перевірка додаткового телефону у класичній формі
add_action( 'woocommerce_after_checkout_validation', 'myshop_validate_extra_phone', 10, 2 );
function myshop_validate_extra_phone( $data, $errors ) {
if ( empty( $data['billing_extra_phone'] ) ) {
return;
}
$phone = trim( $data['billing_extra_phone'] );
if ( ! preg_match( '/^\+?[0-9\s\-\(\)]{7,25}$/', $phone ) ) {
$errors->add( 'invalid_extra_phone', 'Проверьте дополнительный номер телефона.' );
}
}
Це базова перевірка допустимих символів та довжини, а не підтвердження існування номера. Для Checkout Block застосовуються окремі хуки перевірки Additional Checkout Fields API та обмеження атрибутів, що підтримуються.
Сумісність з HPOS
High-Performance Order Storage (HPOS) використовує спеціалізоване сховище замовлень. Для метаданих користувача безпечніше застосовувати методи об'єкта замовлення, а не безпосередньо викликати update_post_meta().
$order = wc_get_order( $order_id );
if ( $order ) {
$order->update_meta_data( '_myshop_custom_field', $value );
$order->save();
}
Якщо значення зберігається всередині хука woocommerce_checkout_create_order, додатковий виклик save() зазвичай не потрібний: WooCommerce збереже замовлення в рамках оформлення покупки.
Як показати додаткове поле у листі WooCommerce
Наприклад, вибраний інтервал доставки можна вивести в повідомлення про замовлення.
add_action( 'woocommerce_email_after_order_table', 'myshop_email_delivery_time', 10, 4 );
function myshop_email_delivery_time( $order, $sent_to_admin, $plain_text, $email ) {
$time = $order->get_meta( '_billing_delivery_time' );
if ( empty( $time ) ) {
return;
}
if ( $plain_text ) {
echo "\nВремя доставки: " . esc_html( $time ) . "\n";
} else {
echo '<p><strong>Время доставки:</strong> ' . esc_html( $time ) . '</p>';
}
}
Для полів Checkout Block використовуйте відповідний API читання значень, а не метаключ з прикладів для класичної форми.
Часті помилки та способи виправлення
| проблема | Що перевірити |
|---|---|
| Поле не видно | Тип форми: Classic Checkout або Checkout Block |
| Значення не зберігається | Хук збереження та ім'я поля |
| Помилка PHP | Синтаксис, унікальність назв функцій |
| Поле дублюється | Повторне підключення фрагмента |
| Немає даних в адмінці | Правильний метаключ або API читання |
| Проблеми з HPOS | Використання CRUD API WooCommerce |
Контрольний список перед публікацією
- Перевірити форму на комп'ютері та смартфоні.
- Оформити тестове замовлення як гість та як зареєстрований покупець.
- Перевірити обов'язковість та помилки валідації.
- Переконатись, що дані збереглися на замовлення.
- Перевірити відображення в адмінці та листах.
- Перевірити різні способи доставки та оплати.
- Перевірити роботу при увімкненому HPOS.
PHP-код чи плагін: що вибрати?
Для одного-двох простих полів власні PHP-фрагменти дозволяють уникнути додаткового розширення та гнучко контролювати поведінку форми. Але якщо потрібні десятки полів, умовні залежності, складні інтерфейси та інтеграції з CRM, спеціалізований плагін може виявитися зручнішим в обслуговуванні.
Відсутність плагіна не означає відсутності підтримки: після оновлень WooCommerce код користувача необхідно повторно тестувати.
FAQ: питання, що часто ставляться
Додати поля користувача в WooCommerce без плагінів цілком реально. Для класичного оформлення замовлення підходять woocommerce_checkout_fields та хуки збереження замовлення; для Checkout Block - Additional Checkout Fields API. Важливо не тільки вивести нове поле, але й забезпечити перевірку даних, безпечне збереження, сумісність із HPOS та зручність покупців. Починайте з мінімального набору потрібних полів і обов'язково перевіряйте результат на тестовому замовленні.
Джерела
- WooCommerce Developer Documentation — Customising Checkout Fields.
- WooCommerce - Additional Checkout Fields.
- WooCommerce - Additional Checkout Fields Guide.
- WooCommerce - High-Performance Order Storage.
- WordPress Developer Resources - Hooks.
- WordPress Developer Resources — Data Validation.
























Коментарі до запису: 0