Разделы

Параметры eForm

Быстрый поиск: Искать в описании
развернуть все / свернуть все

Параметр	Описание	Формат	По-умолчанию
allowhtml	Использовать HTML в письме	0 \| 1	0
Включает использовании пользователями HTML в сообщении. 1 - включено 0 - выключено
autoSenderName	Имя для автоответчика	строка
Имя, используемое в сообщении автоответчика.
automessage	Сообщение автоответчика	чанк \| документ
Название чанка (не число) или идентификатор документа (число) дляиспользуемого шаблона в сообщении автоответчика. Может содержать [.поля формы.].
autosender	Адрес автоответчика	email
Адрес электронной почты, который показывается при отправке сообщенияавтоответчика. Например: no-reply@mydomain.com
bcc	Также как &email но для Bcc	email
Также как &email нодля Bcc
category	Название категории	строка \| категория
Название или идентификатор категории используемый для категоризации eForm. Если категория не найдена, тоона автоматически будет создана. Это используется в теме сообщение.
cc	Также как &email но для Cc	email
Также как &email нодля Cc
ccsender	Послать копию данных формы пользователю	0 \| 1	0
По умолчанию установлено в 0. eForm ищетадрес пользователя в поле с названием email. 1 - включить 0 - отключено
cssStyle	Добавление CSS-стилей на страницу	чанк \| файл
Добавляет определение стиля в область <head> страницы, на которойрасполагается форма или сообщение для пользователя показываемое после отправки(только если параметр &thankyouустановлен). Значения могут быть в виде идентификатора документа (число), именичанка или ссылки на таблицу стилей (относительная или абсолютная). Можноиспользовать несколько значений разделяя их запятыми (,) (фактически можнокомбинировать все три вида значений). Примеры: [!eForm &cssStyle=`assets/site/forms.css,chunkName` ... !] [!eForm &cssStyle=`chunkName` ... !] [!eForm &cssStyle=`http://mysite.com/assets/styles/forms.css` ... !] Чанки (и документы, если установлен идентификатор документа) могутиспользовать значения в форме: как встроенный блок <style>: <style type="text/css">/какие-то стили/</style> как ссылка на таблицу стилей: <link href="assets/site/forms.css" rel="stylesheet" type="text/css"> как разделенный запятой (,) список ссылок на таблицы стилей: assets/site/forms.css,assets/site/more.css,assets/site/gone_overboard.css
debug	Режим отладки	0 \| 1	0
Включает расширенные сообщения об ошибках в проверке формы. В основномдля отладки #LIST и #SELECT. Значения: 1 - включено 0 - выключено
eFormOnBeforeFormMerge	Событие до определения плэйсхолдеров шаблона	функция
Определяет название функции. Эта функция будет запущена только при показеформ и до определения всех переменных шаблона. Функции передаются следующиепараметры: &$fields - массив полей и значений переменных.
eFormOnBeforeMailSent	Событие после проверки формы и перед отправкой отчета	функция
Определяет название функции. Эта функция будет запущена после того какформа будет проверена и перед отчетом и сообщением для пользователя, а такжеотправкой любых сообщений.
eFormOnMailSent	Событие после отправки писем	функция
Определяет название функции. Эта функция будет запущена после обработкивсех шаблонов и любое сообщение будет послано.
eFormOnValidate	Событие после проверки данных формы	функция
Определяет название функции. Эта функция будет запущена после проверкиданных формы. Это можно использовать для определения собственного алгоритмаобработки. Функции передаются следующие параметры: &$fields - массив полей и значений переменных &$vMsg - числовой массив ошибок проверки данных формы &$rMsg - числовой массив пропущенных обязательных полей
eformOnBeforeFormParse	Событие после загруки шаблона	функция
Определяет название функции. Эта функция будет запущена после загрузкишаблонов и определения идентификатора формы. Функции передаются следующиепараметры: &$templates - массив всех шаблонов с индексами 'tpl','report','thankyou' и 'autotext'. Последние три будут иметь значение толькопосле отправки формы.
formid	Идентификатор формы	строка
Идентификатор формы используется при отправкеданных. Этот параметр необходим если на странице используется более однойформы. Шаблон формы должен иметь скрытое поле с тем же идентификатором: <input type="hidden" name="formid"value="formName" /> или (начиная с eForm 1.4.x) можноустановить идентификатор прямо в теге формы: <form id="formName"...>;
from	Адрес отправителя письма	email	системный адрес
Устанавливает адрес отправителя письма.
fromname	Имя отправителя письма	строка	пусто
Устанавливает имя отправителя письма.
gotoid	Переход на документ после отправки формы	документ
Идентификатор документа на который будет совершен переход после отправкиданных формы. Смотрите также &thankyou.
invalidClass	Добавление CSS-класса к неправильно заполненным полям	CSS-класс
Название класса. Добавляет класс к неправильно заполненным полям формы,которые выявились при проверке. Существующие классы будут сохранены.
jScript	Добавление JavaSript на страницу	чанк \| файл
Примеры: [!eForm &jScript=`assets/site/forms.js,chunkName` ... !] [!eForm &jScript=`chunkName` ... !] [!eForm &jScript=`http://mysite.com/assets/styles/forms.js` ... !]
keywords	Ключевые слова или поля для поиска	список ключевых слов \| список полей
Разделяемые запятой (,) ключевые слова или [+поле формы+]используемое при поиске банка данных. Например: [+firstname+],[+lastname+], [+email+]
language	Язык	название языка	english
Устанавливает используемый язык сообщений и проверки. Название языковсовпадает с MODx.
mailselector	определение адресата по значению поля	список email
Устанавливает поле формы, которое будет использоваться при выбореединственного адреса из списка адресов разделенных запятой (,) дляиспользования в параметре &to. Значения поля будет определятьномер используемого почтового адреса. Номер 1 соответствует первому адресу и N - последнему. Пример: &to=`sales@me.com,support@me.com,billing@me.com` &mailselector=`topic` В форме используется поле topic в виде выпадающего списка. Когдапользователь выбирает значение, то тем самым он определяет один адрес, покоторому будут посланы данные формы.
mobile	Адрес почты мобильного устройства	email
Адрес почты мобильного устройства. Используется для отсылки короткогосообщения.
mobiletext	Сообщение для отправки на мобильное устройство	Строка (чувствительна к регистру)
Сообщение для отправки на мобильное устройство. Может содержать [.поляформы.]. Например: Заказ для [.firstname.].
noemail	Запретить отправку писем	0 \| 1	0
Значения: 1 - отключить отправку писем 0 - включить отправку писем
postOverides	Приоритет получаемых данных над сессионными	0 \| 1	0
Используется в комбинации с &sessionVars. Переменные сессии будутпереписаны введенными в форму значениями. При установке значения 1 полученные вформе данные получают приоритет.
protectSubmit	Защита от повторной отправки	0 \| 1 \| список полей	1
Защита формы от повторной отправки с теми же данными. Отправка данныхформы автоматически отключается после первой успешной попытки пока ключ формыявляется одним и тем же. Для этого используется переменной сеанса с md5 хэшем в качестве ключа. Какиеполя используются для сравнения задается в параметре &protectSubmit.Возможные значения: 0 - выключено 1 - используются все поля `required` Список полей - список используемых полей через запятую. Чтобы гарантировать, что используются соответствующие поля для разныхформ переменная сессии основана на &formid({formid}_hash).
replyto	Адрес для ответа	email	&to
Электронный адрес или поле содержащее адрес, который будет использован вписьме для ответа.
report	Шаблон отчета	чанк \| документ
Название чанка (не число) или идентификатор документа (число) для шаблонаотчета.
reportAbuse	Оповещение о попытках инъекции	0 \| 1	0
При установке значения `1` будут посылаться сообщения на специальныйэлектронный адрес если будет замечена попытка инъекции eForm (используйте умеренно).
requiredClass	Добавление CSS-класса к обязательным полям при проверке	CSS-класс
Название класса. Добавляет класс в определенные поля формы при проверке.Существующие классы будут сохранены. Примечание: Есливы уже определили класс для полей или меток (label) и получили неожиданные результаты, то проверьте порядок определенияклассов. &requiredClass устанавливается в начало любых классов, которыеуже установлены.
runSnippet	Сниппет выполняемый перед работой eForm	сниппет
Определяет имя сниппета. Сниппет будет выполнен перед всеми обработками eForm.Один параметр &&formid, будет опущен для сниппета.Любые возвращенные значения из сниппета не будут учитываться. Это может бытьиспользовано как альтернатива использования функций в документе. К сожалению eFormмолча проигнорирует результат работы сниппета, так как $modx->runSnippet невозвращает никаких значений.
sendAsHtml	Какие сообщения используют HTML	1 \| report, autotext, mobile
Определяет, какие сообщения будут использовать формат html. 1 - все сообщения report, autotext, mobile - конкретные типы сообщений
sendAsText	Какие сообщения используют текстовый формат	1 \| report, autotext, mobile
Определяет, какие сообщения будут использовать текстовый формат. 1 - все сообщения report, autotext, mobile - конкретные типы сообщений
sendirect	Поле формы для получения адреса отправки	0 \| 1	0
Включает возможность использовать поле формы для определения адреса, покоторому будет послано письмо. 1 - включение 0 - выключение
sessionVars	Названия переменных сессии	список переменных сессии
Названия переменных сессии $_SESSION,разделенные запятой (,). Они будут добавлены в список значений полей передотображением формы и может быть использована качестве скрытых полей. Если выиспользуете этот параметр, то убедитесь, что вы не раскрываете важнуюинформацию сессии (скрытые поля не защищают информацию!). Так как eForm не выполняетсамостоятельную обработку таких значений, то вам необходимо включить их вшаблон. Пример: [!eForm &sessionVars=`jobID` ... !] <input type="hidden" value="[+jobID+]" />
snipFolder	Путь к папке сниппета eForm	путь от папки 'assets/snippets/'
Для тех кто хочет использовать оставить другие версии eForm активными.Теперь вы можете сохранить все файлы eForm исоответственно установить &snipFolder.Например вы можете сохранить версию 1.4.4 в папку assets/snippets/eform/1.4.4 иустановить &snipFolder=`eform/1.4.4`. К значению автоматически добавится путь 'assets/snippets/'. Не нужно использовать закрывающий слэш (/)!
subject	Тема сообщения	строка
Тема сообщения, которая может включать [.поля формы.]. Например: Спасибоза ваш заказ [.firstname.] [.lastname.]
submitLimit	Лимит времени на повторную отправку формы	0 \| минуты	0
Устанавливает лимит времени (в минутах) между отправками данных формы.После первой успешной отправки данных запрещает отправку других данных наопределенное время. При использовании совместно с &protectSubmit этот параметр имеет приоритет, позволяяповторную отправку данных независимо от установки &protectSubmit (будетсброшена сессионная переменная). Как и &protectSubmit этот параметриспользует сессионную переменную основанную на &formid.
thankyou	Сообщение выводимое после отправки данных	чанк \| документ
Название чанка (не число) или идентификатор документа (число) дляиспользуемого шаблона сообщения выводимого пользователю после отправки данныхформы. Доступны плэйсхолдеры: [\+validationmessage+] [\+postdate+] [\+verimageurl+] [\+debugText+\].
to	Адрес Email для отправки информации	email	системный адрес
Можно использовать несколько адресовразделяя их запятой (,). Если не указано, то будет использован системный адрес.
tpl	Шаблон формы	чанк \| документ \| сниппет
Название чанка (не число) или идентификатор документа (число) дляиспользуемого шаблона (новое в 1.4.4) Можно также использовать сниппет какисточник шаблона. При этом никакие параметры не передаются. Для регулярныхполей формы не нужно включать переменные, так как они автоматическивключаются eForm,исключая случаи когда вы сами задаете значения. Доступны плэйсхолдеры: [+validationmessage+] [+postdate+] [+verimageurl+] [+debugText+\]. Каждая форма должна содержать плэйсхолдер [\+validatiomessage+].
vericode	Использование капчи	0 \| 1	0
Включает код проверки. Шаблон должен содержать поле для проверки и плэйсхолдер [+vericode+]. 1 - включено 0 - выключено

Авторизация

Разделы

Параметры eForm

Рекламная информация