Шаблони листів
From LimeSurvey Manual
Вступ
Шаблони листів використовуються для надсилання персоналізованих запрошень, нагадувань, підтверджень і листів реєстрації вашим учасникам (з таблиці учасників опитування). Ви також можете редагувати стандартні базові (або детальні) повідомлення адміністратора, які надсилаються адміністраторам опитування.
Шаблони листів: Налаштування > Меню опитування > Шаблони листів
Якщо у вас є дозвіл суперадміністратора (ви маєте доступ до загальних налаштувань вашої інсталяції LimeSurvey), ви можете змінити «Редактор HTML за замовчуванням» для всіх користувачів LimeSurvey. Щоб дізнатися більше, прочитайте наступний підрозділ вікі.
Увага : Якщо ви хочете використовувати спливний/inline HTML редактор, не забудьте увімкнути HTML-формат для листів із токенами! Цей параметр розташований у меню налаштувань вашого опитування, на вкладці Налаштування учасника.
Панель шаблонів листів
Панель шаблонів листів:
На знімку екрана вище використовується режим редактора «Вихідний код HTML». Щоб змінити його, перейдіть до налаштувань вашого особистого облікового запису.
Щоб редагувати текстові поля, перейдіть до налаштувань свого облікового запису та виберіть режим inline HTML редактора.
Користувачам або адміністраторам можна надсилати п’ять типів листів:
Запрошення
Ця функція використовується для масового надсилання листів усім учасникам опитування в таблиці учасників опитування, які ще не отримали запрошення пройти ваше опитування.
На панелі шаблонів листів ви можете редагувати повідомлення, яке надсилається учасникам опитування. Щоб дізнатися, які плейсхолдери листів можна використовувати, прочитайте наступний підрозділ вікі. Ви також можете використовувати ExpressionScript, щоб додатково налаштувати шаблон листа-запрошення.
Нагадування
Функція Нагадування дає змогу адміністраторам опитування нагадати учасникам з таблиці учасників опитування про необхідність пройти опитування.
Ви можете редагувати стандартний формат листа-нагадування на панелі шаблонів листів. Щоб дізнатися, які плейсхолдери листів можна використовувати, прочитайте наступний підрозділ вікі. ExpressionScript допоможе вам налаштувати основний текст цього шаблону листа.
Примітка: Нагадування буде надіслано лише тим учасникам у таблиці учасників опитування, у яких поле «Завершено» вимкнено. Це означає, що респондент ще не проходив опитування або не завершив його.
Підтвердження
Якщо використовуються токени і учасник заповнює опитування, на його/її електронну адресу буде надіслано лист із підтвердженням. Ви можете деактивувати цю функцію на панелі Налаштування учасника.
Натисніть вкладку Підтвердження, якщо хочете редагувати шаблон листа. Перегляньте плейсхолдери листів, щоб дізнатися, які з них можна використовувати в цьому типі листа. Ви також можете використовувати ExpressionScript, щоб налаштувати свій лист.
Реєстрація
Якщо ввімкнено режим закритого доступу (існує таблиця учасників опитування), це означає, що пройти відповідне опитування можуть лише ті учасники, які мають виділений запис і пов’язаний з ним унікальний код токена. Якщо ви дозволяєте учасникам публічно реєструватися в опитуванні, у таблиці учасників вашого опитування буде створено новий запис, щойно респондент надішле своє ім’я та електронну адресу. Скрипт, що працює у фоновому режимі, автоматично надішле відповідному респонденту лист реєстрації. Він містить URL-адресу з токеном, за якою має перейти щойно зареєстрований користувач.
Натисніть вкладку Реєстрація, щоб редагувати формат цього листа. Не забудьте спершу переглянути, які плейсхолдери листів можна використовувати в основному тексті. ExpressionScript дає змогу ще більше налаштувати основний текст, який ви хочете використати.
Базові та детальні повідомлення адміністратора
Щоб отримувати повідомлення адміністратора, натисніть вкладку Сповіщення та дані і введіть електронну адресу в поле «Надсилати базове повідомлення адміністратора на», а також іншу (або таку саму) в поле «Надсилати детальне повідомлення адміністратора на».
За замовчуванням єдина відмінність між ними полягає в додатковому плейсхолдері {ANSWERTABLE}, який включено до шаблону листа з детальним повідомленням адміністратора. Це дає змогу користувачу, який отримує такі листи, також переглядати надіслані відповіді. Йому не потрібно заходити в інсталяцію LimeSurvey.
Однак, використовуючи ExpressionScript і плейсхолдери листів, ви можете налаштувати ці два шаблони листів.
Поля шаблонів листів
Кожен шаблон листа містить:
- Тема листа: заголовок листа або пакета листів, які ви хочете надіслати;
- Тіло листа: текстове поле, що містить повідомлення, яке ви хочете надіслати учасникам. Воно може містити текст, зображення та плейсхолдери листів. ExpressionScript також можна використовувати для подальшого налаштування повідомлення, яке ви хочете доставити;
Примітка: Над вкладкою шаблонів листів відображається додаткова вкладка, якщо ваше опитування використовує додаткові мови. Якщо ви натиснете будь-яку вкладку мови, окрім вкладки мови за умовчанням, шаблони листів завантажать відповідні тексти цією мовою. Відкрийте кожен шаблон листа, щоб почати його редагування. Не забудьте натиснути кнопку Зберегти у верхній правій частині екрана, щоб зберегти зміни.
- Дії з листом: доступні дві дії:
- Скинути цей шаблон: після натискання HTML-код буде скинуто. Жоден текст не видаляється;
- Перевірити вирази: перевіряє логіку листа — чи правильно використано плейсхолдери. Наполегливо рекомендуємо використовувати цю функцію перед надсиланням пакета листів. Так ви побачите, чи правильно визначено плейсхолдери. У наведеному нижче прикладі є невелика одруківка — її виділено червоним.
Плейсхолдери листів
Увага : Зверніть увагу, що деякі плейсхолдери листів можна використовувати лише в певних шаблонах листів! Докладніше читайте нижче.
У шаблонах листів за умовчанням у тілі та/або темі листа використовуються різні плейсхолдери. Їхня роль — зв'язати лист, який ви хочете надіслати, з кожним учасником у вашому списку учасників опитування. Дані з таблиці учасників опитування (наприклад, електронна адреса, ім'я, прізвище, токен тощо) автоматично беруться та підставляються в різні унікальні листи перед надсиланням кожному учаснику з вашого списку учасників опитування.
Нижче наведено плейсхолдери листів, які можна використовувати в тілі повідомлення ваших шаблонів листів із запрошенням і нагадуванням. Під час надсилання листів ці плейсхолдери будуть замінені в попередньому перегляді листа із запрошенням/нагадуванням даними з вашого опитування та таблиці учасників опитування.
| {ADMINEMAIL} | Електронна адреса адміністратора опитування |
| {ADMINNAME} | Ім'я адміністратора опитування |
| {SURVEYNAME} | Назва вашого опитування |
| {SURVEYDESCRIPTION} | Опис вашого опитування |
Наведені нижче плейсхолдери дозволено використовувати в шаблонах листів із запрошенням/нагадуванням (у полях теми та/або тіла листа), і вони будуть замінені під час надсилання листів:
| {EMAIL} | Електронна адреса одержувача |
| {FIRSTNAME} | Ім'я |
| {LASTNAME} | Прізвище |
| {SURVEYURL} | URL-адреса для початку опитування — якщо ви надсилаєте HTML-листи, учаснику опитування буде показано повну URL-адресу |
| @@SURVEYURL@@ | URL-адреса для початку опитування — це «чисте» посилання. Використовуйте його, якщо хочете десь інтегрувати посилання у власні HTML-елементи (доступно у версії 1.90 і новіших) |
| {OPTOUTURL} | URL-адреса для деактивації надсилання листів щодо відповідного опитування — у HTML-версії шаблону листа буде показано повне посилання |
| {OPTINURL} | Якщо користувач доданий до чорного списку та хоче взяти участь у відповідному опитуванні, він має натиснути URL-адресу підписки, щоб знову отримувати запрошення/нагадування до опитування. |
| {GLOBALOPTOUTURL} | URL-адреса, за якою респондент може відмовитися від участі в центральному списку учасників цього сайту — у HTML-версії шаблону листа буде показано повне посилання |
| {TOKEN} | Токен для доступу до опитування |
| {USESLEFT} | Кількість використань токена, що залишилась |
| {VALIDFROM} | Дата, з якої токен дійсний |
| {VALIDUNTIL} | Дата, до якої токен дійсний |
| {EMAILSTATUS} | Використовується для пропуску листів під час надсилання. Статус листа за умовчанням — «OK». |
| {LANGUAGE} | Використовується для визначення мови листів і URL-адреси опитування в багатомовних опитуваннях |
| {SENT} | Дата надсилання запрошення у форматі ISO8601 з часом (Y-m-d H:i:s у PHP) |
| {REMINDERSENT } | Дата надсилання нагадування у форматі ISO8601 з часом (Y-m-d H:i:s у PHP) |
| {REMINDERCOUNT} | Кількість уже надісланих нагадувань |
| {COMPLETED } | Дата завершення опитування |
| {TID} | Внутрішній ID у таблиці токенів |
| {ATTRIBUTE_1} | Атрибут 1 |
| {ATTRIBUTE_2} | Атрибут 2 (...і так далі для інших полів атрибутів) |
Якщо ваше опитування не анонімне, плейсхолдери листів можна використовувати для додавання конкретних даних запису/учасника на панель текстових елементів опитування (наприклад, опис опитування, привітальне повідомлення, кінцеве повідомлення).
| {TOKEN:EMAIL} | Відображає електронну адресу учасника з таблиці учасників опитування |
| {TOKEN:FIRSTNAME} | Відображає ім'я учасника з таблиці учасників опитування |
| {TOKEN:LASTNAME} | Відображає прізвище учасника з таблиці учасників опитування |
| {TOKEN} | Відображає код токена учасника з таблиці учасників опитування |
| {TOKEN:ATTRIBUTE_1} | Відображає «Атрибут 1» учасника з таблиці учасників опитування |
| {TOKEN:ATTRIBUTE_2} | Відображає «Атрибут 2» учасника з таблиці учасників опитування (і так далі для інших полів атрибутів) |
Щоб дізнатися більше про атрибути, прочитайте наступний розділ вікі.Ці плейсхолдери листів також можна використовувати в шаблонах листів підтвердження та сповіщень для адміністратора.
Деякі плейсхолдери можна використовувати лише в шаблонах сповіщень для адміністратора. Зверніть увагу, що на електронну адресу адміністратора надсилатиметься один лист на кожну відповідь!
Нижче наведено деякі плейсхолдери, які можна використовувати лише на панелях сповіщень для адміністратора:
| {VIEWRESPONSEURL} | Відображає URL-адресу, яка перенаправляє до відповіді, надісланої респондентом |
| {EDITRESPONSEURL} | Відображає URL-адресу, яка перенаправляє на сторінку LimeSurvey, де можна редагувати відповіді, надіслані відповідним учасником опитування |
| {STATISTICSURL} | Натисніть цю URL-адресу, щоб перейти до статистики опитування |
| {ANSWERTABLE} | Якщо ви хочете показати надіслані відповіді учасника в сповіщенні для адміністратора, використовуйте цей плейсхолдер. Так вам більше не потрібно заходити у вашу інсталяцію LimeSurvey, щоб переглянути надіслані відповіді відповідного респондента (як це робить плейсхолдер {VIEWRESPONSEURL}). |
Поради:
- Якщо ваше опитування використовує анонімні відповіді, плейсхолдери, пов'язані з токенами, не працюватимуть у шаблоні листа сповіщення.
- Ви можете використовувати ExpressionScript для застосування виразів під час налаштування листа (New in 1.92 ). Приклад дивіться в інструкціях з ExpressionScript.
- Також перегляньте приклади використання інформації з таблиці учасників опитування.
Відмова учасника від листів
Якщо ви використовуєте тег {OPTOUTURL} у листі із запрошенням/нагадуванням, ваші учасники можуть відмовитися від участі в цьому опитуванні, натиснувши відповідну URL-адресу в листі — тож ви не надсилатимете їм нагадувань. Учаснику, який відмовився від участі у вашому опитуванні, буде встановлено статус листа «OptOut» у списку учасників опитування.
Чиста URL-адреса (Barebone URL)
URL-плейсхолдери мають відповідні «чисті» URL-адреси (Barebone URL). Наприклад, @@SURVEYURL@@: ви можете використовувати @@OPTOUTURL@@, @@OPTINURL@@ …
Використання функції заміни
У шаблонах листів можна використовувати певні ключові слова. Наприклад, деякі ключові слова можна використовувати для заміни URL-адреси токена.
У наведеному нижче прикладі використовується звичайне посилання на опитування замість довгої URL-адреси:
1) Спочатку перейдіть до панелі шаблонів листів і виберіть Запрошення.
2) Напишіть текст, який має відображатися як посилання для початку опитування.
3) Потім виділіть цей текст.
4) Додайте заповнювач для простого посилання @@SURVEYURL@@ і виберіть «other» у списку вибору протоколу.
Тепер, коли ви надсилатимете листи із запрошеннями, посилання для початку опитування буде коротшим.
Вкладення до листів
Дії з файлами
Після натискання Додати файл відобразиться таке вікно, в якому потрібно вибрати документ із папки файлів, який ви хочете надіслати електронною поштою:
Вкладення можна додати внизу інтерфейсу редагування шаблону листа. Зверніть увагу, що вкладення до листів завантажуються окремо для кожного опитування.
Ви також можете одразу завантажити файл зі свого комп’ютера до вашого встановлення LimeSurvey, натиснувши кнопку Завантажити, а потім вибравши файл, який потрібно прикріпити до відповідного шаблону листа.
Після вибору двічі клацніть на файлі, і він одразу з’явиться в таблиці Файли під кнопкою Додати файл:
Щоб файл залишився прикріпленим до відповідного шаблону електронного листа, не забудьте натиснути кнопку Зберегти, розташовану у верхній правій частині вікна.
Щоб визначати, чи слід надсилати вкладення в індивідуальному порядку, до кожного вкладення можна додати рівняння релевантності.
Можна використовувати всі функції, які підтримує ExpressionScript, а також атрибути токенів, якщо в опитуванні використовуються токени.
У шаблонах сповіщень або підтвердження також можна використовувати коди питань, що використовуються в опитуванні.
Якщо ви хочете видалити файл, натисніть червону кнопку з кошиком у стовпці «Дія» та збережіть зміни.
Увага :
- Якщо файл не вдається знайти у файловій системі, лист буде надіслано без вкладення.
- Експорт/імпорт опитування не експортує та не імпортує прикріплені завантажені файли. Проте налаштування вкладень, а також рівняння релевантності буде збережено.
Вкладення зображень
Ви можете прикріпити одне або кілька зображень, якщо надсилаєте HTML-листи. Для цього потрібно оновити URL-джерело зображення, вказавши шлях до нього у вашій публічній директорії встановлення LimeSurvey.
Джерело має бути вказане відносно вашої публічної директорії на сервері. Якщо ваше встановлення LimeSurvey розміщене в піддиректорії, зображення не відображатиметься у вашому HTML редакторі.