Шаблони електронних листів

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

Увімкніть його та зрозумійте кілька понять

Режим розробника має бути активовано). Потім перейдіть до Налаштування ‣ Технічні ‣ Шаблони. Показано представлення існуючих шаблонів.

Небезпека

Настійно рекомендується не змінювати вміст існуючих шаблонів, якщо користувач не має попередніх знань про заповнювачі.

Щоб додати новий, натисніть Створити та виберіть тип документа, з яким використовується цей шаблон. У наведеному нижче прикладі шаблон буде надіслано претендентам на роботу.

Нова форма шаблону ел. пошти в Odoo
У розділі Конфігурація ел. пошти такі поля, як Від, Кому (ел. листи), Кому (партнери), потребують заповнювачів. Якщо поле Від не встановлено, значенням за замовчуванням є аліасом ел. пошти автора, якщо його налаштовано, або ел. адреса.
У розділі Додаткові параметри, якщо Сервер вихідної пошти не встановлено, використовується сервер із найвищим пріоритетом.
Опція Автоматичне видалення назавжди видаляє ел. листи після їх надсилання, заощаджуючи місце у вашій базі даних.

Написання вмісту, включаючи вирази-заповнювачі

Заповнювач - це рядок символів, який тимчасово замінює кінцеві дані. У шаблонах ел. пошти, наприклад, заповнювачі дозволяють розміщувати динамічний вміст, щоб персоналізувати ел. лист для одержувача.

Його зазвичай використовують для вказівки імені одержувача в інформаційному бюлетені, щоб кожен одержувач отримував персоналізований інформаційний бюлетень.

Заповнювачі та, точніше, поля, доступні для шаблону, залежатимуть від шаблону, який ви змінюєте. Один із способів побачити доступні поля - перевірити вкладку Генератор динамічних заповнювачів.

  1. На вкладці Динамічний генератор заповнювачів знайдіть Поле, яке ви хочете використати.

    Перегляд вкладки генератора динамічних заповнювачів у новому шаблоні в Odoo
  2. Далі скопіюйте Вираз заповнювача і вставте його в Тіло ел. листа на вкладці Зміст, використовуючи, по суті, Перегляд коду.

    Перегляд основного коду під вкладкою вмісту в Odoo
  3. Вимкніть опцію Перегляд коду, просто клацнувши її ще раз, і легко створіть повідомлення. Натисніть Попередній перегляд, щоб перевірити, як ел.лист виглядає перед його надсиланням.

    Перегляд вмісту зі стандартним основним виглядом в Odoo

Використання функцій із заповнювачами

Функції можна використовувати разом із заповнювачами для того, щоб відформатувати дані у ваших шаблонах електронної пошти за вашим бажанням, наприклад, формат часу можна змінити за допомогою такої функції, як format_time.

Щоб використовувати функції, ви повинні знати доступні поля для форматування. Щоб знати це, ви повинні перевірити поля (властивості) об’єкта, які доступні для використання.

Перевірка наявних на об’єкті полів (властивості)

Щоб перевірити доступні поля, клацніть посилання поруч із Застосовується до. Для прикладу ми використовуємо шаблон Портал: новий користувач, тому ми натискаємо Конфігурація користувача порталу.

Шаблон може використовувати поле визначених моделей.

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

Існуючі поля моделі

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

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

Додайте поле на шаблон і подивіться результат

Використання полів із функціями

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

Приклад format_date у полі create_date

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

Попередження

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

Знайдіть нижче результат ел. листа, отриманого в поштову скриньку одержувача, із застосованими змінами.

Відтворення функції format_date у полі create_date

Крім того, за допомогою функції format_date ви маєте можливість адаптувати формат дати лише в певному ел. листі, вказавши форматування дати як другий параметр. Якщо не вказано, за замовчуванням використовується формат, визначений у налаштуваннях мови. Більше інформації про те, як отримати доступ до цих параметрів, можна знайти тут.

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

Ось результат після адаптації функції в шаблоні.

Адаптована візуалізація format_date
Функції, що використовуються за умовчанням у шаблонах ел. листів

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

Примітка

Цей список функцій не є вичерпним, а це означає, що всі доступні функції не перераховані в списку нижче. Для отримання додаткових функцій ми запрошуємо вас перевірити babel документації, останнє, але не менш важливе, зміни в шаблонах вважаються налаштуванням і не покриваються нашою підтримкою.

Для наступних прикладів ми представимо здебільшого деякі функції дати. За замовчуванням використовується формат дати, визначений у налаштуваннях мови.

Доступ до цих налаштувань доступний лише тоді, коли ввімкнено режим розробника. Після того, як розробник увімкнено, перейдіть до Налаштування ‣ Переклади ‣ Мови та клацніть одну з мов, щоб переглянути всі параметри, такі як формат часу або формат дати, які використовуються мовою.

  • format_date() - форматує дату (без часу).

    Можна знайти на шаблоні Замовлення на купівлю: Надіслати замовлення на замовлення:

    Код format_date на існуючому шаблоні Закупівлі

    Результат буде виглядати так:

    Відображення format_date в існуючому шаблоні Закупівлі
  • format_datetime() - форматує дату й час, визначаючи конкретний часовий пояс, у даному випадку за центральноєвропейським часом (CET).

    Можна знайти на шаблоні Подія: Реєстрація.

    Код format_datetime на існуючому шаблоні Подія

    Результат буде виглядати так:

    Відтворення format_datetime на існуючому шаблоні Подія
  • format_time() – схожа на функцію format_datetime, за винятком того, що вона використовується лише для часу, а не для дати.

  • format_amount() – Форматує число, суму для відображення валюти залежно від налаштувань відображення, визначених для валюти (для перегляду цього має бути активовано режим налагодження функція) Облік ‣ Конфігурація ‣ Валюти (перед або після суми залежно від угоди).

    Код format_amount в існуючому шаблоні замовлення на продаж

    Який буде виглядати так:

    Відображення format_amount в існуючому шаблоні замовлення на продаж

Визначення відповіді за замовчуванням у вашому шаблоні ел. пошти

Незважаючи на те, що поле відповідь на доступне в шаблонах листів, це поле використовується лише для режиму масової розсилки (це означає, що під час надсилання шаблонів, що ми називаємо масовою розсилкою). Ви можете масово надсилати ел. листи майже в кожній програмі, яка має перегляд списку. Виберіть потрібні записи та натисніть кнопку дії. Якщо у вас є можливість надіслати ел. лист, ви побачите редактор листів із можливими значеннями для визначення:

Composer у режимі масової розсилки після вибору кількох цитат.

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

Поле для відповіді на шаблоні.

Через це встановлення значення в цьому полі є марним, оскільки визначене значення буде повністю проігноровано. Значення reply-to за замовчуванням — це адреса ел. пошти за замовчуванням для забезпечення зв’язку між вашим клієнтом і вашою базою даних Odoo. Щоб дізнатися більше про те, як працює catchall, перегляньте як керувати вхідними повідомленнями.

Транзакційні ел. листи та відповідна URL-адреса для кожної компанії

Під час використання Odoo кілька подій ініціюють надсилання автоматизованих ел. листів. Ці ел. листи називають транзакційними та іноді містять посилання на вашу базу даних Odoo.

За замовчуванням посилання, створені базою даних, використовують динамічний ключ web.base.url, визначений у системних параметрах. Більше інформації про цей параметр.

Якщо програму веб-сайту не встановлено, ключ web.base.url завжди буде параметром за замовчуванням, який використовується для створення всіх посилань.

Важливо знати, що цей ключ може мати лише одне значення, а це означає, що в середовищі бази даних кількох веб-сайтів/компанії, навіть якщо у вас є конкретне доменне ім’я для кожного веб-сайту, посилання створюватимуться для спільного доступу до документа або в транзакційній ел. пошті. може залишатися незмінним незалежно від веб-сайту/компанії, пов’язаної з надсиланням ел. листа/документа.

Це не завжди так, оскільки деякі додатки Odoo мають посилання в базі даних із програмою веб-сайту, тобто в цьому випадку, якщо для веб-сайтів визначено певний домен, URL-адреса, згенерована в шаблоні електронної пошти, використовуватиме визначений домен на відповідному сайті компанії.

Застереження

Документ, яким надано спільний доступ за допомогою додатків документів, завжди використовуватиме ключ web.base.url, оскільки документ, яким надано спільний доступ, не пов’язано з жодним конкретним веб-сайтом. Це означає, що URL-адреса завжди буде однаковою (значення ключа web.base.url), незалежно від компанії, з якої вона надіслана, це відоме обмеження!

З іншого боку, замовлення на продаж, зроблені клієнтом на одному з ваших веб-сайтів електронної комерції Odoo, мають посилання на веб-сайт, з якого було зроблено замовлення. У результаті ел. лист, надісланий для замовлень на продаж, використовує доменне ім’я, визначене для відповідного веб-сайту, для створення посилань.

Щоб дізнатися більше про те, як налаштувати ваші домени, ми запрошуємо вас переглянути нашу документацію щодо доменних імен.

Оновлення перекладів у шаблонах ел. листів

Шаблони ел. листів перекладаються автоматично. Змінювати переклади не потрібно. Однак, якщо з певної причини ви хочете змінити деякі переклади, це можна зробити.

Як і будь-яка модифікація коду, майте на увазі, що модифікації, зроблені неправильно (наприклад, модифікації, що призводять до неправильного синтаксису), можуть порушити шаблон, у результаті шаблон відображатиметься порожнім.

Щоб відредагувати свої переклади, виконайте такі кроки з шаблону.

  1. Натисніть кнопку редагування, а потім кнопку мови

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

    Переклад тіла шаблону додатка різними встановленими мовами.