Підписка з підтвердженням (Double Opt-In) для OpenCart

Штатний OpenCart вважає згодою саму галочку. Покупець поставив «Підписатися на новини» під час реєстрації — і в базі одразу зʼявляється customer.newsletter = 1. Ні підтвердження, ні дати, ні сліду, звідки та згода взялася. Адресу, яку хтось вписав у чужу форму реєстрації, зі списку вже не прибрати, а довести, що людина справді погоджувалась, нічим.

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

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

У підвалі (або там, де ви поставите форму) — поле e-mail, за бажанням поле імені й кнопка. Після відправки людина одразу бачить: «Майже готово — перевірте пошту і перейдіть за посиланням у листі. До того ми нічого вам не надсилатимемо».

У листі одна дія — посилання підтвердження. Після кліку відкривається сторінка магазину у вашій темі (використовується штатний шаблон common/success, тож вигляд успадковується від теми) з текстом «Підписку підтверджено». Слідом приходить короткий вітальний лист, у якому вже є посилання на відписку в один клік.

Якщо людина вводить адресу, яка вже підтверджена, вона бачить «Ця адреса вже підписана» — і жодного зайвого листа не отримує. Це навмисно: інакше будь-хто міг би засипати чужу скриньку «підтвердженнями», просто вводячи її у форму.

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

Окремий грід підписників у налаштуваннях модуля: адреса, імʼя, стан (очікує / підтверджено / відписаний / помилка), джерело (форма, кабінет, адмінка, імпорт), мова, IP, дата заявки і дата підтвердження. Фільтри за станом, джерелом, адресою і періодом.

Кнопка «Надіслати ще раз» для тих, хто не підтвердив. Експорт CSV усіх підтверджених адрес — разом із доказом згоди (джерело, IP, обидві дати), у UTF-8 з BOM, щоб Excel не перетворив українські імена на кракозябри.

Лічильники по кожному стану на видноті, щоб було видно реальний розмір списку, а не «скільки колись поставили галочку».

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

1. Людина залишає адресу — у формі модуля або штатною галочкою при реєстрації чи в кабінеті.
2. Створюється рядок у власній таблиці зі станом «очікує», токеном, IP, user-agent, мовою та джерелом. Якщо галочку поставили у штатній формі, модуль опускає customer.newsletter назад у 0 — доки згоди нема, її нема і в базі.
3. Іде лист із підтвердженням мовою тієї версії сайту, з якої прийшла заявка.
4. Перехід за посиланням переводить рядок у «підтверджено», ставить дату і піднімає штатний прапорець customer.newsletter, щоб решта магазину бачила ту саму картину.
5. Через задану кількість годин тим, хто не підтвердив, іде рівно одне нагадування. Рядок позначається як «нагадано» незалежно від того, чи лист дійшов, — щоб мертва адреса не крутилася в циклі.
6. Непідтверджені заявки, старші за N днів, видаляються самі. Адреса, яка не підтвердила, — не підписник, і тримати її вічно немає підстав.

Відписка працює в один клік із будь-якого листа: перехід за посиланням переводить рядок у «відписаний», опускає штатний прапорець і (за бажанням) надсилає коротке підтвердження, щоб у людини лишався письмовий доказ.

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

Одна власна таблиця cc_news_subscriber: рядок на пару (магазин, адреса), зі станом, токеном і доказом згоди. Унікальний ключ по парі не дає задвоєнь, а повторна заявка від тієї самої адреси оживляє той самий рядок із новим токеном — тож посилання зі старого листа перестає діяти.

Токен — 48 шістнадцяткових символів із random_bytes. Один і той самий токен обслуговує і підтвердження, і відписку: після підтвердження він навмисно не змінюється, бо саме на ньому їде посилання «відписатися» в усіх майбутніх листах.

Захист форми — прихований honeypot поза потоком документа й поза табуляцією, плюс підписаний штамп часу (HMAC від параметрів інсталяції), який не переписати з боку клієнта. Штамп живий добу, тож форма переживає повне кешування сторінки. Додатково — ліміт заявок з однієї IP за годину і, за бажанням, штатна капча магазину.

Тексти листів живуть у бібліотеці, а не в мовних файлах: лист складається з трьох різних контекстів (вітрина, адмінка, запуск за розкладом), і мова листа — це мова підписника, а не мова поточного запиту. Порожнє поле шаблону завжди відкочується на вбудований текст, невідома мова — на англійську.

Модуль не чіпає жодного файлу ядра: працює через штатні події OpenCart і власні маршрути вітрини.

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

1. Розширення → Встановлення розширень → завантажити zip.
2. Розширення → Модулі → знайти «Підписка з підтвердженням (Double Opt-In)» → натиснути «+». На цьому кроці створюється таблиця й реєструються події та завдання за розкладом.
3. Відкрити налаштування, увімкнути модуль і зберегти.
4. Вставити форму в потрібне місце теми: {{ cc_newsletter }} у будь-якому Twig-шаблоні.
5. Якщо в магазині вже є підписники зі штатною галочкою — натиснути «Імпортувати наявних підписників». Імпорт виконується один раз і тільки вручну: він заводить їх як підтверджених, бо магазин уже вважає їх підписниками, і ніколи не повертає тих, хто відписався.