Verified Delivery Reviews для OpenCart — відгуки лише після отримання посилки

Verified Delivery Reviews для OpenCart — модуль, який просить відгук у покупця тоді, коли той уже тримає товар у руках. На маркетплейсах відгук про продавця можна залишити одразу після оформлення, ще до отримання, — і продавці місяцями оскаржують оцінки за скасовані замовлення. На власному сайті можна інакше: питати лише тих, хто посилку забрав, і показувати це біля відгуку.

Модуль стежить за статусом ТТН, який уже зберігають наші модулі доставки для OpenCart — Нова Пошта, Укрпошта, Meest і ROZETKA Delivery, — і коли посилку отримано, через кілька днів надсилає один лист на замовлення з п’ятьма зірками під кожним товаром. Клік по зірці відкриває коротку форму без акаунта, відгук потрапляє у штатний Каталог → Відгуки, а на сторінці товару має позначку «Покупець отримав товар · Нова Пошта». Замовлення без ТТН — самовивіз, кур’єр — ідуть за статусом «Виконано».

Магазин на WordPress? Є та сама логіка для WooCommerce — Verified Delivery Reviews для WooCommerce.

Як це виглядає для покупця

• Один лист, коли посилка вже вдома. За замовчуванням — через 3 дні після отримання, щоб покупець встиг спробувати товар; уночі (з 21:00 до 9:00 за Києвом) нічого не надсилається.
• Зірки прямо в листі. Під кожним товаром п’ять зірок: клік відкриває форму з уже вибраною оцінкою. Лист іде через поштові налаштування вашого магазину і мовою замовлення.
• Форма без акаунта. Особисте посилання, дійсне 60 днів: зірки, кілька слів про товар і ім’я для сайту. Текст можна не писати — достатньо оцінки (або зробіть текст обов’язковим).
• «Не просити в мене відгуків». Посилання в кожному листі; відписка — кнопкою на сторінці, тож поштові сканери, що відкривають посилання, нікого не відписують.

Відгук — звичайний відгук OpenCart: він з’являється в Каталог → Відгуки, де ви його схвалюєте, як завжди. Модуль додає біля нього зелену позначку «Покупець отримав товар» і, якщо хочете, службу доставки. В OpenCart 4 рейтинг товару перераховується одразу після схвалення. Якщо в магазині увімкнено сповіщення про нові відгуки, вам прийде лист.

Що отримує адмін

Розширення → Розширення → Модулі → Verified Delivery Reviews. Сім вкладок: «Звіт», «Коли просити», «Повідомлення», «Форма і позначка», «Запити», «Розклад», «Ліцензія».

• Тригер. «Статус ТТН, замовлення без ТТН — за статусом замовлення» (за замовчуванням), «лише статус ТТН» або «лише статус замовлення». Служби доставки вмикаються галочками, поруч видно, чи знайдено їхній модуль.
• Статуси «отримано». Поки ви нічого не обрали, модуль бере зі списку «виконаних» статусів магазину лише «Виконано» — без «Відправлено», бо відправлену посилку ще не отримали. «Відправлено» варто додавати, лише якщо ТТН відстежують наші модулі перевізників.
• Час і антиспам. Затримка після отримання, тихі години й часовий пояс, пауза на покупця, пропуск уже оцінених товарів, мінімальна сума замовлення, скільки днів діє посилання, скільки запитів за один запуск.
• Форма й позначка. Модерація всіх, автопублікація 4–5 зірок або всіх; обов’язковий текст; власний текст позначки й служба доставки в ній.
• Тестовий лист собі. Вкажіть свою адресу й мову — прийде приклад листа лише вам, покупцям нічого не йде.

Панель у картці замовлення. Де зараз запит (заплановано, надіслано, є відгук, пропущено й чому), кнопки «Покупець отримав — запланувати» і «Надіслати зараз», а для Укрпошти — поле трек-номера. Вкладка «Запити» показує всі запити з пошуком за номером замовлення.

Звіт. Отримано посилок, надіслано запитів, відкрили форму, залишили відгук, середня оцінка — за джерелом (Нова Пошта, Meest, ROZETKA Delivery, Укрпошта, статус замовлення, підтвердив менеджер) і з причинами, чому запит не пішов: покупець відписався, посилку не отримано, покупця вже питали, замовлення скасоване.

Pro: Viber, SMS, Telegram, фото й власні тексти

• Viber / SMS через TurboSMS. Ваш акаунт turbosms.ua і ваші погоджені імена відправників: спершу Viber, якщо на номері немає Viber — SMS (або лише Viber, або лише SMS). Кнопка «Перевірити з’єднання і баланс». Повідомлення оплачуються TurboSMS за його тарифами.
• Telegram. Бот від @BotFather підключається кнопкою «Підключити бота» (потрібен HTTPS). На сторінці успішного замовлення покупець натискає «Отримати в Telegram» — запит прийде в чат із кнопкою «Залишити відгук». Команда /stop або блокування бота — відписка. Бот не пише тим, хто його не запускав: так працює Telegram.
• Фото у відгуках. Ліміт кількості й розміру налаштовується; JPEG, PNG, WebP перевіряються за вмістом файлу, а не лише за розширенням. Галерея з’являється під відгуком після схвалення.
• Власні тексти. Тема, заголовок і текст листа, тексти Viber/SMS і Telegram зі змінними {customer_name}, {store_name}, {order_number}, {carrier}, {ttn}, {review_link}. Порожнє поле — вбудований текст мовою замовлення.
• Звіт. Періоди 7/30/90/365 днів, розбивка за каналами (e-mail, Viber/SMS, Telegram) і CSV без e-mail і телефонів покупців.

Як це працює — крок за кроком

1. На кожному запуску модуль дивиться на свіжі замовлення: чи отримано посилку за ТТН нашого модуля доставки, чи замовлення отримало статус «отримано», чи менеджер натиснув «Покупець отримав».
2. Отримання підтверджено — замовлення отримує запит із датою надсилання: затримка після отримання, тихі години. Відмова, повернення чи скасування — запит пропускається з причиною.
3. Перед надсиланням модуль ще раз перевіряє: замовлення не скасоване, покупець не відписався і його не питали останні 30 днів, у замовленні лишились неоцінені товари.
4. Лист (у Pro — ще Viber/SMS і Telegram) іде мовою замовлення. Один запит на замовлення гарантує унікальний запис у базі, а блокування запуску не дає двом крон-запускам надіслати дубль.
5. Покупець відкриває форму за особистим посиланням, ставить зірки й пише відгук — він зберігається у штатну таблицю відгуків OpenCart зі зв’язком на замовлення й службу доставки.
6. Ви модеруєте як завжди: Каталог → Відгуки. Після схвалення — позначка «Покупець отримав товар» на сторінці товару.

Що під капотом

• Лише читання. Модуль читає таблиці наших модулів доставки і нічого в них не змінює. Для майбутніх модулів є подія cc_shipment_delivered (order_id, carrier, ttn, delivered_at).
• Одна бібліотека на три збірки. Логіка спільна для OpenCart 4, 3 і 2.3 і написана під PHP 7.0+; екран налаштувань, панель замовлення, форма й лист мають власні стилі й однаково виглядають на Bootstrap 5 і 3.
• Один запит на замовлення — унікальний ключ у власній таблиці й атомарне «взяття» запиту перед надсиланням; запуски не накладаються завдяки блокуванню MySQL.
• Приватність. Посилання — випадковий токен, у базі лише його хеш. E-mail і телефон для паузи й відписки зберігаються тільки як хеші.
• Звичайні відгуки. Відгуки пишуться у штатну таблицю відгуків OpenCart, позначка додається подією до списку відгуків товару. Видалите модуль — відгуки лишаються в Каталог → Відгуки.
• Видалення. Деінсталяція знімає події, завдання крону й таблиці модуля (галочка «Зберегти дані» лишає відписки й журнал). Підключений Telegram-бот при деінсталяції відключається.

Як встановити

1. OpenCart 4: Розширення → Інсталятор → завантажте cc_vdreviews.ocmod.zip (ім’я архіву не змінюйте) і натисніть «Встановити». OpenCart 3: Розширення → Інсталятор → cc_vdreviews-oc3.ocmod.zip. OpenCart 2.3: залийте вміст папки upload/ з cc_vdreviews-oc2.ocmod.zip у корінь магазину (FTP або файловий менеджер хостингу).
2. Розширення → Розширення → Модулі → Verified Delivery Reviews → «Встановити», потім «Редагувати».
3. Вкладка «Коли просити»: увімкніть статус, перевірте тригер, служби доставки й статус «отримано», збережіть.
4. Вкладка «Повідомлення»: «Надіслати тестовий лист» на свою адресу — побачите, що отримає покупець.
5. Вкладка «Розклад»: додайте cron-адресу в crontab хостингу (або покладіться на запуск з адмінки).
6. Для Pro: вкладка «Ліцензія» — ключ із листа після оплати або 7-денний тріал.