formConstruct

Конструктор форм для MODX Revolution
Автор дополнения
Andchir
Пакетов
2
Закачек
199
Автор дополнения
Пакетов
2
Закачек
199
Версия 1.3.0-pl
Дата выпуска 18.01.2015
Загрузки 174
Просмотры 599

Функционал и особенности


  • Простое и удобное создание форм для сайта.
  • Для отправки писем и проверки заполнения полей используется FormIt.
  • Поля можно сортировать перетаскиванием строк в таблице.
  • Автоматическое формирование HTML-кода письма на основе введенных данных.
  • Для вывода формы на сайте используется сниппет «formConstruct». В параметрах можно указывать любые параметры для FormIt.
  • Шаблон для всех типов полей создан в формате YAML. Удобная структура, все поля в одном чанке (кроме чекбоксов и радио-кнопок).
  • Открытый исходный код.
  • Возможность авто-заполнения полей данными из профиля авторизованного пользователя.
Документация по FormIt

Установка и использование


  1. Загрузить файл компонента из репозитория, после оплаты.
  2. Установить через «Управление пакетами».
  3. После установки обновить страницу в браузере и перейти в «Компоненты» -> «Конструктор форм».
  4. Для создания новой формы нажать кнопку «Новая форма».
  5. Для создания полей формы нажать правой кнопкой по строке формы и выбрать пункт «Поля формы».
  6. На вкладке формы нажать кнопку «Добавить поле». Заполнить поля.
Поле «Список знаний» заполняется только для типов полей: «Выпадающий список», «Флажки» и «Переключатели».
В данном поле каждое новое значение нужно писать с новой строки.

Если нужно чтобы отображаемое значение и значение, которое будет отправлено отличались, вводить значения через разделитель «==» (без кавычек).
Например (способ оплаты):
Наличные при получении==При получении
robokassa==Электронными деньгами
В этом случае в форме будут отображаться значения «При получении» и «Электронными деньгами», а отправляться будут значения «Наличные при получении» и «robokassa».
Поля можно сортировать перетаскиванием строк в таблице.

Вывод на сайте


Для вывода формы на сайте использутся сниппет «formConstruct».

В параметрах можно указывать любые параметры для FormIt.
Параметры сниппета:
form_id - ID формы (выводится в компоненте "Конструктор форм").
tpl - Имя чанка с шаблоном формы. Пример: formConstruct_tpl.
emailRowTpl - имя чанка строки с данными формы для письма (см. пример form_construct/elements/chunks/emailRowTpl.tpl).
submitVar - имя поля в форме, по которому будет определяться, что форма отправлена. Полезно при выводе двух и более форм на одной странице. По умолчанию &submitVar=`f_submit`.
Шаблон для формы содержит отдельные шаблоны для каждого типа поля.

Внимание! Код шаблона (чанка) должен быть в формате YAML (http://www.yaml.org/). Смотрите пример чанка в комплекте.
Обязательно указать параметр «emailTpl» — имя чанка с шаблоном письма.

В чанке emailTpl должен быть вставлен плейсхолдер [[+formit.rows]] — строки со значениями формы.

Пример вызова сниппета:
[[!formConstruct?
	&form_id=`1`
	&emailSubject=`Письмо с сайта`
	&successMessage=`Спасибо! Ваше письмо отправлено.`
]]
Пример для интернет-магазина, созданного на Shopkeeper:
[[!formConstruct?
	&form_id=`1`
	&hooks=`shk_fihook,email,redirect`
	&emailSubject=`В интернет-магазине "[[++site_name]]" сделан новый заказ`
	&redirectTo=`10`
	&emailTpl=`shopOrderReport`
]]
Пример для интернет-магазина, созданного на Shopkeeper с отправкой письма покупателю:
[[!formConstruct?
	&form_id=`1`
	&hooks=`shk_fihook,email,FormItAutoResponder,redirect`
	&emailSubject=`В интернет-магазине "[[++site_name]]" сделан новый заказ`
	&fiarSubject=`Вы сделали заказ в интернет-магазине "[[++site_name]]"`
	&redirectTo=`10`
	&emailTpl=`shopOrderReport`
	&fiarTpl=`shopOrderReport`
	&fiarToField=`field3`
	&fiarReplyTo=`[[++emailsender]]`
]]

Скриншоты








##################################

formConstruct

##################################

История версий: Изменения в 1.3 (18.01.15):

  • Добавлены свойства для полей: "Имя поля в форме" и "Описание поля".

  • Сделана возможность автозаполнения полей значениями из профиля пользователя (в админке чекбокс "Брать значение из профиля пользователя").

  • Исправлена проблема с заполнением плейсхолдеров чанка формы посторонними данными, которая возникала в некоторых случаях.

  • Мелкие улучшения и исправления.

1.2.3

  • Исправлены визуальные проблемы, которые появились в MODX 2.3+.

1.2.2

  • Сделана поддержка MODX 2.2.9 (из-за новшеств не работало формирование списка значений в письме).

  • Письму автоматически присваивается параметр "emailReplyTo" с адресом указанным отправителем.

  • Добавлен тип поля "Файл".

1.2.1

  • Исправлены ошибки, из-за которых не верно работали переключатели и флажки в формах.

1.2

  • В компоненте в свойствах поля формы добавлено поле "CSS класс".
  • В список доступных типов полей добавлен "Заголовок" для заголовков блоков с полями в форме.
  • Сделана корректная работа с параметром submitVar, который можно использовать при выводе нескольких форм на одной странице.
  • Мелкие доработки.

1.1

  • Сделано автоматическое формирование html-кода строк со значениями полей формы для письма (плейсхолдер [[+formit.rows]]).

1.0

  • Первая версия компонента.

Последние обсуждения в сообществе MODX.pro