Сниппеты в шаблонах email-уведомлений

Сниппеты — это готовые элементы шаблонов, используемые в различных email-уведомлениях. Сниппеты используются в двух случаях:

  • Если какую-то информацию (например, изображение, контактная информация и ссылки на важные страницы вашего магазина) нужно добавить в несколько разных email-уведомлений.
  • Если нужно добавить сложную логику в шаблон, не перегружая при этом код шаблона в редакторе.

Решить данные вопросы можно, создав сниппет с необходимым содержимым. После создания сниппета вы сможете добавить всё его содержимое в шаблон, просто вставив в шаблон сам сниппет.

Примечание

Изменения в сниппете автоматически применяются ко всем уведомлениям, включающим данный сниппет.

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

Важно

Если удалить переменные темы из сниппета Header или удалить сам сниппет из шаблона уведомления, то подстраивание под стили темы работать не будет.

Благодаря сниппету Header одно и тоже уведомление будет выглядеть по-разному при использовании разных стилей.

Управление сниппетами

Список сниппетов для email-уведомлений доступен в меню Дизайн → Шаблоны email-уведомлений на вкладке Сниппеты. На этой странице вы можете добавлять, редактировать и удалять сниппеты.

Список сниппетов для email-уведомлений.

Добавить/Редактировать сниппет

  1. Чтобы добавить сниппет, нажмите кнопку + в правом верхнем углу экрана. Для редактирования существующего сниппета щёлкните по его названию.

  2. В появившемся окне отредактируйте сниппет:

    • Название — название сниппета. Используется для упрощения навигации. Несколько сниппетов могут иметь одно и то же имя.
    • Код — последовательность символов, используемая для встраивания сниппета в шаблон и в качестве идентификатора. Каждый сниппет должен иметь свой уникальный код.
    • Шаблон — содержимое сниппета. В этом поле вы можете пользоваться обычным текстом, переменными, языковыми переменными, функциями Twig, а также HTML и CSS-кодом.
    • Статус — сниппеты могут быть Включенными (Вкл.) или Выключенными (Выкл.). Выключенные сниппеты не отображаются среди доступных сниппетов на экране редактирования шаблона и никак не влияют на уведомления.
  3. Закончив редактировать сниппет, нажмите Создать (или Сохранить, если сниппет уже существует).

    Важно

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

Всплывающее окно со свойствами сниппета.

Удалить сниппет

  • Для удаления одного сниппета, щёлкните по кнопке с изображением шестерёнки рядом с ним и выберите Удалить.
  • Для удаления нескольких сниппетов:
    1. Щёклните по флажкам рядом со сниппетами, которые хотите удалить.
    2. Нажмите на кнопку с изображением шестерёнки в правом верхнем углу страницы.
    3. Выберите Удалить выбранные.

Экспортировать и импортировать сниппеты

Все сниппеты вместе с шаблонами уведомлений экспортируются и импортируются в одном файле формата XML. Нажмите на кнопку с изображением шестерёнки в правом верхнем углу страницы и выберите Экспорт или Импорт. Подробнее читайте в статье об экспорте и импорте шаблонов email-уведомлений.

Важно

Если при импорте коды (<code>) сниппетов совпадают, то существующий сниппет будет заменён импортируемым сниппетом с таким же кодом.

Добавление сниппетов в шаблоны email-уведомлений

Код сниппета в редакторе шаблонов уведомлений.

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

Также вы можете вставлять сниппеты в шаблон вручную. Например, чтобы вставить сниппет с кодом test, добавьте в шаблон {{ snippet(“test”) }}. После этого содержимое сниппета будет отображаться в предпросмотре уведомления.

Вид сниппета в готовом уведомлении.