Freeform
Erstellen Sie Formulare in EmDash mit einem KI-gestützten Builder, Spam-Bewertung, E-Mail-Benachrichtigungen, Webhooks und CSV-Exporten.
Erweiterung
Freeform
Erstellen Sie Formulare in EmDash mit einem KI-gestützten Builder, Spam-Bewertung, E-Mail-Benachrichtigungen, Webhooks und CSV-Exporten.
Beschreibung
Freeform for EmDash
Erstellen Sie Formulare, sammeln Sie Einsendungen und handeln Sie darauf — ohne EmDash zu verlassen.
Formular-Builder
- 13 Feldtypen: text, email, textarea, number, phone, date, checkboxes, radio, dropdowns, multi-select, hidden und HTML-Blöcke
- Zeilenbasiertes Layout mit Validierung pro Feld (Länge, Muster, Min./Max.)
- Ein KI-Builder, der Formulare aus einer Beschreibung in einfachem Englisch erstellt und bearbeitet
- Startformulare für Kontakt und Newsletter-Anmeldung von Haus aus
Einsendungen
- Ein durchsuchbarer Posteingang für Einsendungen mit Seitenaufteilung und vollständigen Detailansichten
- KI-Zusammenfassungen von Einsendungen: Absicht, Dringlichkeit, wichtige Fakten und eine vorgeschlagene nächste Aktion
- CSV-Export für Tabellenkalkulationen und Berichte
Automatisierung und Schutz
- E-Mail-Benachrichtigungen mit wiederverwendbaren Vorlagen, gesendet an Sie oder den Einsender
- Signierte Webhooks (HMAC-SHA256) mit automatischen Wiederholungen und einem Zustellprotokoll
- Spam-Bewertung mit Honeypot und CSRF-Schutz bei jeder Einsendung
- Optionaler MCP-Server, damit KI-Agenten Formulare verwalten und Einsendungen lesen können
Formulare werden auf Ihrer Website mit dem begleitenden Paket @solspace/freeform-astro dargestellt,
das Komponenten ohne Styling liefert, die Sie mit Ihrem eigenen CSS gestalten.
Installation
Installation
1. Das Plugin installieren
Gehen Sie in Ihrem EmDash-Admin zu Plugins → Registry, suchen Sie Freeform und installieren Sie es. Freeform erscheint nach der Installation in der Seitenleiste.
2. Formulare auf Ihrer Website darstellen
Die Administration von Freeform liegt im Plugin; die öffentlichen Formulare werden von einem kleinen begleitenden Astro-Paket dargestellt:
pnpm add @solspace/freeform-astro// astro.config.mjs
import { defineConfig } from "astro/config";
import emdash from "emdash/astro";
import freeformAstro from "@solspace/freeform-astro";
export default defineConfig({
integrations: [emdash(), freeformAstro()],
});Binden Sie dann jedes Formular über sein Handle ein:
---
import { FreeformForm } from "@solspace/freeform-astro/components";
---
<FreeformForm formId="contact" />3. Optional: KI-Funktionen
Der KI-Formular-Builder, die Spam-Bewertung und die Zusammenfassungen von Einsendungen benötigen Ihren eigenen Anthropic-API-Schlüssel. Fügen Sie ihn unter Freeform → Settings hinzu. Ohne Schlüssel funktioniert alles andere — Formulare von Hand erstellen, Einsendungen, E-Mail, Webhooks — normal.
FAQ
FAQ
Brauche ich einen API-Schlüssel? Nur für die KI-Funktionen (KI-Formular-Builder, KI-Spam-Bewertung, Zusammenfassungen von Einsendungen). Fügen Sie Ihren eigenen Anthropic-API-Schlüssel unter Freeform → Settings hinzu. Formulare, Einsendungen, E-Mail-Benachrichtigungen und Webhooks funktionieren auch ohne.
Wie werden Einsendungen vor Spam geschützt? Jedes Formular wird mit einem Honeypot-Feld und signierten CSRF-Token ausgeliefert. Wenn Sie einen Anthropic-Schlüssel hinzufügen, erhält jede Einsendung außerdem eine KI-Spam-Bewertung und wird anhand eines Schwellenwerts markiert, den Sie pro Formular oder global festlegen.
Kann ich über neue Einsendungen benachrichtigt werden? Ja. Erstellen Sie eine E-Mail-Vorlage, weisen Sie sie einem Formular zu und wählen Sie, ob sie an den Einsender (über dessen E-Mail-Feld) oder an eine feste Adresse geht. Sie können außerdem bei jeder Einsendung signierte Webhooks an beliebige URLs auslösen.
Wie exportiere ich Einsendungen? In der Ansicht Submissions können Sie für jedes Formular eine CSV herunterladen oder einen kurzlebigen Export-Link erzeugen.
Können KI-Agenten meine Formulare verwalten?
Ja. Freeform liefert einen optionalen MCP-Server (emdash-freeform-mcp) mit, der
Formular- und Einsendungs-Tools für Clients wie Claude und Cursor bereitstellt.
Sind die dargestellten Formulare gestaltet?
Nein — absichtlich. @solspace/freeform-astro gibt semantisches HTML mit
data-freeform-*-Attributen aus, damit die Formulare zum Designsystem Ihrer Website passen.
Sicherheit
Sicherheit
Eine Sicherheitslücke melden
Schreiben Sie an [email protected]. Bitte eröffnen Sie bei Sicherheitsproblemen kein öffentliches Issue.
Wie Freeform Ihre Website schützt
- Einsendeformulare tragen ein Honeypot-Feld und HMAC-signierte CSRF-Token (zeitkonstante Prüfung, Ablauf nach 2 Stunden).
- Ausgehende Webhooks werden mit HMAC-SHA256 (
X-Freeform-Signature) signiert, damit Empfänger die Echtheit prüfen können. - API-Schlüssel, die Sie angeben (z. B. Anthropic), werden im Plugin-Speicher Ihrer eigenen Website abgelegt — sie werden nie an Solspace gesendet.
- Export-Links sind kurzlebige, signierte Token; sie laufen automatisch ab.