Документация InstantCMS

для администраторов и разработчиков

Инструменты пользователя

Инструменты сайта


manual:components:forms

Компонент "Конструктор форм"

Панель управленияКомпонентыКонструктор форм

Описание

Компонент представляет собой простой конструктор форм. Созданные в нём формы вы можете использовать:

  • Выводить форму в одноимённом виджете;
  • Встраивать созданные формы на сторонние сайты, используя код вставки;
  • Встраивать формы шорткодами в поля «Текст» и «Текст HTML» типов контента, а также в опции настроек типа контента «Выводить HTML в конце записи».

Настройки компонента

Разрешить шорткоды

Опция разрешает использование шорткодов в полях «Текст» и «Текст HTML» типов контента.

Разрешить коды для встраивания на другие сайты

Опция разрешает встраивать формы на другие сайты. После её включения в списке форм появятся поля с кодом для вставки. Вставляйте этот код в нужное место стороннего сайта и форма будет там выведена.

Если эта опция включена, в дочерних опциях вы можете задать список сайтов (доменов), для которых эти формы будут разрешены. Проверяется по реферу запроса.

Текст по умолчанию после отправки формы

После отправки формы (нажатие на кнопку «Отправить») поверх формы будет показ этот текст. Для каждой формы этот текст можно переопределить в её настройках. В поле допустимо использовать выражения {form_title}, {form_data}, {ip}. Что будет означать, соответственно, название формы, все отправленные данные из формы и ip адрес отправителя.

Шаблон email по умолчанию

Если форма отправляется на email, текст в этом поле и будет содержимым письма. Допустимые выражения:

  • {form_title} - название формы;
  • {form_data} - все отправленные данные из формы;
  • {ip} - ip адрес отправителя
  • {site} - название сайта;
  • {date} - дата отправки;
  • {time} - время отправки.

Шаблон уведомления по умолчанию

Если форма отправляется как уведомление на сайте, текст будет содержимым этого уведомления.

Создание формы

Настройки

При создании формы указываются опции:

  • Системное имя формы. Будет использоваться в шорткодах и в URL формы на странице, если это разрешено;
  • Название;
  • Описание;
  • Шаблон формы. По умолчанию используется /templates/ШАБЛОН/assets/ui/form.tpl.php. Если хотите сделать свой шаблон, имя файла должно начинаться на form, после этого он появится в этой опции для выбора.
  • Показывать заголовок;
  • Доступна по ссылке - если включено, то форма будет доступна по ссылке /forms/системное_имя_формы;
  • Скрывать форму после отправки - если включено, то форму можно будет отправить один раз, а после отправки форма будет перекрываться блоком с сообщением после отправки. После перезагрузки страницы форма не будет показана.
  • Куда отправлять форму. Доступны три опции: уведомление на сайте, email, автору записи. При включении опций будут показаны дополнительные поля, где нужно будет указать получателей и изменить при необходимости шаблоны уведомления и email, заданные в общих настройках. Помимо выражений, которые описаны в опциях выше, вы можете использовать выражения ​{page_url} и {user_name}, которые означают текущий адрес страницы и имя отправителя соответственно. Кроме этого, вы можете использовать выражения имён полей форм. Опция «Автору записи» работает только как дополнение к другим выбранным опциям и только при условии, что форма размещена шорткодами и/или полем типа контента.
  • URI, на который отправлять форму. Если вы хотите отправлять форму на другой URL, укажите его тут. Как привило, это опция для разработчиков;
  • Ссылка «Продолжить» после отправки формы. Если указано, то вместе с текстом, указанным в опции «Текст после отправки формы» будет показан кнопка с этой ссылокой.

Поля формы

Для форм вы можете создавать все те же поля, что и для типов контента, а также поле «Защита от спама» - капча.

Некоторые опции полей не будут актуальны для конструктора форм - такие как, показы в списке, опции, касаемые фильтров, автоссылки и т.п.


Назад к разделу Компоненты

manual/components/forms.txt · Последние изменения: 22.11.2020 17:39 — fuze