Шаблони електронних листів¶
Ми всі знаємо, що написання хороших ел. листів є життєво важливим для отримання високого відсотка відповідей, але ви не хочете щоразу переписувати ту саму структуру, чи не так? Ось тут і з’являються шаблони ел. пошти. Не потрібно щоразу переписувати всю структуру ел. пошти, ви заощаджуєте час, щоб зосередитися на вмісті. Кілька шаблонів також дозволяють донести правильне повідомлення до потрібної аудиторії, покращуючи загальний досвід спілкування з компанією.
Увімкніть його та зрозумійте кілька понять¶
Режим розробника має бути активовано). Потім перейдіть до . Показано представлення існуючих шаблонів.
Небезпека
Настійно рекомендується не змінювати вміст існуючих шаблонів, якщо користувач не має попередніх знань про заповнювачі.
Щоб додати новий, натисніть Створити та виберіть тип документа, з яким використовується цей шаблон. У наведеному нижче прикладі шаблон буде надіслано претендентам на роботу.

Написання вмісту, включаючи вирази-заповнювачі¶
Заповнювач - це рядок символів, який тимчасово замінює кінцеві дані. У шаблонах ел. пошти, наприклад, заповнювачі дозволяють розміщувати динамічний вміст, щоб персоналізувати ел. лист для одержувача.
Його зазвичай використовують для вказівки імені одержувача в інформаційному бюлетені, щоб кожен одержувач отримував персоналізований інформаційний бюлетень.
Заповнювачі та, точніше, поля, доступні для шаблону, залежатимуть від шаблону, який ви змінюєте. Один із способів побачити доступні поля - перевірити вкладку Генератор динамічних заповнювачів.
На вкладці Динамічний генератор заповнювачів знайдіть Поле, яке ви хочете використати.
Далі скопіюйте Вираз заповнювача і вставте його в Тіло ел. листа на вкладці Зміст, використовуючи, по суті, Перегляд коду.
Вимкніть опцію Перегляд коду, просто клацнувши її ще раз, і легко створіть повідомлення. Натисніть Попередній перегляд, щоб перевірити, як ел.лист виглядає перед його надсиланням.
Використання функцій із заповнювачами¶
Функції можна використовувати разом із заповнювачами для того, щоб відформатувати дані у ваших шаблонах електронної пошти за вашим бажанням, наприклад, формат часу можна змінити за допомогою такої функції, як format_time
.
Щоб використовувати функції, ви повинні знати доступні поля для форматування. Щоб знати це, ви повинні перевірити поля (властивості) об’єкта, які доступні для використання.
Перевірка наявних на об’єкті полів (властивості)¶
Щоб перевірити доступні поля, клацніть посилання поруч із Застосовується до. Для прикладу ми використовуємо шаблон Портал: новий користувач, тому ми натискаємо Конфігурація користувача порталу.

Натиснувши посилання, ви перейдете до моделі, у цьому випадку до моделі Конфігурація користувача порталу
, у якій перераховано всі поля, які можна використовувати в шаблоні ел. пошти.

Як примітка, ви також можете побачити поля, які доступні, отримавши доступ до генератора динамічних заповнювачів, як описано раніше.
Дивіться нижче приклад із полем ел. пошти, доданим у шаблон, і його результатом, а також деякими іншими заповнювачами, які вже присутні за замовчуванням.

Використання полів із функціями¶
Тепер, коли ви знаєте поля, які можна використовувати, ви можете використовувати одне з них із функцією. У цьому прикладі ми додаємо дату створення, поле create_date до тіла шаблону ‘Портал: новий користувач’ разом із функцією format_date
, щоб користувач знав, коли його запросили.

Як бачите, ми використовуємо заповнювач ${}
із функцією format_date
, яка використовує як параметр поле create_date, доступне для поточного об’єкта, це дає наступний рядок коду ${format_date(object. create_date)}
.
Попередження
Дуже важливо перевірити, чи працює попередній перегляд, якщо він зламаний, під час попереднього перегляду шаблон може виглядати абсолютно порожнім. Ми також рекомендуємо не змінювати вміст у існуючих шаблонах, якщо у вас немає попередніх знань. Ми наполегливо рекомендуємо скопіювати шаблон і застосувати ваші зміни в цьому.
Знайдіть нижче результат ел. листа, отриманого в поштову скриньку одержувача, із застосованими змінами.

Крім того, за допомогою функції format_date
ви маєте можливість адаптувати формат дати лише в певному ел. листі, вказавши форматування дати як другий параметр. Якщо не вказано, за замовчуванням використовується формат, визначений у налаштуваннях мови. Більше інформації про те, як отримати доступ до цих параметрів, можна знайти тут.
Щоб адаптувати формат дати, фрагмент коду, використаний у наведеному вище прикладі ${format_date(object.create_date)}
, стає ${format_date(object.create_date, date_format='dd -- MM -- РРРР')}
тут дд — день, ММ — місяць і РРРР — рік.
Ось результат після адаптації функції в шаблоні.

Функції, що використовуються за умовчанням у шаблонах ел. листів¶
Для форматування даних можна використовувати багато функцій, ось кілька прикладів.
Примітка
Цей список функцій не є вичерпним, а це означає, що всі доступні функції не перераховані в списку нижче. Для отримання додаткових функцій ми запрошуємо вас перевірити babel документації, останнє, але не менш важливе, зміни в шаблонах вважаються налаштуванням і не покриваються нашою підтримкою.
Для наступних прикладів ми представимо здебільшого деякі функції дати. За замовчуванням використовується формат дати, визначений у налаштуваннях мови.
Доступ до цих налаштувань доступний лише тоді, коли ввімкнено режим розробника. Після того, як розробник увімкнено, перейдіть до та клацніть одну з мов, щоб переглянути всі параметри, такі як формат часу або формат дати, які використовуються мовою.
format_date() - форматує дату (без часу).
Можна знайти на шаблоні
Замовлення на купівлю: Надіслати замовлення на замовлення
:Результат буде виглядати так:
format_datetime() - форматує дату й час, визначаючи конкретний часовий пояс, у даному випадку за центральноєвропейським часом (CET).
Можна знайти на шаблоні
Подія: Реєстрація
.Результат буде виглядати так:
format_time() – схожа на функцію format_datetime, за винятком того, що вона використовується лише для часу, а не для дати.
format_amount() – Форматує число, суму для відображення валюти залежно від налаштувань відображення, визначених для валюти (для перегляду цього має бути активовано режим налагодження функція) (перед або після суми залежно від угоди).
Який буде виглядати так:
Визначення відповіді за замовчуванням у вашому шаблоні ел. пошти¶
Незважаючи на те, що поле відповідь на доступне в шаблонах листів, це поле використовується лише для режиму масової розсилки (це означає, що під час надсилання шаблонів, що ми називаємо масовою розсилкою). Ви можете масово надсилати ел. листи майже в кожній програмі, яка має перегляд списку. Виберіть потрібні записи та натисніть кнопку дії. Якщо у вас є можливість надіслати ел. лист, ви побачите редактор листів із можливими значеннями для визначення:

Ви також можете визначити їх за замовчуванням у шаблоні:

Через це встановлення значення в цьому полі є марним, оскільки визначене значення буде повністю проігноровано. Значення reply-to за замовчуванням — це адреса ел. пошти за замовчуванням для забезпечення зв’язку між вашим клієнтом і вашою базою даних Odoo. Щоб дізнатися більше про те, як працює catchall, перегляньте як керувати вхідними повідомленнями.
Транзакційні ел. листи та відповідна URL-адреса для кожної компанії¶
Під час використання Odoo кілька подій ініціюють надсилання автоматизованих ел. листів. Ці ел. листи називають транзакційними та іноді містять посилання на вашу базу даних Odoo.
За замовчуванням посилання, створені базою даних, використовують динамічний ключ web.base.url, визначений у системних параметрах. Більше інформації про цей параметр.
Якщо програму веб-сайту не встановлено, ключ web.base.url завжди буде параметром за замовчуванням, який використовується для створення всіх посилань.
Важливо знати, що цей ключ може мати лише одне значення, а це означає, що в середовищі бази даних кількох веб-сайтів/компанії, навіть якщо у вас є конкретне доменне ім’я для кожного веб-сайту, посилання створюватимуться для спільного доступу до документа або в транзакційній ел. пошті. може залишатися незмінним незалежно від веб-сайту/компанії, пов’язаної з надсиланням ел. листа/документа.
Це не завжди так, оскільки деякі додатки Odoo мають посилання в базі даних із програмою веб-сайту, тобто в цьому випадку, якщо для веб-сайтів визначено певний домен, URL-адреса, згенерована в шаблоні електронної пошти, використовуватиме визначений домен на відповідному сайті компанії.
Застереження
Документ, яким надано спільний доступ за допомогою додатків документів, завжди використовуватиме ключ web.base.url, оскільки документ, яким надано спільний доступ, не пов’язано з жодним конкретним веб-сайтом. Це означає, що URL-адреса завжди буде однаковою (значення ключа web.base.url), незалежно від компанії, з якої вона надіслана, це відоме обмеження!
З іншого боку, замовлення на продаж, зроблені клієнтом на одному з ваших веб-сайтів електронної комерції Odoo, мають посилання на веб-сайт, з якого було зроблено замовлення. У результаті ел. лист, надісланий для замовлень на продаж, використовує доменне ім’я, визначене для відповідного веб-сайту, для створення посилань.
Щоб дізнатися більше про те, як налаштувати ваші домени, ми запрошуємо вас переглянути нашу документацію щодо доменних імен.
Оновлення перекладів у шаблонах ел. листів¶
Шаблони ел. листів перекладаються автоматично. Змінювати переклади не потрібно. Однак, якщо з певної причини ви хочете змінити деякі переклади, це можна зробити.
Як і будь-яка модифікація коду, майте на увазі, що модифікації, зроблені неправильно (наприклад, модифікації, що призводять до неправильного синтаксису), можуть порушити шаблон, у результаті шаблон відображатиметься порожнім.
Щоб відредагувати свої переклади, виконайте такі кроки з шаблону.
Натисніть кнопку редагування, а потім кнопку мови
Відобразиться спливаюче вікно з різними мовами, встановленими в базі даних. Звідси можна буде редагувати переклади. Не забудьте натиснути кнопку збереження, щоб зберегти зміни.