Інші параметри

    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`
    Формат: чанк | файл
    Значення за замовчуванням: пусто
    Примітка: Додає визначення стилю в область & lt; head & gt; сторінки, на якій розташовується форма або повідомлення для користувача показуване після відправки (тільки якщо параметр & 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=`, `