Пакети, додатки та "часто купують разом"

Три модулі продажів: пакети (bundles), додатки до продукту (add-ons) та “часто купують разом” (FBT). Кожен працює незалежно.

Вимоги

Polski PRO вимагає: Polski (free) v1.3.0+, WordPress 6.4+, WooCommerce 8.0+, PHP 8.1+

Пакети продуктів (bundles)

Модуль пакетів дає змогу створювати конфігуровані набори продуктів зі спільною знижкою. Клієнт купує пакет як один продукт, а окремі складові видні в деталях замовлення.

Налаштування

Перейдіть до WooCommerce > Налаштування > Polski PRO > Пакети та увімкніть модуль (опція polski_bundles).

Параметр	Значення за замовчуванням	Опис
Увімкнути пакети	Ні	Активує функціональність пакетів
Спосіб знижки	Відсоток	percent (відсотковий) або fixed (фіксований)
Знижка за замовчуванням	10%	Знижка, що застосовується до нових пакетів
Відображати економію	Так	Показує суму економії клієнту

Створення пакету

1. Перейдіть до Продукти > Додати новий
2. В секції Дані продукту виберіть тип “Пакет Polski PRO”
3. У вкладці Складові пакету додайте продукти
4. Встановіть кількість кожної складової
5. Налаштуйте знижку (перевизначає стандартну)

Обчислення знижки

Ціна пакету обчислюється автоматично:

Ціна пакету = Сума цін складових - Знижка

Приклад (знижка 15%):
Продукт A: 100 zł x 1 = 100 zł
Продукт B:  50 zł x 2 = 100 zł
Сума:                    200 zł
Знижка (15%):             30 zł
Ціна пакету:             170 zł

Якщо складова пакету в акції, для обчислень використовується акційна ціна.

Шорткод пакету

[polski_bundle product_id="456" show_savings="yes" layout="grid"]

Параметр	Обов’язковий	Опис
product_id	Так	ID продукту-пакету
show_savings	Ні	Відображати суму економії (yes/no)
layout	Ні	Макет: grid, list, compact

Хуки пакетів

/**
 * Filtruje obliczoną cenę pakietu.
 *
 * @param float $bundle_price Obliczona cena pakietu
 * @param array $items        Składniki pakietu z cenami
 * @param float $discount     Wartość rabatu
 */
apply_filters('polski_pro/bundles/price', float $bundle_price, array $items, float $discount): float;

Приклад - мінімальна ціна пакету:

add_filter('polski_pro/bundles/price', function (float $bundle_price, array $items, float $discount): float {
    $minimum_price = 49.99;
    return max($bundle_price, $minimum_price);
}, 10, 3);

/**
 * Akcja wywoływana po dodaniu pakietu do koszyka.
 *
 * @param string $cart_item_key Klucz pozycji w koszyku
 * @param int    $bundle_id    ID produktu-pakietu
 * @param array  $items        Składniki pakietu
 */
do_action('polski_pro/bundles/added_to_cart', string $cart_item_key, int $bundle_id, array $items);

Додатки до продукту (add-ons)

Модуль додатків дає змогу відображати необов’язкові апсел-продукти безпосередньо на сторінці продукту. Клієнт може вибрати додаткові продукти та купити їх одним кліком разом із головним продуктом.

Налаштування

Перейдіть до WooCommerce > Налаштування > Polski PRO > Додатки та увімкніть модуль (опція polski_addons).

Параметр	Значення за замовчуванням	Опис
Увімкнути додатки	Ні	Активує функціональність додатків
Позиція відображення	Після кнопки кошика	Де відобразити секцію додатків
Заголовок секції	”Dodaj do zamówienia”	Текст заголовка над списком додатків
Максимальна кількість	5	Ліміт додатків, що відображаються на продукті

Призначення додатків

Додатки налаштовуються в редагуванні продукту, у вкладці Додатки Polski PRO:

1. Натисніть “Додати додаток”
2. Виберіть продукт із каталогу
3. Встановіть ціну додатку (за замовчуванням ціна продукту)
4. Необов’язково встановіть акційну ціну додатку
5. Визначте порядок відображення

Додатки можуть мати іншу ціну, ніж продукт-джерело - це дає змогу пропонувати спеціальні ціни “разом із продуктом”.

Валідація вибору

Модуль валідує:

• Наявність на складі кожного вибраного додатку
• Правильність цін (чи не були модифіковані на стороні клієнта)
• Кількісні ліміти

Хуки додатків

/**
 * Filtruje listę dodatków dla produktu.
 *
 * @param array       $addons  Tablica dodatków z cenami
 * @param \WC_Product $product Produkt główny
 */
apply_filters('polski_pro/addons/items', array $addons, \WC_Product $product): array;

Приклад - фільтрування додатків на основі ролі користувача:

add_filter('polski_pro/addons/items', function (array $addons, \WC_Product $product): array {
    if (current_user_can('wholesale_customer')) {
        foreach ($addons as &$addon) {
            $addon['price'] = $addon['price'] * 0.8; // 20% гуртової знижки
        }
    }
    return $addons;
}, 10, 2);

Часто купують разом (frequently bought together)

Модуль рекомендацій відображає продукти, що найчастіше купуються разом із переглядуваним продуктом, із можливістю додання кількох продуктів до кошика одним кліком.

Налаштування

Перейдіть до WooCommerce > Налаштування > Polski PRO > Часто купують разом та увімкніть модуль (опція polski_fbt).

Параметр	Значення за замовчуванням	Опис
Увімкнути модуль	Ні	Активує рекомендації
Джерело даних	Ручне	manual (ручне) або auto (на основі замовлень)
Ліміт продуктів	3	Максимальна кількість рекомендованих продуктів
Заголовок секції	”Często kupowane razem”	Текст заголовка секції
Позиція	Під коротким описом	Де відобразити секцію

Ручне призначення

В редагуванні продукту, вкладка Часто купують разом:

1. Знайдіть та додайте пов’язані продукти
2. Встановіть порядок відображення
3. Необов’язково встановіть знижку за покупку разом

Автоматичні рекомендації

Коли джерело даних встановлено на auto, модуль аналізує історію замовлень та визначає продукти, що найчастіше купуються разом. Аналіз запускається раз на день через WP-Cron.

Додавання до кошика

Секція “Часто купують разом” відображає:

• Чекбокси біля кожного рекомендованого продукту
• Мініатюри та назви продуктів
• Ціни окремих продуктів
• Загальну ціну вибраних продуктів
• Кнопку “Додати все до кошика”

Клієнт відмічає вибрані продукти та додає їх одним кліком. Усі продукти потрапляють до кошика як окремі позиції.

Шорткод

[polski_fbt product_id="789" limit="4" show_prices="yes"]

Параметр	Обов’язковий	Опис
product_id	Ні	ID головного продукту (за замовчуванням поточний)
limit	Ні	Максимальна кількість рекомендацій
show_prices	Ні	Відображати ціни (yes/no)

Хуки FBT

/**
 * Filtruje listę rekomendowanych produktów.
 *
 * @param array $product_ids Tablica ID rekomendowanych produktów
 * @param int   $product_id  ID produktu głównego
 * @param string $source     Źródło: 'manual' lub 'auto'
 */
apply_filters('polski_pro/fbt/products', array $product_ids, int $product_id, string $source): array;

Приклад - виключення продуктів із обраної категорії:

add_filter('polski_pro/fbt/products', function (array $product_ids, int $product_id, string $source): array {
    $excluded_category_id = 42;
    return array_filter($product_ids, function (int $id) use ($excluded_category_id): bool {
        return ! has_term($excluded_category_id, 'product_cat', $id);
    });
}, 10, 3);

Взаємодія модулів

Усі три модулі можуть працювати одночасно на одному продукті:

• Пакет із призначеними додатками та секцією часто купують разом
• Складові пакету можуть мати власні додатки
• Рекомендації FBT можуть вказувати на пакети

Порядок відображення на сторінці продукту налаштовується за допомогою пріоритету хуків WooCommerce.

Вирішення проблем

Ціна пакету не оновлюється після зміни цін складових Ціна пакету обчислюється динамічно. Очистіть Object Cache та transients WooCommerce.

Додатки не відображаються на сторінці продукту Перевірте, чи тема підтримує хук woocommerce_after_add_to_cart_button. Деякі нестандартні теми пропускають стандартні хуки WooCommerce.

Автоматичні рекомендації порожні Модуль потребує історичних даних - автоматичні рекомендації з’являються після збору достатньої кількості замовлень. Перевірте, чи завдання WP-Cron polski_pro_fbt_analyze заплановане.

Подальші кроки

• Повідомляйте про проблеми: GitHub Issues
• Пов’язані модулі: Передпродаж, Каталоговий режим

Ця сторінка має виключно інформаційний характер і не є юридичною консультацією. Перед впровадженням зверніться до юриста. Polski for WooCommerce - це програмне забезпечення з відкритим кодом (GPLv2), що надається без гарантій.