← Повернутись до блогу Розробка
Як додати довільне поле на сторінку товару у WooCommerce
Anatolii Koziura автор блогу
30 жовтня 2018 // 4 хвилини на читання // 20 переглядів
У цій інструкції я покажу, як можна додати довільне поле і вивести його на сторінці товару в WooCommerce. Ми додамо просте текстове поле, за аналогією з цими прикладами ви зможете створювати «складні» картки товарів з будь-якою кількістю користувацьких полів на будь-який смак, наприклад, надати користувачеві можливість заповнити дату доставки товару, ввести текст на подарунковій упаковці і навіть прикріпити свій файл.
Мета статті — показати, як можна вивести довільні поля за допомогою написання коду. Якщо ви дуже зайнята або лінива людина, яка шукає простіше і швидше рішення, можете купити плагін WooCommerce Product Add-ons, який додає можливість виведення полів.
Почнемо ми з додавання текстового поля на сторінку товару, потім — виведемо значення з поля на сторінці кошика, оформлення замовлення.
Весь код, який представлений у прикладах нижче, працюватиме у файлі functions.php активної теми, але фактично ми пишемо функціональність, тому краще створити окремий плагін для цього!
Крок 1: Додавання текстового поля і вивід на сторінці товару
Тут ми додамо і виведемо текстове поле. Технічно поле можна додавати в будь-якому місці на сторінці товару у фронтенді, я використовуватиму хук woocommerce_after_add_to_cart_button. Він є стандартним, тому я майже впевнений, що у вашому шаблоні він теж є.
Нічого незвичайного тут немає, ми просто виводимо html-код з текстовим полем. Запам’ятайте атрибут name поля. Далі він буде використовуватися часто.
/*
* Покаже текстове поле на сторінці товару
* @return html
*/
function ctrlv_custom_text(){
$value = isset( $_POST['_custom_text'] ) ? sanitize_text_field( $_POST['_custom_text'] ) : '';
printf( '<label>%s</label><input name="_custom_text" value="%s" />', __( 'Введіть довільний текст сюди', 'ctrlv-plugin-textdomain' ), esc_attr( $value ) );
}
add_action( 'woocommerce_before_add_to_cart_button', 'ctrlv_custom_text', 10 );
Крок 2: Перевірка даних у текстовому полі
Якщо поле має бути обов’язковим для заповнення, можна виконати його варіацію за допомогою коду з прикладу нижче. Якщо поле не обов’язкове для заповнення — або може мати значення за замовчуванням (про це нижче) — можна пропустити цей крок.
/*
* Перевірка даних при кліку на "додати в кошик"
* @param bool $passed
* @param int $product_id
* @param int $quantity
* @return bool
*/
function ctrlv_add_to_cart_validation($passed, $product_id, $qty){
if( isset( $_POST['_custom_text'] ) && sanitize_text_field( $_POST['_custom_text'] ) == '' ){
$product = wc_get_product( $product_id );
wc_add_notice( sprintf( __( '%s не може бути додано в кошик, поки не буде заповнено значення довільного поля.', 'ctrlv-plugin-textdomain' ), $product->get_title() ), 'error' );
return false;
}
return $passed;
}
add_filter( 'woocommerce_add_to_cart_validation', 'ctrlv_add_to_cart_validation', 10, 3 );
Крок 3: Збереження значення довільного поля в кошику
Як ці дані зберігаються в кошику? На цьому етапі починається найбільше магії. WooCommerce зберігає дані про кошик у масиві $_SESSION. Там зберігаються дані про ID товарів і кілька інших важливих речей. Наше завдання — покласти туди свої дані, щоб надалі їх можна було обробити. У цьому нам допоможе такий фільтр:
/*
* Додасть довільні дані з поля до запису товару в кошику
* @param array $cart_item
* @param int $product_id
* @return array
*/
function ctrlv_add_cart_item_data( $cart_item, $product_id ){
if( isset( $_POST['_custom_text'] ) ) {
$cart_item['custom_text'] = sanitize_text_field( $_POST['_custom_text'] );
} else {
$cart_item['custom_text'] = "Значення поля за замовчуванням можна задати тут";
}
return $cart_item;
}
add_filter( 'woocommerce_add_cart_item_data', 'ctrlv_add_cart_item_data', 10, 2 );
Крок 4: Завантаження даних у кошик
Якщо ви знаєте, як скатувати «авада-кедавра», цей крок буде дуже простим. Я зависав на півгодини, перш ніж натрапив на статтю зарубіжного блогера, яку я зараз і перекладаю. Дані, які ми зберегли на попередньому кроці, зберігаються в $_SESSION, і при завантаженні сторінки їх потрібно відновити, тобто при кожному завантаженні сторінки Woo відновлює дані з кошика на основі сесій. Зробити це можна за допомогою фільтра woocommerce_get_cart_item_from_session.
/*
* Завантажить дані кошика з сесії
* @param array $cart_item
* @param array $other_data
* @return array
*/
function ctrlv_get_cart_item_from_session( $cart_item, $values ) {
if ( isset( $values['custom_text'] ) ){
$cart_item['custom_text'] = $values['custom_text'];
}
return $cart_item;
}
add_filter( 'woocommerce_get_cart_item_from_session', 'ctrlv_get_cart_item_from_session', 20, 2 );
Крок 5: Збереження даних з поля в замовленні
Для того, щоб обробляти користувацькі дані — нам слід їх зберегти в поточному замовленні. У цьому допоможе хук woocommerce_add_order_item_metа
php
/*
* Збереже дані довільного поля в замовленні
* @param int $item_id
* @param array $values
* @return void
*/
function ctrlv_add_order_item_meta( $item_id, $values ) {
if ( ! empty( $values['custom_text'] ) ) {
woocommerce_add_order_item_meta( $item_id, 'custom_text', $values['custom_text'] );
}
}
add_action( 'woocommerce_add_order_item_meta', 'ctrlv_add_order_item_meta', 10, 2 );
Крок 6: Вивід довільного поля на сайті
Фінальний етап нашої роботи. Ми прописали логіку, яка збереже дані всюди, куди можна, але не написали логіку для виведення цих даних. А їх можна використовувати… Цей код додасть вивід на всіх сторінках, де виводиться лістинг з товарами в кошику.
/*
* Отримаємо дані про довільне поле для їх подальшого показу
* @param array $other_data
* @param array $cart_item
* @return array
*/
function ctrlv_get_item_data( $other_data, $cart_item ) {
if ( isset( $cart_item['custom_text'] ) ){
$other_data[] = array(
'name' => __( 'Ваш довільний текст', 'ctrlv-plugin-textdomain' ),
'value' => sanitize_text_field( $cart_item['custom_text'] )
);
}
return $other_data;
}
add_filter( 'woocommerce_get_item_data', 'ctrlv_get_item_data', 10, 2 );
Коментарі
Поки що тихо. Можеш бути першим.