Для чого призначений модуль
- Більше відгуків про товари. Запрошення надходить клієнту через заданий час після оплати або виконання замовлення й охоплює лише ті товари із замовлення, які клієнт ще не оцінив.
- Причина для наступної покупки. Винагородою за відгук є купон на наступне замовлення — зі строком дії, мінімальною вартістю кошика та нагадуванням перед його завершенням.
- Прозорі відгуки з програми винагород. Відгуки, створені в межах програми, позначаються в тексті, а оцінка не впливає на винагороду, тож клієнт може залишити як позитивну, так і негативну оцінку.
- Контроль і результати в одному місці. Список зібраних відгуків зі статусом модерації та купоном, а також панель статистики, що показує шлях від запрошення до замовлення з купоном.
Найважливіші стандартні налаштування нової кампанії
- Запрошення через 14 днів після переходу замовлення в один із позначених статусів (за замовчуванням: платіж прийнято, віддалений платіж прийнято, підготовка в процесі, відправлено, доставлено).
- Одне нагадування через 7 днів і посилання дійсне 30 днів.
- Винагорода: знижка 10% у режимі «один купон за замовлення», видається після модерації, дійсна 30 днів, з нагадуванням за 3 дні до завершення строку дії.
- Ліміти: 1 винагорода на клієнта і 100 винагород на кампанію.
- Усі строки можна змінити в межах до 365 днів, а ліміти — до 10 000 винагород на клієнта і 1 000 000 на кампанію.
Кампанії запрошень до відгуків
Які замовлення й товари охоплює кампанія
- Товари й категорії. Товари вибираються через пошук (назва або ID), категорії — зі списку; товар підпадає під умови, якщо він є у списку товарів або належить до вибраної категорії. Порожній список означає весь каталог.
- Виключення товарів мають пріоритет над списком товарів і категорій.
- Статуси замовлення. Запрошення отримує дійсне замовлення, поточний статус якого позначено в кампанії на день завершення затримки. Затримка рахується від останнього переходу замовлення в позначений статус.
- Період дії кампанії (від–до), її активність і пріоритет.
- Пріоритет кампанії. Якщо кампанії перетинаються, замовлення потрапляє до першої відповідної кампанії з вільними лімітами за пріоритетом — також тоді, коли її затримка ще триває.
- Уже оцінені товари пропускаються. Запрошення не охоплює товари, які клієнт оцінив раніше в модулі відгуків, а також товари, за які він уже отримав винагороду.
- Гості без згоди на повідомлення не отримують запрошень і не займають місце в лімітах, оскільки не мають облікового запису, у якому могли б їх побачити.
Текст повідомлення
- Назва винагороди й текст повідомлення окремо для кожної мови магазину (до 150 і до 3000 символів, звичайний текст без HTML).
- Умови винагороди (значення, мінімальний кошик, строк дії, поєднання з іншими купонами) додаються до повідомлення та сторінки відгуку автоматично, мовою клієнта.
Купони за відгуки
Види винагород
- Відсоткова знижка — на весь кошик або на список вибраних товарів.
- Фіксована знижка у вибраній валюті — на весь кошик або на один вибраний товар.
- Безкоштовна доставка — як самостійна винагорода або як доповнення до іншої винагороди.
- Товар у подарунок, також у вибраній комбінації. Подарунок має бути активним, доступним для замовлення й наявним на складі (або з дозволеним замовленням за відсутності); інакше видача купона повторюється.
- Мінімальна вартість кошика (брутто, без доставки) і строк дії купона у днях.
За що і коли клієнт отримує купон
- Режим замовлення: один купон за перший відгук із замовлення, що відповідає умовам.
- Режим товару: окремий купон за відгук про кожен товар, охоплений кампанією; кілька одиниць одного й того самого товару не збільшують винагороду.
- Після модерації або після надсилання. За замовчуванням купон створюється лише після схвалення відгуку в модулі відгуків; також можна видавати його одразу після надсилання відгуку.
- Зіркова оцінка не впливає на винагороду.
- Одна винагорода за товар і покупця у магазині — також між кампаніями та наступними замовленнями. Покупця розпізнають за скороченням HMAC адреси електронної пошти.
- Обіцянка без змін. Умови винагороди й місце в ліміті резервуються в момент створення запрошення; подальше редагування кампанії не змінює обіцянки, наданої клієнту.
Купон як правило кошика PrestaShop
- Нативне правило кошика з кодом, прив’язане до клієнта, одноразове й без часткового використання.
- Поєднання з іншими купонами налаштовується в кампанії; за замовчуванням купон за відгук не поєднується з іншими. У PrestaShop 9 заборону перевіряє валідація кошика, а в PrestaShop 1.7 і 8 модуль підтримує нативні зв’язки між правилами кошика (до 100 правил і 2000 пар). Якщо активних купонів магазину більше, купон за відгук усе одно буде видано, а панель попереджає, що заборона поєднання тоді не застосовується.
- Повторення видачі. Невдала видача купона (наприклад, відсутність подарунка на складі) повторюється зі зростаючим інтервалом — від 1 години до доби, максимум 10 разів; пізніше доступна кнопка «Повторити» у списку винагород.
- Повернення й скасування. Повне повернення цього товару або скасування замовлення блокує невикористаний купон. Якщо купон було використано раніше, список винагород показує статус «Купон використано до повернення». Звичайна зміна статусу на наступний етап виконання не скасовує винагороду.
Відгуки й модерація
- Співпраця з IQIT Reviews або Product Comments. У кожному магазині вибирається один із цих модулів; відгук зберігається в ньому, а модуль відгуків його публікує й модерує. Зміна модуля відгуків блокується, доки є незавершені запрошення або винагороди.
- Форма відгуку: оцінка від 1 до 5 зірок, заголовок (від 3 до 64 символів) і текст (від 20 до 5000 символів); у Product Comments також оцінки критеріїв, визначених у цьому модулі. Відгук публікується з іменем клієнта.
- Позначення відгуку. До тексту кожного відгуку, доданого модулем, дописується текст: «Відгук після підтвердженої покупки, доданий у межах програми винагород. Винагорода не залежить від оцінки.» Позначення є частиною тексту відгуку, тому не залежить від теми магазину чи JavaScript.
- Рішення модератора виявляється автоматично. Кожен запуск CRON перевіряє, які відгуки були схвалені або видалені, і видає або скасовує винагороду. Відгук, який ніхто не схвалить протягом 60 днів після строку запрошення, звільняє резервування винагороди.
- Вкладка «Відгуки» в панелі: оцінка, заголовок і текст, товар із посиланням на редагування та на картку в магазині, клієнт і замовлення, статус модерації (опубліковано, очікує модерації, видалено, система відгуків недоступна), кнопка «Модерувати», що веде до відгуку в модулі відгуків, а також купон за відгук.
- Експорт відгуків у CSV з поточними фільтрами й сортуванням — до 50 000 відгуків в одному файлі; потребує права на налаштування модуля, оскільки файл містить адреси електронної пошти клієнтів.
Сторінки й повідомлення для клієнта
Повідомлення електронною поштою
- Чотири типи повідомлень: запрошення до відгуку, одне нагадування, повідомлення з купоном і одне нагадування перед завершенням строку дії купона. Шаблони HTML і текстові польською та англійською мовами.
- Надсилання через налаштування пошти PrestaShop, з лімітом повідомлень на один запуск CRON (від 1 до 50, за замовчуванням 20). Невдале надсилання повторюється зі зростаючим інтервалом, максимум 5 разів; адміністратор може повторити його зі списку.
- Мова повідомлення — це мова клієнта, якщо модуль має для неї шаблон; в інших випадках англійська або польська залежно від активних у магазині мов.
- Відмова в один клік. Кожне повідомлення має посилання для відмови від запрошень і нагадувань; відмова працює також після зміни адреси електронної пошти. Повідомлення з купоном, який уже належить клієнту, залишається транзакційним повідомленням.
Згода на повідомлення
- Джерело згоди на вибір: підписка на newsletter або згода на пропозиції партнерів (поле optin) в обліковому записі клієнта.
- Налаштування «Немає» блокує рекламні повідомлення — тоді запрошення видно лише в обліковому записі клієнта. Згода й дані клієнта перевіряються повторно безпосередньо перед надсиланням.
- Програма й надсилання вмикаються окремо. Установлення, оновлення чи повторне встановлення не запускають надсилання клієнтам.
Сторінка відгуку й обліковий запис клієнта
- Відгук без входу в систему. Посилання з повідомлення підписане й прив’язане до запрошення; під час першого відкриття ключ з адреси переноситься в сесію та видаляється з адреси. Сторінки мають заголовки
noindex,no-storeіno-referrer, а збереження відгуку й відмови потребує токена форми. - Вкладка «Відгуки й винагороди» в обліковому записі клієнта зі списком покупок, охоплених програмою, статусом кожного товару та кнопкою «Переглянути товари, відгуки й купони», яка відкриває сторінку запрошення з формою відгуку та наданими купонами. Плитка працює в темах classic, warehouse та Hummingbird 1 і 2.
- Покупка без облікового запису. Після гостьової покупки клієнт може однією кнопкою створити обліковий запис на адресу електронної пошти із замовлення (пароль він встановлює через повідомлення PrestaShop, надіслане на цю адресу) або прив’язати купон до наявного облікового запису з тією самою адресою.
- Кілька запрошень одночасно. Сесія запам’ятовує ключі п’яти останніх відкритих запрошень, тож клієнт може працювати в кількох вкладках браузера.
Панель статистики
- Період: 7, 30 або 90 днів, 12 місяців, увесь період або власний діапазон дат.
- Лічильники запрошень, надісланих повідомлень, відгуків, відсотка відповідей, виданих купонів і замовлень із купоном — зі зміною відносно попереднього періоду такої самої тривалості.
- Графік активності (надіслані запрошення, нові відгуки, замовлення з купоном) щоденно, щотижнево або щомісячно, з таблицею даних.
- Воронка запрошень: створено → з відгуком → винагороджено купоном → купон використано в замовленні.
- Середня оцінка з розподілом зірок, товари, які оцінюють найчастіше, і таблиця кампаній; зірки й товари ведуть до відфільтрованого списку відгуків, а кампанії — до їх редагування.
- Оборот і вартість знижок замовлень із купоном програми, окремо для кожної валюти.
Панель адміністратора
- Меню Клієнти → Відгуки й винагороди та сторінка налаштування модуля зі смугою вкладок: кампанії, запрошення, відгуки, винагороди, статистика, попередні покупки й налаштування.
- Заголовок зі статусом програми: обробка, надсилання, модуль відгуків, джерело згоди, активні кампанії, останній запуск CRON, а також окремо помилки запрошень і винагород — кожен індикатор веде до місця, де його можна виправити.
- Нативні списки PrestaShop з фільтром у кожній колонці, сортуванням і пагінацією; фільтри запам’ятовуються для працівника окремо для кожного списку й магазину, а над списком видно, які фільтри активні.
- Попередні покупки. Замовлення до встановлення можна охопити програмою: попередній перегляд вибраного діапазону (до 1000 замовлень, дійсний 30 хвилин) показує кількість замовлень, що відповідають умовам, а запрошення створюються після запуску завдання.
- Права доступу PrestaShop. Працівник лише з правом перегляду не змінить налаштування чи кампанії; токен CRON і експорт відгуків доступні лише працівникам із правом налаштування модуля.
Завдання CRON
- Запуск кожні 5 хвилин. CRON визначає замовлення, що відповідають умовам, надсилає повідомлення, видає купони та перевіряє повернення й рішення модератора.
- Два способи виклику: звичайна адреса з токеном (
…/module/pdproductreviewspro/cron?pdpr_token=…) — для вставлення в панелі хостингу, яка викликає адресу (наприклад, ISPConfig, cPanel, сервіси webcron) — або готові командиcurlіwget, які передають токен методом POST, поза адресою. - Окрема адреса й токен для кожного магазину. Одночасні запуски блокуються, а обробка відбувається порціями в межах часу одного виклику.
- Зміни замовлень обробляються одразу. Зміна статусу, повернення або новий відгук спрямовують запрошення на перевірку під час найближчого запуску CRON.
Безпека, GDPR і дані
- GDPR. Модуль підтримує експорт і видалення даних клієнта через стандартні механізми PrestaShop (також після прив’язки гостьової покупки до облікового запису) і при цьому вимикає його купони програми.
- Вимкнення модуля призупиняє невикористані купони без поєднання, умови яких залежать від модуля; повторне ввімкнення відновлює лише купони, призупинені таким способом. Купони, вимкнені вручну, модуль не вмикає.
- Видалення модуля зберігає дані програми (кампанії, запрошення, винагороди й історію), щоб повторне встановлення не винагороджувало вдруге за той самий товар; програма й надсилання при цьому залишаються вимкненими.
- Вимоги до бази даних: таблиці програми, відгуків і купонів мають використовувати рушій InnoDB (транзакції); модуль перевіряє це перед записом.
Multistore, мови й інтеграції
- Multistore. Кампанії, налаштування, модуль відгуків, згода, токен CRON і статистика є окремими для кожного магазину. Магазин, доданий пізніше, отримує власні секрети, а програма в ньому стартує вимкненою.
- Польські й англійські переклади в обох системах перекладів PrestaShop (словник модуля й каталоги XLF). У мовах без перекладу сторінки клієнта показують тексти модуля англійською, доки їх не буде перекладено.
- Фід відгуків Google. Модуль фіда відгуків
pdgoogleproductsreviewfeedproвід версії 1.0.2 позначає відгуки з програми у файлі XML Google Product Reviews як відгуки після підтвердженої покупки (is_verified_purchase) і відгуки зі стимулюванням (is_incentivized_review). Фід є окремим модулем.
Сумісність і встановлення
- PrestaShop 1.7.0–9.x і PHP 7.0–8.5 (заявлена сумісність). Установлення, сторінки панелі, списки, експорт і деінсталяція перевіряються автоматично на PrestaShop 1.7.2.4 (PHP 7.0), 1.7.8.10 (PHP 7.4), 8.0.0, 8.2.6 і 9.0.2, а повні сценарії від замовлення до використання купона — на PrestaShop 9.1.5.
- Без зовнішніх бібліотек і без Composer.
- Оновлення з будь-якої попередньої версії модуля через Менеджер модулів; скрипти оновлення доповнюють таблиці, індекси й hook-и.
Важливі межі роботи
- Модуль працює виключно з модулями відгуків IQIT Reviews і Product Comments. Він не відображає відгуки на картці товару й не має власної модерації — відображення та модерація належать вибраному модулю відгуків.
- Для роботи потрібне завдання CRON, яке регулярно запускається на сервері або в панелі хостингу.
- Запрошення електронною поштою надсилаються лише клієнтам із вибраною згодою (newsletter або пропозиції партнерів); решта бачать запрошення лише в обліковому записі клієнта.
- Замовлення до встановлення модуля не охоплюються автоматично — для цього призначений інструмент «Попередні покупки».
- Підтвердження надсилання означає прийняття повідомлення поштою магазину, а не його доставку до скриньки одержувача.
- Статистика прив’язує замовлення до використаного купона програми; вона не вимірює приріст продажів або маржу.
- У PrestaShop 1.7 і 8 заборона поєднання купона за відгук з іншими купонами застосовується до 100 активних правил кошика і 2000 пар; понад цей поріг купон усе одно видається, але може поєднуватися з іншими.
- Текст відгуку зберігає модуль відгуків, і саме він відповідає за його відображення та видалення. Правила публікації відгуків у магазині встановлює продавець.