GamiPress Conditional Emails - WordPress Plugin

Руководство по настройке GamiPress Conditional Emails для продуманных писем по достижениям

GamiPress Conditional Emails нужен не для обычной рассылки и не для замены почтового сервиса. Его задача точнее: отправить пользователю письмо в тот момент, когда в GamiPress произошло важное событие - достигнут баланс баллов, разблокировано достижение, закрыт тип достижений или получен ранг. В этом руководстве разберём, как превратить такие события в аккуратные письма, как не засыпать пользователя повторными уведомлениями и как проверить, что письмо действительно ушло.

Материал рассчитан на владельца WordPress-сайта, методиста онлайн-школы, администратора сообщества, менеджера магазина с системой лояльности и разработчика, который поддерживает GamiPress на рабочем проекте. Мы пойдём от подготовки и установки к настройке шаблонов, условий, лимитов отправки, тестового письма, реального сценария и диагностике. Общую рекламу продукта повторять не будем - она уже есть выше на странице.

Главная идея проста: письмо должно быть следствием конкретного игрового события, а не случайным приветствием. Поэтому каждый пример ниже связан с цепочкой: пользователь выполняет действие, GamiPress фиксирует баллы, достижение или ранг, Conditional Emails выбирает подходящее условие, подставляет теги и отправляет сообщение через почтовую систему WordPress.

Какую задачу решают условные письма в системе наград

В стандартной геймификации письмо часто воспринимается как побочный эффект: пользователь получил награду, сайт отправил уведомление, на этом всё закончилось. Conditional Emails делает этот слой управляемым. Администратор сам задаёт, какое событие станет поводом для письма, какой текст увидит пользователь, какие динамические данные попадут в тему и тело письма, сколько раз письмо может отправиться всего и сколько раз одному пользователю.

Официальная документация описывает отдельный экран GamiPress > Conditional Emails, где хранятся условные письма, и экран редактирования, где настраиваются блоки Email Configuration, Condition Configuration и Details. Это важно: продукт не создаёт визуальный блок на сайте и не добавляет публичную форму. Он работает в админ-панели и в почтовом канале WordPress.

Практический смысл появляется в проектах, где награды не должны оставаться невидимыми. Например, студент закрыл все задания раздела, участник сообщества набрал нужный баланс баллов, покупатель перешёл на новый уровень лояльности, автор получил значок за активность. В каждом случае письмо может объяснить, что произошло, что делать дальше и где посмотреть результат на сайте.

Хорошее условное письмо не просто поздравляет. Оно связывает событие с дальнейшим действием: перейти к следующему уроку, открыть страницу бонусов, проверить профиль, использовать накопленные баллы, посмотреть новый ранг или вернуться в личный кабинет. Именно поэтому настройку стоит начинать не с текста письма, а с вопроса: какое поведение пользователя вы хотите поддержать после события?

Чем Conditional Emails отличается от обычных email-настроек GamiPress

В GamiPress есть общие настройки писем на вкладке GamiPress > Settings > Emails: шаблон, логотип, имя отправителя, адрес отправителя и текст подвала. Эти параметры влияют на общий внешний вид и отправителя писем GamiPress. Conditional Emails находится уровнем выше по логике сценария: он решает, когда отправлять отдельное письмо и какой условный контент подставлять.

Если вам нужно изменить базовый шаблон всех писем, логичнее начать с общих email-настроек. Если нужно отправить отдельное письмо только при достижении конкретного баланса или ранга, нужен Conditional Emails. Если нужно назначить другие шаблоны для разных типов наград, стоит дополнительно смотреть GamiPress Emails By Type. Если нужно отправлять письма администраторам, ближе будет GamiPress Admin Emails или бесплатный add-on Conditional Emails Recipients, если он подходит к вашей задаче.

Где продукт особенно полезен

Условные письма особенно хорошо работают там, где награда сама по себе не объясняет следующий шаг. Пользователь может увидеть значок в профиле, но не понять, что он открыл новый модуль, получил доступ к скидке или приблизился к следующему уровню. Письмо закрывает этот разрыв: оно переводит внутреннее событие GamiPress в понятное действие.

• В онлайн-школе письмо может подсказать, что после получения достижения стоит перейти к следующему блоку курса.
• В сообществе письмо может поздравить с новым рангом и объяснить, какие возможности он символизирует.
• В магазине с баллами письмо может напомнить о накопленном балансе и направить пользователя на страницу бонусов.
• В контентном проекте письмо может отметить серию действий: комментарии, публикации, прохождение заданий или участие в обсуждениях.

Не стоит использовать условные письма как массовую рассылку по всей базе. Продукт силён в точечных событиях GamiPress, где письмо связано с личным прогрессом пользователя.

Кому подходит плагин и когда он может быть лишним

GamiPress Conditional Emails полезен тем, кто уже построил в GamiPress понятную систему баллов, достижений или рангов. Если на сайте нет рабочих наград, продукт будет нечему реагировать. Поэтому его лучше рассматривать не как первый шаг геймификации, а как слой коммуникации поверх уже настроенных правил.

Подходящие проекты

Лучшие кандидаты - сайты, где прогресс пользователя имеет ценность и должен быть замечен. Это могут быть образовательные платформы, закрытые сообщества, клубы лояльности, сайты с челленджами, каталоги авторов, игровые механики для магазина, внутренние порталы и проекты на базе BuddyPress, BuddyBoss, LearnDash, LifterLMS, WooCommerce или других интеграций GamiPress. Сам Conditional Emails не заменяет эти интеграции, но может отправлять письма по событиям, которые GamiPress уже получает.

Плагин также подходит редакторам, которые не хотят писать код для каждого письма. В официальной документации подтверждены поля темы, содержимого, условий, статуса, даты, общего лимита отправки и лимита на пользователя. Этого достаточно для большого числа практических сценариев без доработки темы или плагина.

Когда стоит выбрать другой путь

Продукт может быть лишним, если вам нужно строить длинные маркетинговые цепочки, сегментировать подписчиков по множеству внешних признаков, вести статистику открытий и кликов, отправлять регулярные дайджесты или управлять согласиями на рассылку как в полноценной email-платформе. Для таких задач лучше использовать сервис рассылок, CRM или автоматизатор, а Conditional Emails оставить для событий GamiPress.

Он также не решит проблему плохой доставляемости писем. Если WordPress не отправляет почту, письма попадают в спам или адрес отправителя не совпадает с доменом, сначала нужно настроить нормальный SMTP-плагин или почтовый сервис. Conditional Emails формирует письмо и инициирует отправку через механизм WordPress, но репутация домена, SPF, DKIM, DMARC и ограничения хостинга остаются вашей зоной ответственности.

Что проверить перед установкой и включением

Перед установкой условных писем важно убедиться, что базовая система GamiPress работает предсказуемо. Письмо будет корректным только тогда, когда корректно срабатывает само событие. Если баллы начисляются случайно, достижение выдаётся не тому пользователю или ранг обновляется вручную без понятного правила, письмо лишь усилит путаницу.

Базовые зависимости

Сначала проверьте, что установлен и активен основной GamiPress. На странице WordPress.org для GamiPress описаны три ключевые сущности: points, achievements и ranks, а также встроенные блоки, шорткоды, виджеты, журнал и email-настройки. Conditional Emails строится поверх этих сущностей, поэтому без них сценарий не имеет опоры.

Если add-on получен как премиальное расширение, устанавливайте его стандартным способом для WordPress-плагинов: через Plugins > Add New > Upload Plugin или загрузкой архива в wp-content/plugins/ с последующей активацией в админ-панели. Не нужно описывать или обходить лицензионную активацию: для руководства важны настройка функций и проверка результата после того, как файл уже есть у администратора.

Проверка почтовой инфраструктуры

Для любых писем WordPress критичны настройки отправителя. В GamiPress на вкладке Settings > Emails доступны общий шаблон, логотип, From Name, From Address и Footer Text. Перед созданием условных писем проверьте, что адрес отправителя принадлежит домену сайта или корректно настроен в вашем SMTP-сервисе. Иначе пользователь может не увидеть письмо, даже если Conditional Emails сработал правильно.

Практический минимум перед запуском:

• Отправьте тестовое обычное письмо WordPress или письмо другого плагина, чтобы убедиться, что почта вообще уходит.
• Проверьте, что почтовый ящик отправителя не выглядит как временный адрес хостинга.
• Убедитесь, что на сайте нет плагина, который блокирует или переопределяет отправку писем без вашего ведома.
• Подготовьте тестового пользователя с реальным адресом, к которому у вас есть доступ.
• Создайте тестовое достижение, тип баллов или ранг, чтобы не отлаживать письмо на живой аудитории.

Самая частая ошибка на старте - настраивать красивый текст письма, не проверив событие и доставляемость. Сначала докажите, что событие GamiPress срабатывает, затем проверяйте письмо.

Права доступа и редакционная ответственность

Условное письмо может содержать персональные данные, ссылки на профиль, сведения о баллах и персонализированные теги. Поэтому доступ к настройке стоит давать только администраторам или ответственным редакторам. Если на сайте несколько менеджеров, договоритесь о naming-схеме: например, начинать название письма с типа события и аудитории. Это поможет не создавать дубли и быстро найти письмо, которое сработало не так.

Установка и первая проверка в админ-панели

После активации add-on в меню GamiPress должен появиться раздел условных писем. В документации путь описан как GamiPress > Conditional Emails. На этом экране виден список созданных писем с названием, статусом и датой. Если раздел не появился, сначала проверьте активность основного GamiPress и самого add-on на странице Plugins.

Первый безопасный запуск

Первое письмо лучше создавать не для живой награды, а для тестового сценария с ограниченным числом отправок. Так вы увидите, как работают тема, контент, теги и лимиты, не рискуя отправить десятки писем реальным пользователям.

1. Откройте GamiPress > Conditional Emails.
2. Создайте новое условное письмо или откройте черновик, если он уже был подготовлен.
3. В блоке Email Configuration заполните тему и содержание письма.
4. В блоке Condition Configuration выберите условие, которое легко воспроизвести тестовым пользователем.
5. В блоке Details оставьте статус неактивным, пока текст и условие не проверены.
6. Сохраните изменения через Save Changes.
7. Используйте действие отправки тестового письма, если оно доступно на экране сохранения.

Документация уточняет важный нюанс: тестовое письмо отправляется на email текущего аккаунта администратора, а перед тестом нужно сохранить изменения, чтобы в письмо попала последняя версия настроек. Это маленькая деталь, но она экономит много времени при отладке.

Что должно получиться после установки

Корректный результат на этом этапе - не отправка письма всем пользователям, а наличие управляемого черновика. Вы должны понимать, где находится список писем, где редактируется тема, где выбирается условие, где задаются лимиты и где отправляется тестовое письмо. Если эти точки понятны, можно переходить к полноценной настройке.

Настройка письма: тема, контент, теги и общий шаблон

Блок Email Configuration отвечает за то, что увидит пользователь. В нём задаются subject и content. Важно не превращать письмо в декоративное поздравление без смысла. Пользователь должен за несколько секунд понять, какое событие произошло, почему он получил письмо и что делать дальше.

Как писать тему письма

Тема письма должна быть короткой, конкретной и связанной с наградой. Если в теме используется тег, убедитесь, что он поддерживается для выбранного события. Официальная документация по available tags подтверждает, что теги работают и в теме, и в содержимом письма, но набор тегов зависит от типов GamiPress и их slug. Это значит, что универсальная тема с любым произвольным тегом может не подставиться так, как ожидается.

Хорошие варианты темы:

• Вы получили новый значок на сайте.
• Ваш баланс баллов достиг нужного уровня.
• Открыт следующий ранг в программе участия.
• Все задания раздела выполнены - проверьте следующий шаг.

Слабые варианты темы обычно страдают одним из трёх недостатков: слишком общие, слишком рекламные или не объясняют событие. Не стоит писать «Поздравляем!» без уточнения, если у пользователя на сайте много разных активностей. Лучше дать конкретный ориентир.

Контент письма и теги GamiPress

В содержимом письма используйте короткую структуру: приветствие, событие, значение для пользователя, следующий шаг, ссылка на нужную страницу. Если добавляете динамические теги, оставьте рядом обычный текст, который будет понятен даже при неожиданной пустой подстановке. Например, не пишите письмо, состоящее только из тегов.

Документация Conditional Emails указывает, что email content выполняет шорткоды, а теги можно использовать как значения атрибутов шорткодов. Пример из документации показывает связку тега достижения и user_id:

[gamipress_achievement id="{quest_id}" user_id="{user_id}"]

Используйте такую механику осторожно. Если письмо должно быть лёгким и хорошо открываться в разных почтовых клиентах, не перегружайте его сложной разметкой. Шорткод в письме уместен, когда он реально помогает показать награду или ссылку, но подробное описание прогресса лучше оставить на странице профиля или в личном кабинете.

Мини-шаблон письма для старта

Для первого сценария можно использовать простую структуру без лишних обещаний:

Здравствуйте!

Вы выполнили условие на сайте и получили новую награду.

Проверьте свой профиль, чтобы увидеть текущий прогресс и следующий доступный шаг:
https://example.com/profile/

Если письмо пришло по ошибке, просто ответьте на это сообщение администратору сайта.

После проверки замените общие строки на конкретные теги и ссылки вашего сайта. Не добавляйте чувствительные данные в письмо, если их можно безопаснее показать после входа пользователя в личный кабинет.

Общий стиль через GamiPress Emails Settings

Если письмо выглядит странно, проверьте не только конкретный Conditional Email, но и общие настройки GamiPress Email Settings. Там задаются шаблон письма, логотип, имя отправителя, адрес отправителя и подвал. Это общий слой для писем GamiPress, поэтому проблема с логотипом, серым фоном, адресом отправителя или шаблоном может быть не в самом условном письме.

Практичная схема настройки: сначала привести в порядок общий шаблон писем GamiPress, затем создать одно условное письмо, затем отправить тест, затем включать реальные условия. Так проще понять, где возникла ошибка - в базовом email-шаблоне или в конкретном условии.

Условия отправки: баллы, достижения, типы достижений и ранги

Самый важный блок продукта - Condition Configuration. Он определяет событие, которое обработает условное письмо. В документации перечислены условия: Reach a points balance, Unlock a specific achievement, Unlock any achievement of type, Unlock all achievements of type и Reach a specific rank. После выбора условия появляются дополнительные поля, например сумма и тип баллов для балансового условия.

Эти условия не равнозначны. Одни подходят для точечного поздравления, другие - для этапов программы, третьи - для крупных вех. Ошибка выбора приводит к тому, что письмо срабатывает слишком часто, слишком поздно или не срабатывает вообще.

Баланс баллов как триггер

Reach a points balance полезен, когда нужно отреагировать на накопление. Например, пользователь набрал 500 бонусных баллов, достиг порога для доступа к закрытому разделу или приблизился к обмену баллов на награду. Здесь важно уточнить тип баллов, если на сайте их несколько. В GamiPress можно создавать разные points types вроде Credits, Gems или Coins, и документация по тегам указывает, что теги строятся на slug соответствующего типа.

Для балансового условия особенно важен лимит на пользователя. Если пользователь может несколько раз пересекать порог из-за списаний и повторных начислений, письмо без ограничения может отправляться повторно. Для большинства сценариев достижения порога безопаснее поставить Maximum Sends Per User равным 1, если письмо должно быть одноразовым.

Конкретное достижение

Unlock a specific achievement подходит для письма о точной награде: завершён курс, открыт сертификат, выполнена серия действий, получен важный значок. Это самый понятный сценарий для пользователя, потому что письмо связано с одним событием. Текст можно сделать более конкретным: что за достижение, почему оно важно, какой следующий шаг.

Такое условие удобно тестировать: создайте тестовое достижение, вручную выдайте его тестовому пользователю или выполните действие, которое его открывает, затем проверьте письмо. Если письмо не пришло, легче проверить одну награду, чем весь тип достижений.

Любое или все достижения типа

Unlock any achievement of type и Unlock all achievements of type нужны для более широких сценариев. Первое условие реагирует на любое достижение внутри типа, второе - на закрытие всего набора достижений этого типа. Например, тип «Задания модуля» может содержать несколько достижений, и письмо после закрытия всех будет логичным финальным сообщением.

Здесь важно не путать радость пользователя с шумом. Если письмо отправляется при любом достижении типа, а тип включает десятки маленьких наград, пользователь может получить слишком много писем. Для таких случаев иногда лучше отправлять не email на каждое событие, а уведомление внутри сайта через Conditional Notifications или одно итоговое письмо после закрытия всех достижений типа.

Ранг как сильная веха

Reach a specific rank подходит для больших переходов: новый уровень участника, новый статус в клубе, повышение в программе обучения. Письмо по рангу обычно воспринимается значимее, чем письмо о мелком действии, поэтому оно может быть длиннее и содержать объяснение возможностей нового уровня. Но не обещайте функций, которые сам GamiPress или ваш сайт не предоставляют. Если ранг символический, так и пишите: новый статус отражает прогресс, а не обязательно открывает доступ.

Лимиты, статус и дата: как не отправить лишние письма

Блок Details выглядит техническим, но именно он защищает от лишних отправок. В нём есть статус письма, дата создания, общий максимум отправок и максимум отправок на пользователя. Документация подчёркивает два важных правила: отправляются только активные conditional emails, а первое письмо будет отправлено после выбранной даты.

Статус письма

Статус active означает, что письмо может участвовать в отправке. Статус inactive полезен для черновиков, тестов и временного отключения. Не удаляйте рабочее письмо сразу, если нужно остановить рассылку. Сначала переведите его в неактивное состояние, проверьте, что новые события не отправляют письмо, и только потом решайте, удалять ли правило.

Для редакционной дисциплины полезно добавить в название письма пометку сценария: «Баллы 500 - профиль», «Ранг эксперт - письмо после перехода», «Все достижения модуля - следующий урок». Это не обязательная функция продукта, а безопасная организационная практика.

Дата как граница старта

Поле даты важно, если вы создаёте условное письмо на сайте с уже существующими пользователями и накопленными наградами. Документация указывает, что первое письмо будет отправлено после выбранной даты. Практический вывод: не используйте старую дату без понимания, как на вашем сайте обрабатываются уже выполненные события. Для нового сценария лучше задать актуальную дату запуска и проверить его на тестовом пользователе.

Maximum Sends и Maximum Sends Per User

Maximum Sends ограничивает общее число отправок письма. Maximum Sends Per User ограничивает число отправок одному пользователю. Значение 0 в документации описано как отсутствие максимума. Это удобно для повторяемых событий, но опасно для писем, которые должны быть вехой.

Практичные значения:

• Для письма о первом достижении используйте лимит на пользователя 1.
• Для письма о новом ранге используйте лимит на пользователя 1, если ранг не может сбрасываться и повторно достигаться.
• Для письма о балансовом пороге используйте лимит 1, если сообщение должно отмечать первое достижение порога.
• Для тестового письма перед запуском можно временно ограничить общий максимум, чтобы не отправить больше, чем планировали.

Если вы сомневаетесь, начинайте с более строгого лимита и расширяйте его только после проверки логики. Откатить лишнюю отправку пользователю нельзя, а включить повторную отправку позже обычно проще.

Практический сценарий: письмо после достижения порога баллов

Рассмотрим рабочий сценарий: сайт использует GamiPress для программы активности. Пользователь получает баллы за прохождение уроков, комментарии или участие в заданиях. Когда он достигает нужного баланса, администратор хочет отправить письмо с объяснением следующего шага. Это не маркетинговая цепочка, а персональное уведомление по факту прогресса.

Цель

Нужно отправить одно письмо пользователю, который впервые достиг выбранного порога баллов определённого типа. В письме нужно поздравить его, объяснить значение порога и дать ссылку на страницу профиля или бонусов. Повторные пересечения порога не должны создавать поток писем.

Подготовка

До настройки проверьте три вещи. Во-первых, тип баллов уже создан и корректно начисляется. Во-вторых, у вас есть тестовый пользователь с известным email. В-третьих, общие настройки писем GamiPress заполнены и тестовая отправка WordPress работает. Если хотя бы один пункт не готов, Conditional Emails будет сложно отлаживать.

Шаги настройки

1. Откройте GamiPress > Conditional Emails и создайте новое письмо.
2. В названии письма укажите внутренний сценарий, например «Баллы активности - первый порог».
3. В Email Configuration задайте тему, связанную с порогом баллов.
4. В содержимом письма объясните, что пользователь достиг нужного баланса, и дайте ссылку на страницу, где он увидит результат.
5. В Condition Configuration выберите Reach a points balance.
6. Укажите нужный тип баллов и сумму, если соответствующие поля появились после выбора условия.
7. В Details оставьте актуальную дату запуска и задайте Maximum Sends Per User равным 1.
8. Сохраните изменения через Save Changes.
9. Отправьте тестовое письмо текущему администратору, чтобы проверить текст и подстановки.
10. Переведите письмо в активный статус только после успешного теста.

Проверка результата

После включения правила выполните событие тестовым пользователем. Если вы вручную меняете баланс, убедитесь, что выбранный способ действительно запускает нужную логику GamiPress. Затем проверьте почтовый ящик пользователя, папку спама, журнал SMTP-плагина, если он установлен, и логи GamiPress, если на сайте используется журнал действий.

Ожидаемый результат: пользователь получает одно письмо, в нём нет неподставленных тегов, ссылка ведёт на правильную страницу, повторное пересечение того же порога не отправляет второе письмо, если лимит на пользователя установлен в 1.

Нюанс с повторным начислением

Если баллы могут списываться и начисляться снова, пользователь может снова достигать порога. Это полезно для некоторых игровых механик, но плохо для одноразового поздравления. Поэтому для пороговых писем почти всегда нужен лимит на пользователя. Если вы хотите повторяемое письмо, напишите это явно в рабочем сценарии и проверьте, не выглядит ли оно как спам.

Практичные идеи применения на разных типах сайтов

Возможности продукта лучше раскрываются не через список функций, а через реальные рабочие ситуации. Ниже - идеи, которые опираются на подтверждённые условия Conditional Emails и типовые сценарии GamiPress. Их можно адаптировать под сайт, но не стоит обещать пользователям бонусы или доступы, если они не настроены отдельными правилами вашего проекта.

Онлайн-школа: письмо после закрытия набора достижений

Если каждый урок или задание выдаёт достижение одного типа, условие Unlock all achievements of type можно использовать как письмо о завершении модуля. В письме не нужно пересказывать весь курс. Лучше сказать, что блок завершён, дать ссылку на следующий модуль и напомнить, где посмотреть прогресс.

Проверка: тестовый студент должен получить письмо только после закрытия полного набора достижений, а не после первого задания. Если письмо приходит раньше, значит выбран не тот тип условия или сами достижения распределены по типам иначе, чем ожидалось.

Сообщество: новый ранг как повод объяснить статус

Для форума, клуба или закрытого сообщества условие Reach a specific rank помогает объяснить значение нового статуса. Письмо может подсказать, какие страницы посмотреть, какие правила участия перечитать и где виден ранг в профиле. Если ранг не открывает новых прав, не пишите, что пользователь получил доступ. Лучше честно описать его как маркер активности.

Магазин или программа лояльности: порог баллов без агрессивной рассылки

Если GamiPress начисляет баллы за покупки или активность, письмо по балансовому порогу может направить пользователя к странице бонусов. Но важно не превращать каждое начисление в письмо. Для магазина хорошим вариантом будет сообщение по крупной вехе: первый значимый порог, новый уровень или достижение, связанное с программой лояльности.

Контентный проект: мягкое возвращение к следующему действию

На сайте с заданиями, статьями или челленджами письмо после конкретного достижения может вернуть пользователя к следующей задаче. Например, после первого опубликованного комментария письмо объясняет, где посмотреть профиль и какие действия ведут к следующей награде. Это работает только если путь действительно настроен в GamiPress и не выглядит как пустая мотивационная фраза.

Проверка результата после запуска

После включения условного письма важно проверить не только факт доставки, но и весь пользовательский путь. Успешная отправка ничего не значит, если письмо ведёт на закрытую страницу, содержит пустой тег или приходит после не того события.

Контрольная цепочка

Используйте простую цепочку проверки: событие, запись в GamiPress, условие письма, отправка WordPress, получение пользователем, переход по ссылке. Если сбой происходит, проверяйте цепочку слева направо. Не начинайте с переписывания текста письма, если событие GamiPress не сработало.

• Событие: Тестовый пользователь выполнил действие, которое должно дать баллы, достижение или ранг.
• GamiPress: В профиле, журнале или админ-панели видно, что награда действительно выдана.
• Conditional Emails: Условное письмо активно, дата не блокирует запуск, лимиты не исчерпаны.
• Почта WordPress: SMTP-плагин или почтовый журнал показывает попытку отправки.
• Почтовый ящик: Письмо пришло, не попало в спам, тема понятна, теги подставились.
• Результат: Ссылка ведёт туда, где пользователь видит следующий шаг или свой прогресс.

Как проверять теги

Теги зависят от типов GamiPress и slug. В документации указано, что теги, связанные с типами, добавляются автоматически и строятся на slug соответствующего типа, например для points type или achievement type. Поэтому после изменения slug, типа достижений или структуры наград обязательно отправляйте тестовое письмо заново.

Если в письме осталась строка вида {example_tag}, это сигнал, что тег не поддержан в данном контексте, написан с ошибкой или не относится к выбранному условию. Не маскируйте проблему красивым текстом. Лучше убрать тег, выбрать другой подтверждённый тег или перенести детальную информацию на страницу профиля.

Когда включать на живой аудитории

Включайте письмо на реальных пользователях только после трёх успешных проверок: администратор получил тестовое письмо, тестовый пользователь вызвал событие и получил письмо, повторное событие не нарушило лимиты. Если аудитория большая, запускайте один сценарий за раз. Так проще найти причину, если жалобы начнут приходить в поддержку.

Ограничения и безопасные улучшения без правки ядра

В открытых источниках не удалось подтвердить отдельные публичные хуки именно для GamiPress Conditional Emails, которые стоило бы безопасно вставлять в руководство как PHP-сниппеты. Поэтому в статье нет выдуманного кода. Но есть несколько улучшений, которые можно сделать без правки ядра WordPress, GamiPress или add-on.

Улучшите доставляемость через штатный почтовый слой

Используйте SMTP-плагин или почтовый сервис, который маршрутизирует письма WordPress через проверенный домен. Это не специфичная функция Conditional Emails, но она критична для результата. После настройки отправьте тестовое письмо из GamiPress и отдельное письмо из SMTP-плагина, чтобы убедиться, что оба канала проходят через один и тот же отправитель.

Держите письма короткими и проверяемыми

Не превращайте письмо в полную страницу личного кабинета. В письме достаточно объяснить событие и дать безопасную ссылку на страницу, где пользователь после входа увидит детали. Это снижает риск сломанных тегов и помогает не раскрывать лишнюю информацию в почтовом клиенте.

Используйте внутренние названия как техническую документацию

Название условного письма видит администратор, поэтому его можно использовать как короткую документацию: «Ранг - эксперт - одноразово», «Баллы - 500 - профиль», «Все достижения модуля - следующий урок». Это помогает при поддержке и уменьшает риск дублирующих правил.

Отдельно тестируйте письма после изменений в структуре GamiPress

Если меняется slug типа баллов, тип достижений, набор достижений или логика рангов, перепроверьте все письма, которые используют соответствующие теги и условия. Документация по тегам прямо связывает часть тегов со slug типов, поэтому изменение структуры может повлиять на подстановки.

Когда GamiPress Conditional Emails будет удачным выбором

GamiPress Conditional Emails стоит использовать, когда у сайта уже есть понятная система баллов, достижений или рангов, а пользователям нужно вовремя объяснять их прогресс. Продукт особенно хорош для одноразовых вех: новый ранг, первый значимый баланс, конкретное достижение, завершение набора достижений. В этих сценариях письмо помогает пользователю не потерять смысл награды.

Перед запуском проверьте базовые email-настройки GamiPress, почтовую доставку WordPress, структуру типов баллов и достижений, лимиты отправки и тестовый сценарий. Если всё работает на тестовом пользователе, можно скачать последнюю версию GamiPress Conditional Emails и внедрять его на рабочем сайте по одному правилу за раз.

Если же вам нужна полноценная рассылка, внешняя CRM, сложные маркетинговые цепочки или письма администраторам, не пытайтесь растянуть add-on за пределы его назначения. В таких задачах лучше выбрать соседнее решение, а Conditional Emails оставить для того, что он делает точнее всего - условные письма по событиям GamiPress.