Подписка с подтверждением (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. Если в магазине уже есть подписчики со штатной галочкой — нажать «Импортировать существующих подписчиков». Импорт выполняется один раз и только вручную: он заводит их как подтверждённых, потому что магазин уже считает их подписчиками, и никогда не возвращает тех, кто отписался.