Все про комп’ютери - Документація сніпету FormIt для MODx Revolution
FormIt – це сніпет динамічної обробки форми для MODx Revolution. Він обробляє форму після підтвердження, перевіряє валідацію та дає на них відповідь. При успішній обробці сніпет надсилає на вказаний email дані з форми, інакше видає інформацію про помилку. Сніппет не створює форму, але може повторно заповнити її, якщо вона не пройшла валідацію.
Використання
Запит Сніппет FormIt необхідно помістити в ресурс, що містить форму, яку Ви хочете використовувати. Вкажіть у запиті сніппета "hooks" (або пост валідаційні скрипти обробки). Потім додайте валідацію за допомогою параметрів &validate та/або &customValidators.
Якщо у Вас на сторінці декілька форм, заповніть властивість &submitVar у запиті сніпету (наприклад, &submitVar='form1-submit').
| hooks | Тут вказуються скрипти, які потрібно буде виконати після перевірки форми. Це може бути розділений комами список хуків. Якщо перевірка не пройдена, обробка не відбувається. Також хуком може бути ім'я сніпета, яке виконуватиме цей сніпет. | |
| preHooks | Тут вказуються хуки, які потрібно виконати перед перевіркою форми. | |
| submitVar | Якщо встановлено, обробка форми не почнеться доки не виявиться вказана POST-змінна. Увага: потрібно, якщо Ви використовуєте властивість &store (+ встановіть submit змінну input="submit"!). | |
| validate | Розділений комами список полів для перевірки, де кожне ім'я поля має вигляд name:validator (наприклад, username:required,email:required). Валідатори також можуть бути зчеплені, якemail:name:required. Ця властивість може надаватися кільком рядкам. | |
| validationErrorMessage | Загальне повідомлення про помилку встановлюється в плейсхолдер [ [!+fi.validation_error_message] ], якщо валідацію не пройдено. Якщо ви бажаєте відобразити список усіх помилок у верхній частині, використовуйте плейсхолдер [ [+errors] ]. | Форма містить помилки, перевірте дані, що вводяться |
| validationErrorBulkTpl | Темплейт, який використовується для кожної окремої помилки у загальному масиві повідомлень про помилку. | [ [+error] ]li> |
| errTpl | HTML-код для повідомлень про помилки. Примітка: не чанк, а лише HTML. | [ [+error] ]span> |
| customValidators | Розділений комами список сніппетів-валідаторів, які Ви плануєте використовувати у цій формі. | |
| clearFieldsOnSuccess | Якщо значення true і не використовується редирект, сніпет очистить всі поля форми після успішної обробки. | 1 |
| store | Якщо значення true, Сніппет буде зберігати дані в кеші для вибіркового використання Сніппет FormItRetriever. | 0 |
| storeTime | Якщо властивість 'store' дорівнює true, це властивість встановлює кількість секунд збереження даних із форми. За промовчанням п'ять хвилин. | 300 |
| placeholderPrefix | Префікс, що використовується для всіх плейсхолдерів СНІПЕТу | fi. |
| successMessage | Якщо не використовується хук-редирект, після завершення успішного виконання сніпету відображається це повідомлення. | |
| successMessagePlaceholder | Ім'я плейсхолдера, куди міститься повідомлення про успішне виконання. | fi.successMessage |
| redirectTo | ID сторінки "Thank You", куди відвідувач буде перенаправлений після успішного виконання сніпету. Примітка: використовувати з хуком "redirect" у списку властивості &hooks. |
Приклад роботи з Formit можна переглянути у цій статті.