Работа с конструктором форм в InstantCMS 1.10

Всем привет.

В InstantCMS 1.10 конструктор форм претерпел значительные изменения. Помимо того, что поля форм теперь можно редактировать, формы сами по себе достаточно гибко настраиваемые.

Итак, что нового:

— для каждой формы вы можете указать свой атрибут action, по умолчанию он для всех форм "/forms/process";
— показывать/не показывать заголовок формы;
— выводить только поля формы (например, если поля формы вы хотите вставить в свою форму);
— новый тип поля ссылка (введенное в это поле ссылка будет обработана как активная через go редирект);
— новая опция поля формы "Значение поля ссылкой", при ее включении вы можете задать префикс этой ссылки, по умолчанию "/users/hobby/". Т.е. ссылка будет выглядеть как "/префикс/значение_поля".
— ширина поля теперь задается в px;
— автоматическая валидация значений полей формы.

Подробнее об использовании в различных компонентах.

Для начала в компоненте необходимо подключить сам класс конструктора форм, он теперь системный, находится в /core/classes/form.class.php, подключаем как:
Я обычно это делаю в конструкторе класса модели компонента.
Работа с формой — это три этапа: показ самой формы (ее полей), получение значений от пользователя, вывод значений в необходимом месте.

Итак, первое, показ самой формы

Все на самом деле очень просто:
Статический метод getFieldsHtml вернет массив полей формы. Вы так же можете передать вторым параметром массив значений полей и третьим параметром флаг показа только обязательных полей.
Дальше массив $formsdata можно передать в шаблон и в нем использовать например так (подразумевается, что таблица — тег table — уже есть):

Второе — получение значений полей

Тут еще проще:
Массив $form_input будет содержать в себе:
— массив значений полей $form_input['values'];
— массив ошибок $form_input['errors'].
А переменная $formsdata уже подготовлена для вставки в базу данных. Обратите внимание, массив мы преобразовали в YAML и заэскейпили строку для вставки в базу.
Обязательные к заполнению поля вы можете проверить например так:

И третье — показ значений

Предполагается, что во втором этапе мы получили значения формы и поместили их куда-то в базу данных к какой-нибудь записи.
Теперь мы эти значения получаем
Обратите внимание, $form_array — это уже преобразованная в массив строка YAML. Т.е. если из базы мы получили значение в формате YAML, его нужно преобразовать в массив, например так:
И осталось нам всего то передать в шаблон переменную $formsdata и там показать, например так:
На этом все, в классе cmsForm все методы снабжены комментариями, любопытные и желающие разобраться думаю без труда поймут логику работы. Класс можно легко расширить, добавив обработку новых полей.
На примерах, вы можете посмотреть работу с формами в компонентах users, board.

Всем спасибо за внимание, попытался написать наиболее понятно, если возникли вопросы, смело пишите в комментариях.