Использование email шаблонов в Joomla 4 или MailTemplate()

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

Пользователи Joomla 4 могут полностью контролировать содержание электронных писем, отправляемых со своих веб-сайтов. Все это возможно с новым расширением com_mails.

Шаблоны писем

Новый компонент com_mails был добавлен как функция Joomla 4. Он используется для настройки шаблонов электронной почты отправляемых пользователям, которые служат для различных действий, включая контактную форму, регистрацию, сброс пароля Joomla, напоминание и многое другое.

Войдите в административную панель Joomla 4. В левом меню нажмите «Система», а затем выберите «Почтовые шаблоны».

Каждый шаблон электронного письма можно легко создать и настроить под разные темы. Несколько шаблонов электронной почты основаны на пяти основных компонентах:

• Диспетчер конфигурации
• Контакты
• Пользователи
• Система - Joomla! Уведомления об обновлениях
• Пользователь - Joomla!

Типы

Существует восемь различных типов настроек шаблона электронной почты (каждый компонент имеет свои типы). Различные типы шаблонов электронной почты:

Тестовое письмо (глобальная конфигурация)

Отправляется при нажатии кнопки «Отправить тестовое письмо» в глобальной конфигурации. Он отправляется на адрес отправителя, указанный в настройках почты (администратор может проверить, правильно ли работает функция электронной почты).

Контактная форма Почта (Контакты)

Этот шаблон электронного письма с содержанием электронного письма «Контактная форма» (пользователи веб-сайтов отправляют письмо с контактным запросом).

Контактная форма Mail Copy (Контакты)

Этот шаблон отправляется отправителю почты вместе с контактной формой, только если опция «Отправить копию отправителю» включена и выбрана.

Пользователи массовой рассылки (пользователи)

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

Сброс пароля (пользователи)

Отправляется пользователю по ссылке «Забыли пароль?» С запросом на сброс пароля.

Напоминание имени пользователя (пользователи)

Отправляется пользователю по ссылке с запросом на напоминание имени пользователя «Забыли имя пользователя?».

Новые пользователи (пользователи)

Отправлено новому пользователю, зарегистрированному на сайте.

Joomla: Уведомление об обновлении (Система - Уведомление об обновлении Joomla!)

Отправляется администраторам веб-сайта, когда системный плагин «Уведомление об обновлении Joomla!» Обнаруживает обновление. Для этого должен быть включен плагин уведомления об обновлении.

Как это могут использовать разработчики приложений

Для подключения используйте следующее:

use Joomla\CMS\Mail\MailTemplate;

Это пример из плагина Joomla 4

$mailer = new MailTemplate('plg_user_joomla.mail', $userLocale);
$mailer->addTemplateData($data);
$mailer->addRecipient($user['email'], $user['name']);
$mailer->send();

Другие функции MailTemplate()

Добавить вложение в почту

addAttachment($name, $file)

Добавляет получателей для этой почты

addRecipient($mail, $name = null, $type = 'to')

Установить адрес ответа на это письмо

setReplyTo($mail, $name = '')

Добавление данных для замены в шаблоне

addTemplateData($data)

Рендеринг и отправка почты

send()

Заменить теги на указанные значения

replaceTags($text, $tags)

Получите определенный шаблон

getTemplate($key, $language)

Вставьте новый шаблон почты в систему

createTemplate($key, $subject, $body, $tags, $htmlbody = '')

Обновление существующего шаблона почты

updateTemplate($key, $subject, $body, $tags, $htmlbody = '')

Удаление шаблона почты

deleteTemplate($key)