Реферальна програма Baza Booking Calendar

Реферальна програма дає учасникам змогу залучати нових клієнтів за персональним посиланням і отримувати бонуси за відповідні бронювання. Функція доступна в плані Pro за ліцензійним ключем referral-programme.

Що це і для кого

Учасник поширює посилання https://site.com/?bbc_ref=<code>. Коли відвідувач переходить за ним і створює бронювання, що відповідає умовам, бонус отримує учасник програми.

• Відсоток: частка від урахованої суми замовлення.
• Фіксована сума: задана сума за відповідне бронювання.
• Один раз: лише за перше замовлення кожного залученого клієнта.
• Щоразу: за кожне відповідне замовлення цього клієнта.

Приклад: за бонусу 5% та врахованої суми замовлення 200 учасник отримає 10.

[скриншот: опис реферальної програми в кабінеті учасника]

Увімкнення та налаштування

Перейдіть до Baza Booking → General Settings → Referral → Settings.

• Enable the referral programme. За замовчуванням: вимкнено. Після вимкнення рядки й метадані зберігаються, але посилання, cookies, бонуси та вкладка кабінету не працюють.
• Bonus type і Bonus value. За замовчуванням: відсоток і 5%. Можна вибрати відсоток або фіксовану суму.
• When the bonus is paid. За замовчуванням: один раз за перше замовлення кожного залученого клієнта. Інший режим нараховує бонус за кожне відповідне замовлення.
• Minimum order for a bonus. За замовчуванням: 100. Замовлення з меншою сумою не дає бонусу.
• Count only the slots of the order. За замовчуванням: увімкнено. Увімкнена опція використовує booking_price без додаткових послуг і доплат. Вимкнена використовує повну суму з baza_bc_get_booking_total().
• Minimum payout. За замовчуванням: 100. Запит виплати недоступний, доки баланс не досягне цієї суми.
• Bonus lifetime. За замовчуванням: 0, тобто бонус не згорає. Укажіть кількість днів, щоб обмежити строк.
• Fields of the application. У документації зазначено email, телефон та ім’я.
• Approve applications automatically. За замовчуванням: вимкнено. Інакше адміністратор перевіряє заявки в Members.
• Approve payout requests automatically. За замовчуванням: вимкнено. Інакше адміністратор перевіряє запити виплат.
• Tell members about every bonus. За замовчуванням: увімкнено. Учасник може вимкнути листи у своєму кабінеті.

Приклад: якщо слоти коштують 100, а додаткові послуги 50, увімкнена опція врахує 100, а вимкнена 150.

[скриншот: Referral Settings з усіма полями]

Шлях учасника

• Відкрийте вкладку Membership у кабінеті.
• Користувач, який ще не є учасником, бачить опис програми й форму заявки.
• Після схвалення учасник отримує персональне посилання та кнопку Copy.
• Перехід за дійсним посиланням установлює cookie bbc_ref на 30 днів.
• Бронювання зберігає учасника в bbc_referrer_id.
• Коли бронювання отримує статус booked або completed, плагін перевіряє умови й нараховує бонус.
• Щоденна подія списує бонуси, строк дії яких завершився.

Cookie не встановлюється для адміністратора, менеджера чи учасника, в адміністративній частині, під час AJAX-запиту або за посиланням неактивного учасника. Учасник не отримує бонус за власне бронювання.

Приклад: клієнт переходить за посиланням, бронює протягом 30 днів, а після підтвердження замовлення учасник отримує бонус.

[скриншот: Membership із посиланням, балансом та історією]

Генератор кнопки

Натисніть “Generate a button”, налаштуйте текст, кольори, рамку, радіус кутів і розмір. Скопіюйте створений код і вставте його там, де кнопка має з’явитися на сайті.

Приклад: введіть “Book here”, налаштуйте оформлення та вставте код у HTML-блок.

[скриншот: генератор кнопки та готовий код]

Виплата бонусу

Учасник бачить доступний бонус, форму виплати та історію. Запит стає доступним після досягнення Minimum payout.

• pending: очікує рішення.
• approved: схвалено.
• rejected: відхилено.

Під час виплати спочатку списуються найстаріші нарахування.

Приклад: за мінімальної виплати 100 і доступного балансу 120 учасник може подати запит.

[скриншот: форма виплати та історія операцій]

Адміністрування

Розділ Referral містить вкладки Settings, Members і Payouts.

• Members: схвалення або відхилення заявок, блокування, розблокування та видалення учасника з програми.
• Payouts: схвалення або відхилення запитів виплат.

Заблокований учасник може створювати звичайні бронювання, але не отримує нових бонусів. Це не чорний список клієнтів.

Приклад: перевірте заявку в Members і натисніть “Approve” або “Reject”.

[скриншот: керування Members і Payouts]

Часті запитання

Чому бонус не нараховано?

Програма й план мають бути активними, учасник має бути активним і незаблокованим, бронювання має належати рефереру, але не самому учаснику, бути підтвердженим зі статусом booked або completed, не мати попереднього бонусу, відповідати режиму once або each і мінімальній сумі. Урахована сума та бонус після фільтра мають бути більшими за нуль.

Приклад: у режимі once друге замовлення того самого залученого клієнта не створює нового бонусу.

Що відбувається після блокування?

Учасник не отримує нових бонусів, але може бронювати як звичайний клієнт.

Що відбувається після вимкнення програми?

Збережені дані залишаються, але посилання, cookies, бонуси, вкладка кабінету та інші дії програми зупиняються. Видалення плагіна видаляє налаштування, реферальні дані й щоденну подію.

Що бачать адміністратори й менеджери?

Адміністратор керує налаштуваннями, учасниками, заявками й виплатами. Для адміністратора та менеджера реферальний cookie не встановлюється.

[скриншот: заблокований учасник і вимкнена програма]

Для розробників

• baza_bc_referral_calculate: запускає розрахунок бонусу.
• baza_bc_referral_accrue: додає суму на баланс і створює рядок журналу.
• baza_bc_referral_deduct: списує бонус під час завершення строку або виплати через baza_bc_referral_deduct( $user, $amount, 'expire'|'payout', $ref ).
• baza_bc_referral_amount: фільтрує розрахований бонус.
• baza_bc_referral_cookie_days: фільтрує стандартний 30-денний строк cookie.

Таблиці: {prefix}bbc_referral_ledger, {prefix}bbc_referral_balance і {prefix}bbc_referral_payouts. Метадані користувача: bbc_is_member, bbc_member_url, bbc_member_blocked, bbc_member_application і bbc_member_notify_off. Метадані бронювання: bbc_referrer_id.

Внутрішній ключ плану: referral_programme. Ліцензійний ключ: referral-programme. Модуль modules/referral не входить до безкоштовної та WordPress.org збірок.

Приклад: використайте baza_bc_referral_cookie_days, щоб змінити стандартний строк cookie.

[скриншот: реферальний хук у власному плагіні]