FormitFastPack

Последнее обновление not available | История страницы | Улучшить эту страницу | Сообщить о проблеме

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$204 per month—let's make that $500!

Learn more

Что такое FormitFastPack?¶

FFP упрощает управление HTML, связанным со сниппетами обработки форм, такими как FormIt и Login.

Установка¶

Установите из менеджера пакетов MODX.

Начало работы¶

Ниже простой пример использования сниппета field с формой FormIt. Более подробный пример смотрите в руководстве.

[[!FormIt?
  &hooks=`email,redirect`
  &emailTpl=`ContactFormReport`
  &emailTo=`[[++emailsender]]`
  &emailSubject=`New contact form submission`
  &validate=`email:email:required,message:required`
  &redirectTo=`1`
]]
<form action="[[~[[*id]]]]" method="post">
[[!field? &type=`text` &name=`email` &req=`1`]]
[[!field? &type=`textarea` &name=`message` &class=`cleardefault` &req=`1`]]
[[!field? &type=`submit` &name=`submitForm` &label=` ` &message=`Send this Message!`]]
</form>

Включённые сниппеты¶

field: один вызов сниппета генерирует HTML для одного поля формы. HTML всех полей одного дизайна можно управлять всего двумя чанками (внешним и внутренним), а динамические значения вроде текущего значения поля и сообщений об ошибках обрабатываются корректно. Выборочное кеширование ускоряет обработку опций.

fieldSetDefaults: этот сниппет ничего не выводит, но любые переданные ему параметры меняют значения по умолчанию для всех последующих сниппетов field. Такой способ задания значений по умолчанию не работает, если для сниппета field используется набор свойств.

fieldPropSetExample: заглушка-сниппет с полным набором свойств для сниппета «field». Наборы свойств несовместимы с fieldSetDefaults, поэтому сниппет field поставляется без набора свойств. Этот набор свойств предназначен для тех, кто предпочитает наборы свойств вместо fieldSetDefaults.

fiGenerateReport: хук FormIt, который формирует email-отчёт, прогоняя все отправленные имена и значения полей через чанк шаблона строки.

fiProcessArrays: хук FormIt, который преобразует значения-массивы в объединённые строки. В более новых версиях FormIt уже есть похожая функциональность.

formCollectErrors (скоро): выводит список ошибок формы.

Автоматические подписи¶

Если правильно назвать поля, вы можете использовать метод FFP для генерации подписей из имён полей. Либо задайте подписи вручную.

Подписи генерируются простыми выходными фильтрами, которые можно настроить: [[+name:replace=_== :ucwords]]

Примеры результатов:

Имя поля	Сгенерированная подпись
name	Name
first_name	First Name
company_address	Company Address
number_of_employees	Number Of Employees

Поддержка¶

Отправляйте проблемы, вопросы и запросы функций в трекер issues.
Следите за разработкой на GitHub
Обсуждайте на форуме MODX
Свяжитесь с автором на websitezen.com/contact.