Остальные параметры

    eForm: Остальные параметры

    Остальные параметры сниппета eForm для создание обратной связи, заказа звонка, оформление заказа товаров на Evolution CMS.

    Формат: email
    Значение по умолчанию: системный адрес
    Примечание: Можно использовать несколько адресов разделяя их запятой (,). Если не указано, то будет использован системный адрес.

    Пример:

    &to=`mail_1@ваш-домен.ru,mail_2@ваш-домен.ru`
    Формат: email
    Значение по умолчанию: системный адрес
    Примечание: Устанавливает адрес отправителя письма.

    Пример:

    &from=`mail@ваш-домен.ru`
    Формат: строка
    Значение по умолчанию: site_name
    Примечание:

    Пример:

    &fromname=`Администратор`
    Формат: email
    Значение по умолчанию: &to
    Примечание: Электронный адрес или поле содержащее адрес, который будет использован вписьме для ответа.

    Пример:

    &replyto=`mail@ваш-домен.ru`
    Формат: 0 | 1
    Значение по умолчанию: 0
    Примечание: Включает возможность использовать поле формы для определения адреса, по которому будет послано письмо.

    Пример:

    &sendirect=`1`
    Формат: email
    Значение по умолчанию: пусто
    Примечание:

    Пример:

    &cc=``
    Формат: email
    Значение по умолчанию: пусто
    Примечание:

    Пример:

    &bcc=``
    Формат: 0 | 1
    Значение по умолчанию: 0
    Примечание: По умолчанию установлено в 0. eForm ищет адрес пользователя в поле с названием email.

    Пример:

    &ccsender=`1`
    Формат: строка
    Значение по умолчанию: пусто
    Примечание: Тема сообщения, которая может включать поля формы. Может включать ((поля формы)).

    Пример:

    &subject=`Спасибо за ваш заказ ((firstname)) ((lastname))`
    Формат: 0 | 1
    Значение по умолчанию: 0
    Примечание: 1 - отключить отправку писем
    0 - включить отправку писем

    Пример:

    &noemail=`1`
    Формат: список email
    Значение по умолчанию: пусто
    Примечание: Устанавливает поле формы, которое будет использоваться при выборе единственного адреса из списка адресов разделенных запятой (,) для использования в параметре &to. Значения поля будет определять номер используемого почтового адреса. Номер 1 соответствует первому адресу и N - последнему. В форме используется поле topic в виде выпадающего списка. Когда пользователь выбирает значение, то тем самым он определяет один адрес, по которому будут посланы данные формы.
    &to=`sales@me.com,support@me.com,billing@me.com` &mailselector=`topic`

    Пример:

    &mailselector=``
    Формат: email
    Значение по умолчанию: пусто
    Примечание: Адрес почты мобильного устройства. Используется для отсылки короткого сообщения.

    Пример:

    &mobile=``
    Формат: Строка (чувствительна к регистру)
    Значение по умолчанию: пусто
    Примечание: Сообщение для отправки на мобильное устройство. Может содержать поля формы.

    Пример:

    &mobiletext=`Заказ для [+firstname+]`
    Формат: чанк | документ
    Значение по умолчанию: пусто
    Примечание: Имя чанка (не число) или идентификатор документа (число) дляи спользуемого шаблона сообщения выводимого пользователю после отправки данных формы.
    Доступны плэйсхолдеры:
    [+validationmessage+]
    [+postdate+]
    [+verimageurl+]
    [+debugText+]
    

    Пример:

    &thankyou=``
    Формат: id документа
    Значение по умолчанию: пусто
    Примечание: Идентификатор документа на который будет совершен переход после отправкиданных формы. Смотрите также &thankyou.

    Пример:

    &gotoid=`34`
    Формат: строка | категория
    Значение по умолчанию: пусто
    Примечание: Название или идентификатор категории используемый для категоризации eForm. Если категория не найдена, то она автоматически будет создана. Это используется в теме сообщения.

    Пример:

    &category=``
    Формат: список ключевых слов | список полей
    Значение по умолчанию: пусто
    Примечание: Разделяемые запятой (,) ключевые слова или поле формы используемое при поиске банка данных.

    Пример:

    &keywords=`[+firstname+],[+lastname+], [+email+]`
    Формат: email
    Значение по умолчанию: пусто
    Примечание: Адрес электронной почты, который показывается при отправке сообщения автоответчика.

    Пример:

    &autosender=`no-reply@mydomain.com`
    Формат: строка
    Значение по умолчанию: пусто
    Примечание: Имя, используемое в сообщении автоответчика.

    Пример:

    &autoSenderName=`name`
    Формат: чанк | документ
    Значение по умолчанию: пусто
    Примечание: Название чанка (не число) или идентификатор документа (число) для используемого шаблона в сообщении автоответчика. Может содержать поля формы.

    Пример:

    &automessage=`messageForm`
    Формат: 0 | 1
    Значение по умолчанию: 0
    Примечание: Включает использование пользователями HTML в сообщении. 1 - включено, 0 - выключено. Возможны XSS атаки, например если раззрешено в чанке thankyou.

    Пример:

    &allowhtml=`1`
    Формат: название языка
    Значение по умолчанию: english
    Примечание: Устанавливает используемый язык сообщений и проверки. Название языков совпадает с MODX.

    Пример:

    &language=``
    Формат: 0 | 1
    Значение по умолчанию: 0
    Примечание: Включает код проверки. Шаблон должен содержать поле для проверки и плэйсхолдер [+vericode+].

    Пример:

    &vericode=`1`
    Формат: 0 | 1
    Значение по умолчанию: 0
    Примечание: Включает расширенные сообщения об ошибках в проверке формы. В основном для отладки #LIST и #SELECT. 1 - включено, 0 - выключено.

    Пример:

    &debug=`1`
    Формат: 1 | report, autotext, mobile
    Значение по умолчанию: пусто
    Примечание: Определяет, какие сообщения будут использовать формат html.
    1 - все сообщения
    report, autotext, mobile - конкретные типы сообщений.

    Пример:

    &sendAsHtml=`report`
    Формат: 1 | report, autotext, mobile
    Значение по умолчанию: пусто
    Примечание: Определяет, какие сообщения будут использовать текстовый формат.
    1 - все сообщения
    report, autotext, mobile - конкретные типы сообщений.

    Пример:

    &sendAsText=`report`
    Формат: список переменных сессии
    Значение по умолчанию: пусто
    Примечание: Названия переменных сессии $_SESSION, разделенные запятой (,). Они будут добавлены в список значений полей перед отображением формы и могут быть использованы в качестве скрытых полей. Если вы используете этот параметр, то убедитесь, что вы не раскрываете важную информацию сессии (скрытые поля не защищают информацию!).
    Так как eForm не выполняет самостоятельную обработку таких значений, то вам необходимо включить их в шаблон.

    Пример:

    [!eForm &sessionVars=`jobID` ... !]
     

    Пример:

    &sessionVars=``
    Формат: 0 | 1
    Значение по умолчанию: 0
    Примечание: Используется в комбинации с &sessionVars. Переменные сессии будут переписаны введенными в форму значениями. При установке значения 1 полученные в форме данные получают приоритет.

    Пример:

    &postOverides=`1`
    Формат: 0 | 1
    Значение по умолчанию: 0
    Примечание: При установке значения `1` будут посылаться сообщения на специальный электронный адрес если будет замечена попытка инъекции eForm (используйте умеренно).

    Пример:

    &reportAbuse=`1`
    Формат: чанк | файл
    Значение по умолчанию: пусто
    Примечание: Добавляет определение стиля в область <head> страницы, на которой располагается форма или сообщение для пользователя показываемое после отправки (только если параметр &thankyou установлен). Значения могут быть в виде идентификатора документа (число), имени чанка или ссылки на таблицу стилей (относительная или абсолютная). Можно использовать несколько значений разделяя их запятыми (,) (фактически можно комбинировать все три вида значений).

    Пример:


    [!eForm &cssStyle=`assets/site/forms.css,chunkName` ... !]
    [!eForm &cssStyle=`chunkName` ... !]
    [!eForm &cssStyle=`http://saniock.com/css/forms.css` ... !]
    Примечание. Чанки (и документы, если установлен идентификатор документа) могут использовать значения в форме:
    1. как встроенный блок:
    <style>: <style type="text/css">/*какие-то стили*/</style>
    2. как ссылка на таблицу стилей:
    <link href="assets/site/forms.css" rel="stylesheet" type="text/css">
    3. как разделенный запятой (,) список ссылок на таблицы стилей:
    assets/site/forms.css,assets/site/more.css,assets/site/gone_overboard.css 

    Пример:

    &cssStyle=``
    Формат: чанк | файл
    Значение по умолчанию: пусто
    Примечание: Аналогично параметру cssStyle.
    [!eForm &jScript=`assets/site/forms.js,chunkName` ... !]
    [!eForm &jScript=`chunkName` ... !]
    [!eForm &jScript=`http://saniock.com/js/forms.js` ... !]

    Пример:

    &jScript=``
    Формат: 0 | 1 | список полей
    Значение по умолчанию: 1
    Примечание: Защита формы от повторной отправки с теми же данными. Отправка данных формы автоматически отключается после первой успешной попытки пока ключ формы является одним и тем же. Для этого используется переменная сеанса с md5 хэшем в качестве ключа. Какие поля используются для сравнения задается в параметре &protectSubmit. Возможные значения:
    0 - выключено
    1 - используются все поля `required`
    Список полей - список используемых полей через запятую.
    Чтобы гарантировать, что используются соответствующие поля для разных форм переменная сессии основана на &formid({formid}_hash).

    Пример:

    &protectSubmit=`0`
    Формат: 0 | минуты
    Значение по умолчанию: 0
    Примечание: Устанавливает лимит времени (в минутах) между отправками данных формы. После первой успешной отправки данных запрещает отправку других данных наопределенное время. При использовании совместно с &protectSubmit этот параметр имеет приоритет, позволяя повторную отправку данных независимо от установки &protectSubmit (будет сброшена сессионная переменная). Как и &protectSubmit этот параметр использует сессионную переменную основанную на &formid.

    Пример:

    &submitLimit=`10`
    Формат: CSS-класс
    Значение по умолчанию: пусто
    Примечание: Название класса. Добавляет класс в определенные поля формы при проверке. Существующие классы будут сохранены.
    Если вы уже определили класс для полей или меток (label) и получили неожиданные результаты, то проверьте порядок определения классов. &requiredClass устанавливается в начало любых классов, которые уже установлены.

    Пример:

    &requiredClass=``
    Формат: CSS-класс
    Значение по умолчанию: пусто
    Примечание: Название класса. Добавляет класс к неправильно заполненным полям формы, которые выявились при проверке. Существующие классы будут сохранены.

    Пример:

    &invalidClass=``
    Формат: сниппет
    Значение по умолчанию: пусто
    Примечание: Определяет имя сниппета. Сниппет будет выполнен перед всеми обработками eForm. Один параметр &formid, будет опущен для сниппета. Любые возвращенные значения из сниппета не будут учитываться. Это может быть использовано как альтернатива использования функций в документе. К сожалению eForm молча проигнорирует результат работы сниппета, так как &modx->runSnippet не возвращает никаких значений.

    Пример:

    &runSnippet=``
    Формат: путь от папки 'assets/snippets/'
    Значение по умолчанию: пусто
    Примечание: Для тех кто хочет оставить другие версии eForm активными. Теперь вы можете сохранить все файлы eForm и соответственно установить &snipFolder. Например вы можете сохранить версию 1.4.4 в папку assets/snippets/eform/1.4.4 и установить параметр:
    &snipFolder=`eform/1.4.4`
    К значению автоматически добавится путь 'assets/snippets/'. Не нужно использовать закрывающий слэш (/)!

    Пример:

    &snipFolder=`eform/1.4.4`
    Формат: имя поля
    Значение по умолчанию: пусто
    Примечание: Имя поля формы, которое содержит список имен файлов, разделенных запятыми. Эти файлы должны быть расположены в &attachmentFolder.

    Пример:

    &attachmentField=``
    Формат: путь
    Значение по умолчанию: пусто
    Примечание: Путь к папке (относительно MODX basepath), которая содержит файлы, указанные в &attachmentField. Не нужно использовать закрывающий слэш (/)!

    Пример:

    &attachmentFolder=``
    Формат: чанк | строка
    Значение по умолчанию: пусто
    Примечание: Имя чанка или текст, используемый в качестве шаблона для ошибок. Доступные плейсхолдеры:
    [+ef_message_text+]
    [+ef_wrapper+]

    Пример:

    &errorTpl=``
    Формат: чанк | строка
    Значение по умолчанию: пусто
    Примечание: Имя чанка или текст, используемый в качестве шаблона для списка необходимых полей. Доступные плейсхолдеры:
    [+ef_required_list+]

    Пример:

    &errorRequiredTpl=``
    Формат: чанк | строка
    Значение по умолчанию: пусто
    Примечание: Имя чанка или текст, используемый в качестве разделителя между двумя элементами в списке необходимых полей.

    Пример:

    &errorRequiredSeparator=`, `