Form Builder

Описание

Плагин добавляет в конфигурацию две коллекции: `forms` для конструирования форм и `form-submissions` для хранения отправленных ответов. Поля собираются через blocks-поле Payload с типами блоков: text, textarea, email, number, select, checkbox, date, state, country, message, payment, upload. Каждая форма имеет режим подтверждения: rich-text сообщение на странице или редирект с поддержкой внутренних ссылок через параметр `redirectRelationships`. После каждой отправки `afterChange` хук коллекции form-submissions рендерит настроенные письма и отправляет их через `payload.sendEmail`. В письмах задаются to/cc/bcc/from/replyTo/subject и тело в формате Lexical rich-text. Подстановка значений поддерживает токены `{{fieldName}}`, шаблон `{{*}}` и `{{*:table}}` для HTML-таблицы со всеми полями. Колбэк `beforeEmail` позволяет изменять исходящие письма перед отправкой. Хук `beforeChange` обрабатывает загрузку файлов в коллекции, указанные в `uploadCollections`, с параметрами `maxFileSize`, `mimeTypes` и `multiple`. Если платежи включены, хук вызывает функцию `handlePayment`, которую предоставляет разработчик. Поддержка платежей включает `basePrice` и динамические условия (equals, hasValue, notEquals с операциями add, subtract, multiply, divide). Утилита `getPaymentTotal` экспортируется из пакета для расчёта итоговой суммы. Конфигурация позволяет включать и отключать отдельные типы блоков, задавать `defaultToEmail` как запасной адрес получателя и переопределять коллекции через `formOverrides` и `formSubmissionOverrides`. Переопределения принимают функцию `fields`, которая получает список полей по умолчанию для точечного редактирования. Плагин построен на Payload 4.x, React 19 и TypeScript, содержит React-компоненты админки DynamicFieldSelector и DynamicPriceSelector. Встроенной защиты от спама, такой как reCAPTCHA, нет.

О пакете

Имя пакета

@payloadcms/plugin-form-builder

Последняя версия

3.90.2

Размер

852 кБ

Лицензия

MIT

Загрузок в неделю

145,2 тыс.

Последняя публикация

23 сент. 2026 г.