> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Как написать тему и текст письма

> Напишите тему и текст письма, которое отправляет Foliant, с переменными Liquid и разметкой Markdown, и посмотрите, как оно выглядит для вашего последнего заказа.

# Как написать тему и текст письма

![Карточка «Эл. почта» с темой, сообщением и переменными Liquid](https://mintcdn.com/foliant-dev/nnNby4-r9e5xN6eK/pdf-delivery/images/write-the-email.png?fit=max\&auto=format\&n=nnNby4-r9e5xN6eK\&q=85\&s=c2b268765ce0fdce4e1f77da0d2f8f2b)

У каждого письма, которое отправляет Foliant, своя тема и свой текст. Данные заказа можно подставлять с помощью Liquid — того же языка шаблонов, что и в ваших документах. Текст можно оформлять с помощью Markdown. Перед сохранением предпросмотр покажет, как письмо будет выглядеть для вашего последнего заказа.

## Изменение письма

1. Перейдите в раздел **Доставка** и откройте письмо (строка с пометкой «Emailed by Foliant»).
2. В разделе **Эл. почта** убедитесь, что выбран вариант **Изменить**.
3. Измените поля **Тема** (до 255 символов) и **Сообщение** (до 5000 символов).
4. Сохраните изменения с помощью панели сохранения.

Новое письмо начинается с такой темы и такого текста:

```liquid theme={null}
{{ document.title }} {{ document.number }} for order {{ order.name }}
```

```liquid theme={null}
Hello {{ customer.first_name | default: "there" }},

Your {{ document.title }} for order {{ order.name }} is attached.

{{ shop.name }}
```

## Доступные переменные

В блоке **Можно использовать Liquid:** выберите переменную, чтобы скопировать её, а затем вставьте её в тему или текст письма.

| Переменная | Что она показывает |
| - | - |
| `{{ order.name }}` | Название заказа, например #1001. |
| `{{ order.total_price \| money }}` | Сумма заказа в денежном формате. |
| `{{ customer.first_name }}` | Имя клиента. |
| `{{ shop.name }}` | Название вашего магазина. |
| `{{ document.title }}` | Название шаблона, например «Счёт». |
| `{{ document.number }}` | Номер документа (для счетов, кредитовых нот и коммерческих предложений с включённой нумерацией). |

В письме доступны те же данные заказа и фильтры, что и в ваших шаблонах (`money`, `date` и т. д.). Подробнее см. в статье [Фильтры Liquid](https://foliant-help.iforiti.com/ru/template-editor/liquid-filters.md).

## Оформление текста

В тексте письма работает Markdown: `**bold**`, `*italic*` и ссылки. Пустая строка начинает новый абзац. Введённый HTML отображается как обычный текст, а не как разметка.

## На других языках вашего магазина

Если ваш магазин продаёт на нескольких языках, рядом с названиями полей **Тема** и **Сообщение** есть кнопка **Добавить язык** (когда переводы уже добавлены, она называется **Languages** и показывает их количество). Нажмите её, чтобы открыть окно **Manage translations**. Нажмите **Добавить язык**, выберите языки, на которых ваш магазин опубликован в Shopify, и напишите тему или текст на каждом из них. Нажмите **Готово**, затем сохраните изменения.

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

## Предпросмотр письма

Нажмите **Предпросмотр**. Foliant покажет письмо так, как его показал бы почтовый клиент: **С**, **На**, **Ответ на**, **Тема**, текст письма и имя прикреплённого PDF-файла. Письмо отображается для вашего последнего заказа в том виде, в каком вы его ввели, даже до сохранения.

В примечании под предпросмотром указано, какой заказ был использован. Номер документа подставляется при отправке письма.

Если в Liquid есть ошибка, предпросмотр покажет её, а при сохранении появится сообщение о том, что не так («The subject's Liquid has an error: …»; для другого языка указывается код языка, например «The message's Liquid (fr) has an error: …»).

## Полезно знать

* Тема отправляется одной строкой: переносы строк и HTML удаляются.
* Чтобы сохранить письмо, его текст должен корректно обрабатываться как Liquid. Текст может быть пустым, а тема обязательна.
* Если язык вашего магазина пишется справа налево (арабский, иврит, персидский, урду), текст письма выравнивается по правому краю.
* В каждом письме отправителем указано название вашего магазина, а ответы приходят на эл. почту магазина. Чтобы отправлять письма со своего адреса, см. статью [Отправка со своего домена](https://foliant-help.iforiti.com/ru/pdf-delivery/sending-domain.md).
* PDF прикрепляется к письму. Если файл больше 10 МБ, вместо вложения в письме будет ссылка на него.

## Статьи по теме

* [Отправка PDF по эл. почте через Foliant](https://foliant-help.iforiti.com/ru/pdf-delivery/emails-sent-by-foliant.md)
* [Отправка тестового письма](https://foliant-help.iforiti.com/ru/pdf-delivery/send-a-test-email.md)
* [Отправка со своего домена](https://foliant-help.iforiti.com/ru/pdf-delivery/sending-domain.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.