Forms

The form builder of the Energine 2.13 admin with a list of forms and actions to edit a form and show its results
Energine 2.13 admin — the form builder (interface in Russian)

The form builder makes forms without code, and the feedback form of the apps module sends messages to chosen recipients.

The form builder

«Конструктор форм» (Form builder, /admin/form-builder/) has «Создать» (Create), «Редактировать свойства» (Edit properties), «Редактировать форму» (Edit form), «Показать результаты» (Show results) and «Удалить» (Delete).

  • Properties: «Название» (Name), «Активная» (Active), «Описание» (Description), «Дополнительное описание к форме (внизу)» (Text under the form) and «E-mail, на который приходят заполненные формы» (E-mail for filled-in forms); without an address the answers go to mail.manager of the configuration.
  • Fields: «Имя поля» (Field name), «Тип поля» (Field type) and «Поле может быть пустым» (May be empty). The types: «строка» (string), «Email», «Телефонный номер» (phone number), «логическое» (yes or no), «текстовое» (text), «множественный выбор» (multiple choice), «список значений» (list of values), «дата» (date), «дата и время» (date and time), «файл» (file) and «инфо» (info); the values of lists are edited with «Редактировать значения» (Edit values).
  • Each form keeps its answers in a table of its own, form_<id>, and each field is a column: the builder changes the database schema — see Known risks. Deleting a form drops its tables only.
  • The results are a grid with «Просмотреть» (View), «Экспортировать в CSV» (Export to CSV) and «Удалить».

A form on a page

form.content.xml — «Конструктор форм: форма» (Form builder: form) — places Energine\forms\components\Form. Give it the param id, the form's number, in a template of your own or in the page's blocks; without it the page shows a random active form. A sent form shows «Данные успешно отправлены.» (Data sent) and mails the answers, files as links.

The feedback form

feedback_form.content.xml — «Форма обратной связи» (Feedback form) — asks for «Кому» (To — one of the recipients), the e-mail, the name, the subject and the text. The message is saved and mailed by two templates: feedback_form to the visitor and feedback_form_admin to the chosen recipient's addresses. The messages are in «Обратная связь» (Feedback, /admin/feedback-editor/), the recipients in «Редактор получателей» (Recipients editor, /admin/feedback-editor/recipients/).

Public forms have no protection from bots; see Known risks.