Типы почтовых событий

Урок 268 из 838

Автор: Анна Кокина

Сложность урока:

3 уровень - средняя сложность. Необходимо внимание и немного подумать.

3 из 5

Дата изменения: 01.05.2021

Ограничения по редакциям: Старт, Стандарт, Малый бизнес

Типы почтовых событий описаны на странице Настройки > Настройки продукта > Почтовые события > Типы почтовых событий:

Для редактирования типа почтовых событий выберите пункт Изменить в меню действий. Чтобы добавить новый тип нажмите кнопку Добавить тип на контекстной панели, откроется форма создания:

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

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

array(
	'ORDER_ID' => 123, 
	'ORDER_PAID' => 'Y', 
	'BUYER_NAME' => 'Андрей'
)

В почтовом шаблоне можно будет использовать эти поля, указывая макросы:

#ORDER_ID#
#ORDER_PAID#
#BUYER_NAME#

Начиная с версии главного модуля 15.0.7, где разрешается использование PHP в почтовых шаблонах, то же самое можно указать и так:

<=$arParams['ORDER_ID']>
<$arParams['ORDER_PAID']>
<=$arParams['BUYER_NAME']>

Таким образом, в теле почтового шаблона массив переданных полей доступен через переменную $arParams.

Особенности использования тега xml
Текст xml выдаст ошибку: <?xml version="1.1" encoding="UTF-8" ?> <tag1>a</tag1> <tag2>b</tag2> Дело в том, что тег xml интерпретируется php не как текст. Поэтому, нужно выводить тег xml так: <?echo '<'.'?'.'xml version="1.1" encoding="UTF-8" ?'.'>'?>

Особенности использования тега xml

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

Примечание: подробнее о почтовых шаблонах смотрите в уроке Работа с почтовыми шаблонами Почтовые шаблоны расположены на странице Настройки > Настройки продукта > Почтовые события > Почтовые шаблоны. Чтобы редактировать почтовый шаблон, выберите пункт Изменить в меню действий нужного шаблона.

Подробнее... .

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

Документация по теме:

Курсы разработаны в компании «1С-Битрикс»

Предыдущий урок

Наверх

Следующий урок

Мы стараемся сделать документацию понятнее и доступнее,
и Ваше мнение важно для нас