---
title: "E-mail шаблоны Joomla 5: добавление и просмотр своих переменных - WebTolk"
description: "Как добавить переменные шорт-коды для замены в email-шаблоны Joomla. Триггеры для плагина для добавления даных в емейл шаблоны.  Настройки макетов шаблонов писем Joomla."
url: "https://web-tolk.ru/blog/e-mail-shablony-joomla-5-dobavlenie-i-prosmotr-svoikh-peremennykh"
date: "2025-01-21T06:00:56+00:00"
language: "ru-RU"
---

# E-mail шаблоны Joomla 5: добавление и просмотр своих переменных

 Автор: Сергей Толкачев Создано: 21 января 2025 Обновлено: 01 сентября 2025 Просмотров: 1586    ![](https://web-tolk.ru/blog/images/blog/e-mail-shablony-joomla-5-dobavlenie-i-prosmotr-svoikh-peremennykh/header.webp)

В Joomla 5 появились настраиваемые email-шаблоны, как системные, так и сторонних компонентов. Их нельзя (пока что) добавить самостоятельно, они добавляются расширениями при установке. Но их можно отредактировать в **Система - Шаблоны - Шаблоны писем**. В настройках шаблонов писем (кнопка настроек компонента в верхнем правом углу) мы выбираем формат писем текст или HTML. Тогда становятся доступны настройки макетов шаблонов писем Joomla. Эти глобальные параметры можно переопределить в каждом конкретном email-шаблоне. Таким образом для каждого из email-шаблонов можно указать свою вёрстку и настройки логотипа.

Это, конечно, требует отдельной подробной статьи... Для начала несколько скриншотов.

![joomla email template params](https://web-tolk.ru/blog/images/blog/e-mail-shablony-joomla-5-dobavlenie-i-prosmotr-svoikh-peremennykh/joomla-email-template-params-1.webp)

![joomla email template params html layouts](https://web-tolk.ru/blog/images/blog/e-mail-shablony-joomla-5-dobavlenie-i-prosmotr-svoikh-peremennykh/joomla-email-template-params-2.webp)

## Для разработчиков: как добавить свои переменные для e-mail шаблонов Joomla?

Полезны окажутся 2 триггера для плагинов: `onMailBeforeTagsRendering` и `onMailBeforeRendering`.

### Триггер onMailBeforeRendering в Joomla

 onMailBeforeRenderingЭто триггер, который позволяет добавлять свои шорт-коды для строковой замены в плагине. Отдать туда надо массив вида `[ variable_name => variable_value ]`.

Из админки свои переменные нужно добавлять уже с фигурными скобками: `{variable_name}` заменится на `variable_value`. Аргументом `$event` плагина является экземпляр класса `BeforeRenderingMailTemplateEvent`, в котором есть кроме прочих 2 метода: `getTemplate()` (получение объекта мейлера, куда можно добавлять свои данные) и `getTemplateId()` (получение id шаблона письма вида `com_users.registration.admin.new_notification`), по которому мы определяем нужный ли это для нас email-шаблон или нет. Аналогично контексту в контент-плагинах.

![joomla 5 email template admin panel](https://web-tolk.ru/blog/images/blog/e-mail-shablony-joomla-5-dobavlenie-i-prosmotr-svoikh-peremennykh/joomla-email-template-admin-panel.webp)

Также полезное свойство класса для передачи данных из плагина в лейаут письма для рендера - `$layoutTemplateData`. Это ассоциативный массив.

```
<?php
// Получаем текущий мейлер
$mailTemplate = $event->getTemplate();
$data = [
   'variable_name' => 'variable_value'
];
// с Joomla 4 для всех типов писем. 2-й аргумент - plain - текстовый формат письма
$mailTemplate->addTemplateData($data, false);
// с Joomla 5.2 - для HTML-писем
$mailTemplate->addLayoutTemplateData($data);

// пример из ядра Joomla
// Add additional data to the layout template
$this->addLayoutTemplateData([
    'siteName' => $app->get('sitename'),
    'lang'     => substr($this->language, 0, 2),
]);
```

### Триггер onMailBeforeTagsRendering в Joomla

 **onMailBeforeTagsRendering**Это триггер, который добавляет ваши переменные в список доступных переменных для замены в окне редактирования email шаблона Joomla. Отдать туда нужно массив с переменными, но без их значений.

![joomla 5 edit email template admin panel tags for mail body](https://web-tolk.ru/blog/images/blog/e-mail-shablony-joomla-5-dobavlenie-i-prosmotr-svoikh-peremennykh/joomla-edit-email-template-admin-panel-tags-for-mail-body.webp)

- [Пост в Telegram-канале](https://t.me/webtolkru/436)
- [Пост на Хабре](https://habr.com/ru/posts/875026/)
- [Эта статья в Joomla Community Magazine](https://magazine.joomla.org/all-issues/february-2025/joomla-5-email-templates-how-to-add-variables-via-plugin)

## Об авторе

![Толкачев Сергей Юрьевич](https://web-tolk.ru/images/uslugi/sergey-tolkachyov-apr-2023.webp)

### Толкачев Сергей Юрьевич

Joomla-разработчик. [Контрибьютер ядра Joomla](https://github.com/joomla/joomla-cms/pulls?q=is%3Apr+author%3Asergeytolkachyov+). Один из ведущих Telegram-канала русскоязычного Joomla-сообщества [JoomlaFeed](https://t.me/joomlafeed), один из модераторов [чата русскоязычного Joomla-сообщества](https://t.me/joomlaru). Мои расширения в официальном маркетплейсе расширений Joomla - [Joomla Extensions Directory](https://extensions.joomla.org/profile/profile/details/528051/). Имею публикации в [официальном журнале международного Joomla-сообщества - Joomla Community Magazine](https://magazine.joomla.org/authors/sergeytolkachyov) и на [официальном сайте русскоязычного Joomla-сообщества](https://joomlaportal.ru/users/sergey-tolkachyov).

Муж. Отец 3 детей.

Россия, Саратов.

## JSON-LD Schema

```json
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17",
    "itemListElement": [
        {
            "@type": "ListItem",
            "position": 1,
            "item": {
                "@id": "https://web-tolk.ru/",
                "name": "Главная"
            }
        },
        {
            "@type": "ListItem",
            "position": 2,
            "item": {
                "@id": "https://web-tolk.ru/blog",
                "name": "Блог"
            }
        },
        {
            "@type": "ListItem",
            "position": 3,
            "item": {
                "name": "E-mail шаблоны Joomla 5: добавление и просмотр своих переменных"
            }
        }
    ]
}
```

```json
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://web-tolk.ru/#/schema/Organization/base",
            "name": "WebTolk",
            "url": "https://web-tolk.ru/",
            "logo": {
                "@type": "ImageObject",
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo",
                "url": "images/webtolk-1080p.jpg",
                "contentUrl": "images/webtolk-1080p.jpg",
                "width": 1920,
                "height": 1080
            },
            "image": {
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo"
            },
            "sameAs": [
                "https://github.com/WebTolk",
                "https://github.com/sergeytolkachyov",
                "https://vk.com/web_tolk",
                "https://vk.com/webtolkru",
                "https://tenchat.ru/sergeytolkachyov",
                "https://t.me/sergeytolkachyov",
                "https://t.me/webtolkru"
            ]
        },
        {
            "@type": "WebSite",
            "@id": "https://web-tolk.ru/#/schema/WebSite/base",
            "url": "https://web-tolk.ru/",
            "name": "WebTolk",
            "publisher": {
                "@id": "https://web-tolk.ru/#/schema/Organization/base"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://web-tolk.ru/#/schema/WebPage/base",
            "url": "https://web-tolk.ru/blog/e-mail-shablony-joomla-5-dobavlenie-i-prosmotr-svoikh-peremennykh",
            "name": "E-mail шаблоны Joomla 5: добавление и просмотр своих переменных - WebTolk",
            "description": "Как добавить переменные шорт-коды для замены в email-шаблоны Joomla. Триггеры для плагина для добавления даных в емейл шаблоны.  Настройки макетов шаблонов писем Joomla.",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebSite/base"
            },
            "about": {
                "@id": "https://web-tolk.ru/#/schema/Organization/base"
            },
            "inLanguage": "ru-RU",
            "breadcrumb": {
                "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17"
            }
        },
        {
            "@type": "Article",
            "@id": "https://web-tolk.ru/#/schema/com_content/article/123",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebPage/base"
            }
        }
    ]
}
```