Как расширить шаблоны писем Joomla 5, добавив пользовательские переменные?

В Joomla 5 шаблоны писем, хоть и предоставляют гибкие возможности для настройки, могут ограничивать администраторов стандартным набором переменных. Чтобы расширить этот функционал, можно создать системный плагин, который добавит пользовательские поля, например, поля профиля пользователя. Это достигается через перехват двух событий: onMailBeforeTagsRendering, добавляющего новые шорт-коды (например, имена полей пользователя) в список доступных переменных в редакторе шаблонов писем, и onMailBeforeRendering, который передает фактические значения этих полей в письмо.

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

Чтобы эти шорт-коды работали, необходимо событие onMailBeforeRendering. Плагин получает идентификатор шаблона, чтобы можно было обрабатывать разные шаблоны по-разному, например, если это письмо администратору при регистрации, то получает ID пользователя через токен активации. Затем плагин запрашивает значения необходимых полей пользователя и передает их в шаблон письма. Используя стандартные шорт-коды {field_name}, где field_name – имя поля пользователя, эти значения отображаются в итоговом письме.

Плагин можно упаковать в виде системного плагина с необходимыми файлами: XML манифестом, файлом сервиса и PHP кодом. Плагин оперирует с идентификатором шаблона (template_id) вместо стандартного контекста, что позволяет настраивать переменные для различных шаблонов писем. Это дает возможность добавлять любые необходимые переменные в зависимости от конкретных потребностей, расширяя возможности писем Joomla.

Источник: novikov__al