Шаблоны сообщений
From LimeSurvey Manual
Введение
Шаблоны сообщений используются для отправки персонализированных приглашений, напоминаний, подтверждений и сообщений о регистрации вашим участникам (из таблицы участников опроса). Вы также можете редактировать стандартные краткие (или детализированные) уведомления администратору, которые отправляются администраторам опроса.
Шаблоны сообщений: Настройки > Меню опроса > Шаблоны сообщений
Если у вас есть разрешение суперадминистратора (вы имеете доступ к общим настройкам вашей установки LimeSurvey), вы можете изменить параметр «Редактор HTML по-умолчанию» для всех ваших пользователей LimeSurvey. Подробнее читайте в следующем подразделе вики.
Внимание : Если вы хотите использовать всплывающий/встроенный HTML-редактор, не забудьте включить HTML-формат для сообщений с токенами! Эта опция находится в меню Настройки вашего опроса, на вкладке Настройки участников.
Панель шаблонов сообщений
Панель шаблонов сообщений:
На приведённом выше снимке экрана используется режим редактора «HTML код». Чтобы изменить его, перейдите в настройки вашей учётной записи.
Чтобы редактировать текстовые поля, перейдите в настройки своей учётной записи и выберите режим «Встроенный HTML-редактор».
Пользователям или администраторам можно отправлять пять типов сообщений:
- Приглашение
- Напоминание
- Подтверждение
- Регистрация
- Краткие и детализированные уведомления администратора
Приглашение
Эта функция используется для массовой отправки сообщений всем участникам опроса из таблицы участников опроса, которые ещё не получили приглашение пройти ваш опрос.
На панели шаблонов сообщений вы можете редактировать сообщение, отправляемое участникам опроса. Чтобы узнать, какие плейсхолдеры можно использовать, прочитайте следующий подраздел вики. Вы также можете использовать ExpressionScript для дополнительной настройки шаблона сообщения с приглашением.
Напоминание
Функция Напоминание позволяет администраторам опроса напомнить участникам из таблицы участников опроса о необходимости пройти опрос.
Вы можете редактировать формат напоминания по умолчанию на панели шаблонов сообщений. Чтобы узнать, какие плейсхолдеры можно использовать, прочитайте следующий подраздел вики. ExpressionScript поможет вам настроить основной текст этого шаблона сообщения.
Примечание: Напоминание будет отправлено только тем участникам из таблицы участников опроса, у которых поле «Завершено» отключено. Это означает, что респондент либо не начинал, либо не завершил опрос.
Подтверждение
Если используются токены и участник заполняет опрос, на его/её адрес e-mail будет отправлено сообщение с подтверждением. Вы можете деактивировать эту функцию на панели Настройки участников.
Нажмите на вкладку Подтверждение, если хотите отредактировать шаблон сообщения. Просмотрите плейсхолдеры сообщений, чтобы узнать, какие из них можно использовать в сообщениях этого типа. Вы также можете использовать ExpressionScript для настройки сообщения.
Регистрация
Если включён режим закрытого доступа (то есть существует таблица участников опроса), это означает, что пройти соответствующий опрос могут только те участники, у которых есть выделенная запись и связанный с ней уникальный код токена. Если вы разрешаете участникам публично регистрироваться для участия в опросе, то после того как респондент отправит своё имя и адрес e-mail, в таблице участников вашего опроса будет создана новая запись. Скрипт, работающий в фоновом режиме, автоматически отправит этому респонденту уведомление о регистрации. Оно содержит URL с токеном, по которому должен перейти только что зарегистрированный пользователь.
Нажмите на вкладку Регистрация, чтобы изменить формат этого сообщения. Не забудьте сначала посмотреть, какие плейсхолдеры сообщений можно использовать в основном тексте. ExpressionScript позволяет дополнительно настроить основной текст, который вы хотите использовать.
Краткие и детализированные уведомления администратора
Чтобы получать уведомления администратора, нажмите на вкладку Уведомления и данные и введите адрес e-mail в поле «Отправить простое уведомление администратору на email», а другой (или тот же) — в поле «Отправить детальное уведомление администратору на email».
По умолчанию единственное различие между ними связано с дополнительным плейсхолдером {ANSWERTABLE}, который включён в шаблон детализированного уведомления администратора. Он позволяет пользователю, получающему такие сообщения, также просматривать отправленные ответы. Ему не нужно заходить в установленную систему LimeSurvey.
Однако с помощью ExpressionScript и плейсхолдеров сообщений вы можете настроить эти два шаблона сообщений.
Поля шаблонов сообщений
Каждый шаблон сообщения содержит:
- Тема сообщения: заголовок сообщения или группы сообщений, которые вы хотите отправить;
- Текст сообщения: Текстовая панель, содержащая текст сообщения, которое вы хотите отправить участникам. Он может включать текст, изображения и плейсхолдеры сообщений. Для дополнительной настройки сообщения также можно использовать ExpressionScript;
Примечание: Если в вашем опросе используются дополнительные языки, над вкладкой шаблонов сообщений отображается ещё одна вкладка. Если нажать на вкладку любого языка, кроме языка по умолчанию, в шаблонах сообщений загрузятся тексты на соответствующем языке. Откройте каждый шаблон сообщения, чтобы начать его редактирование. Не забудьте нажать кнопку Сохранить в правой верхней части экрана, чтобы сохранить изменения.
- Действия с сообщением: Доступны два действия:
- Очистить этот шаблон: после нажатия HTML-код сбрасывается. Текст при этом не удаляется;
- Проверить выражения: проверяет логику сообщения, то есть правильно ли использованы плейсхолдеры. Настоятельно рекомендуем использовать эту функцию перед отправкой группы сообщений. Так вы увидите, правильно ли определены плейсхолдеры. В примере ниже есть небольшая опечатка — она выделена красным.
Плейсхолдеры сообщений
Внимание : Обратите внимание, что некоторые плейсхолдеры можно использовать только в определённых шаблонах сообщений! Подробности см. ниже.
В шаблонах сообщений по умолчанию в теме и/или тексте сообщения используются различные плейсхолдеры. Их задача — связать сообщение, которое вы хотите отправить, с каждым участником из вашего списка участников опроса. Данные из таблицы участников опроса (например, e-mail, имя, фамилия, токен и т. д.) автоматически берутся и подставляются в отдельные уникальные сообщения перед отправкой каждому участнику из списка участников опроса.
Ниже приведены плейсхолдеры, которые можно использовать в тексте ваших шаблонов сообщений приглашения и напоминания. При отправке сообщений эти плейсхолдеры будут заменены в предварительном просмотре приглашения/напоминания данными из вашего опроса и таблицы участников опроса.
| {ADMINEMAIL} | E-mail администратора опроса |
| {ADMINNAME} | Имя администратора опроса |
| {SURVEYNAME} | Название вашего опроса |
| {SURVEYDESCRIPTION} | Описание вашего опроса |
Следующие плейсхолдеры допустимы в шаблонах сообщений приглашения/напоминания (в полях темы и/или текста) и будут заменены при отправке сообщений:
| {EMAIL} | E-mail получателя |
| {FIRSTNAME} | Имя |
| {LASTNAME} | Фамилия |
| {SURVEYURL} | URL-адрес для начала опроса — при отправке HTML-сообщений участнику опроса будет показан полный URL-адрес |
| @@SURVEYURL@@ | URL-адрес для начала опроса — это «чистая» ссылка. Используйте её, если хотите где-либо встроить ссылку в собственные HTML-элементы (доступно начиная с версии 1.90) |
| {OPTOUTURL} | URL-адрес для отключения отправки сообщений по данному опросу — в HTML-версии шаблона сообщения будет показана полная ссылка |
| {OPTINURL} | Если пользователь внесён в чёрный список и хочет участвовать в данном опросе, ему нужно перейти по URL-адресу подписки, чтобы снова получать приглашения/напоминания. |
| {GLOBALOPTOUTURL} | URL-адрес, по которому респондент может отказаться от участия в центральном списке участников этого сайта — в HTML-версии шаблона сообщения будет показана полная ссылка |
| {TOKEN} | Токен для доступа к опросу |
| {USESLEFT} | Количество оставшихся использований токена |
| {VALIDFROM} | Дата, с которой токен действителен |
| {VALIDUNTIL} | Дата, до которой токен действителен |
| {EMAILSTATUS} | Используется для пропуска сообщений при отправке. Статус e-mail по умолчанию — «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} | Отображает e-mail участника из таблицы участников опроса |
| {TOKEN:FIRSTNAME} | Отображает имя участника из таблицы участников опроса |
| {TOKEN:LASTNAME} | Отображает фамилию участника из таблицы участников опроса |
| {TOKEN} | Отображает код токена участника из таблицы участников опроса |
| {TOKEN:ATTRIBUTE_1} | Отображает «Атрибут 1» участника из таблицы участников опроса |
| {TOKEN:ATTRIBUTE_2} | Отображает «Атрибут 2» участника из таблицы участников опроса (и так далее для других полей атрибутов) |
Чтобы узнать больше об атрибутах, прочитайте следующий раздел вики.Эти плейсхолдеры также можно использовать в шаблонах сообщений подтверждения и уведомлений администратора.
Некоторые плейсхолдеры можно использовать только в шаблонах уведомлений администратора. Обратите внимание: на адрес e-mail администратора отправляется одно сообщение на каждый ответ!
Ниже перечислены некоторые плейсхолдеры, которые можно использовать только в панелях уведомлений администратора:
| {VIEWRESPONSEURL} | Отображает URL-адрес, который перенаправляет вас к отправленному ответу респондента |
| {EDITRESPONSEURL} | Отображает URL-адрес, который перенаправляет вас на страницу LimeSurvey, где можно редактировать ответы, отправленные соответствующим участником опроса |
| {STATISTICSURL} | Перейдите по этому URL-адресу, чтобы открыть статистику опроса |
| {ANSWERTABLE} | Используйте этот плейсхолдер, если хотите отображать отправленные ответы участника в уведомлении администратора. Так вам больше не нужно заходить в вашу установку LimeSurvey, чтобы просмотреть отправленные ответы данного респондента (как это делает плейсхолдер {VIEWRESPONSEURL}). |
Подсказки:
- Если в вашем опросе используются анонимные ответы, плейсхолдеры, связанные с токенами, не будут работать в шаблоне уведомления.
- Вы можете использовать ExpressionScript для применения выражений при настройке сообщения (New in 1.92 ). Пример см. в практических руководствах по ExpressionScript.
- Также посмотрите примеры использования информации из таблицы участников опроса.
Отказ участника от рассылки
Если вы используете тег {OPTOUTURL} в сообщении приглашения/напоминания, ваши участники могут отказаться от участия в данном опросе, перейдя по соответствующему URL-адресу в сообщении, и тогда вы не будете отправлять им напоминания. Для участника, отказавшегося от опроса, в списке участников опроса будет установлен статус e-mail «OptOut».
«Чистый» URL-адрес
У плейсхолдеров URL-адресов есть соответствующие «чистые» URL-адреса. Например, для @@SURVEYURL@@ можно использовать @@OPTOUTURL@@, @@OPTINURL@@ …
Использование функции замены
В шаблонах сообщений можно использовать некоторые специальные ключевые слова. Например, с их помощью можно заменить URL-адрес токена.
В примере ниже вместо длинного URL-адреса используется обычная ссылка на опрос:
1) Сначала откройте панель «Шаблоны сообщений» и выберите Приглашение.
2) Напишите текст, который будет отображаться как ссылка для начала опроса.
3) Затем выделите этот текст.
4) Добавьте заполнитель для простой ссылки @@SURVEYURL@@ и выберите «other» в выпадающем списке протоколов.
Теперь при рассылке приглашений ссылка для начала опроса будет короче.
Вложения в сообщениях
Действия с файлами
После нажатия кнопки Добавить файл откроется следующее окно, в котором нужно выбрать документ из папки файлов, который вы хотите отправить по e-mail:
Вложения можно добавить в нижней части интерфейса редактирования шаблона сообщения. Обратите внимание: вложения загружаются для каждого опроса отдельно.
Вы также можете сразу загрузить файл с компьютера в вашу установку LimeSurvey, нажав кнопку Загрузить, а затем выбрав файл, который хотите прикрепить к соответствующему шаблону сообщения.
После выбора дважды щёлкните по файлу, и он сразу появится в таблице Файлы под кнопкой Добавить файл:
Чтобы файл оставался постоянно прикреплённым к соответствующему шаблону сообщения, не забудьте нажать кнопку Сохранить в правом верхнем углу окна.
Чтобы определять, нужно ли отправлять вложение в каждом конкретном случае, можно добавить к каждому вложению уравнение условия.
Можно использовать все функции, поддерживаемые ExpressionScript, а также атрибуты токенов, если в опросе используются токены.
В шаблонах уведомлений и подтверждений также можно использовать коды вопроса, применяемые в опросе.
Чтобы удалить файл, нажмите красную кнопку с корзиной в столбце «Действие» и сохраните изменения.
Внимание :
- Если файл не найден в системе файлов, сообщение будет отправлено без вложения.
- Экспорт/импорт опроса не экспортирует и не импортирует прикреплённые загруженные файлы. Однако настройки вложений, а также уравнения условия сохраняются.
Вложение изображения
Изображения можно прикреплять, если вы отправляете сообщения в формате HTML. Для этого необходимо изменить источник URL изображения, указав путь к нему в общедоступной (public) папке вашей установки LimeSurvey.
Источник должен быть указан относительно общедоступной (public) папки на сервере. Если ваша установка LimeSurvey находится в подкаталоге, изображение не будет отображаться в редакторе HTML.