← Повернутись до блогу Розробка

Як додати довільне поле на сторінку товару у 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 );

Ще в рубриці Розробка

Коментарі

Поки що тихо. Можеш бути першим.

З'явиться на сторінці після перевірки.

2018–2025 (c) Списуй але не один в один