Form Builder

Über

Das offizielle Payload Form-Builder-Plugin fügt der Konfiguration zwei Collections hinzu: `forms`, in der Redakteure Formulare zusammensetzen, und `form-submissions`, in der jede Einsendung gespeichert wird. Die Felder werden über ein Blocks-Feld aufgebaut. Zur Verfügung stehen die Blocktypen text, textarea, email, number, select, checkbox, date, state, country, message, payment und upload. Jedes Formular hat einen Bestätigungstyp: entweder eine Rich-Text-Nachricht direkt auf der Seite oder eine Weiterleitung, die interne Referenzen über die Option `redirectRelationships` unterstützt. E-Mail-Benachrichtigungen werden pro Formular konfiguriert mit to, cc, bcc, from, replyTo, subject und einem Lexical-Rich-Text-Body. Für die Interpolation von Werten stehen die Tokens `{{fieldName}}`, der Wildcard-Platzhalter `{{*}}` und `{{*:table}}` für eine HTML-Tabelle zur Verfügung. Ein `afterChange`-Hook auf der `form-submissions`-Collection rendert jede konfigurierte E-Mail und sendet sie über `payload.sendEmail`. Über die `beforeEmail`-Callback lassen sich ausgehende E-Mails vor dem Versand anpassen. Der `beforeChange`-Hook übernimmt Datei-Uploads in konfigurierte Upload-Collections und ruft bei aktivierten Zahlungen eine vom Entwickler übergebene `handlePayment`-Callback auf. Für Uploads lassen sich `maxFileSize`, `mimeTypes` und `multiple` festlegen. Die Zahlungslogik unterstützt einen Basispreis plus dynamische Preisbedingungen (equals, hasValue, notEquals in Kombination mit add, subtract, multiply, divide). Die Hilfsfunktion `getPaymentTotal` wird aus dem Paket exportiert. Die Konfiguration erlaubt das Ein- und Ausblenden einzelner Feldblöcke, einen `defaultToEmail`-Fallback-Empfänger und die Übergabe von `formOverrides` sowie `formSubmissionOverrides`. Letztere akzeptieren eine `fields`-Funktion, die die Standardfelder als Argument erhält. Das Plugin basiert auf Payload 4.x, React 19 und TypeScript und liefert React-Admin-Komponenten für DynamicFieldSelector und DynamicPriceSelector. Eingebaute Spamschutz-Mechanismen wie reCAPTCHA sind nicht enthalten.

Paketinformationen

Paketname

@payloadcms/plugin-form-builder

Neueste Version

3.90.2

Entpackte Größe

852 kB

Lizenz

MIT

Wöchentliche Downloads

145.200

Zuletzt veröffentlicht

23. Sep. 2026