Docusaurus-Newsletter-Formular
Füge deiner Docusaurus-Site eine Anmeldung für Release-Notes hinzu, ganz ohne Plugin. Ein E-Mail-Feld in einer MDX-Seite, und Abonnenten landen in deinem Posteingang oder deinem E-Mail-Tool. Kein eigenes Backend.
So baust du es
- Erstelle ein Formular in deinem Formpaste-Dashboard und kopiere den Zugangsschlüssel.
- Füge das Markup in deine Changelog- oder Landingpage ein und benenne class in className um.
- Ersetze YOUR_ACCESS_KEY_HERE durch deinen Zugangsschlüssel, dann deploye.
Docusaurus-Fallstricke
Docusaurus-Seiten sind MDX, ein Formpaste-Formular ist also Markup, das du direkt ins Dokument einfügst. Es gibt kein Plugin zu installieren und kein Theme zu swizzeln. Der einzige Haken: MDX behandelt Markup als JSX, das eingefügte Snippet braucht also className statt class.
MDX ist JSX, also className statt class
In einer .mdx-Datei ist alles, was wie HTML aussieht, in Wirklichkeit JSX. Benenne class im eingefügten Formular in className um und schreibe jedes Inline-Style als Objekt wie style={{marginTop: '1rem'}} statt als String. Das ungestylte CSS-Snippet lässt sich am einfachsten anpassen.
Kein Plugin und kein Swizzling
Du brauchst weder ein Docusaurus-Plugin noch musst du eine Theme-Komponente swizzeln. Ein Formular im Seiteninhalt funktioniert in den Docs, im Blog und auf eigenständigen Seiten gleichermaßen.
Bei Wiederholung in eine Komponente auslagern
Wenn dasselbe Formular auf vielen Seiten stehen soll, leg es als .jsx- oder .tsx-Datei in src/components/ ab und importiere es in jedes Dokument. Das ist das Muster, das die Docusaurus-Docs für alles jenseits einer Einzelverwendung empfehlen, und es hält das Markup aus deinem Fließtext heraus.
Das versteckte access_key behalten
Lass das generierte versteckte access_key-Input-Feld unverändert stehen, damit Formpaste weiß, zu welchem Formular die Einsendung gehört. Es ist ein normales Input-Feld und übersteht den Umzug in eine Komponente unverändert.
Worauf es ankommt
Ein Feld konvertiert am besten
Ein Newsletter-Formular sollte nur nach der E-Mail fragen. Jedes zusätzliche Feld senkt die Anmeldungen.
Bestätige, bevor du feierst
Zeig bei Erfolg eine Abonniert-Meldung. Falls du Double-Opt-in brauchst, versende die Bestätigung über dein E-Mail-Tool, nicht über das Formular.
Leite an dein E-Mail-Tool weiter
Leite Einsendungen mit einem Webhook an dein ESP weiter, damit neue Abonnenten dort landen, wo du deine Kampagnen versendest.
So funktioniert es
Drei einfache Schritte, bis Formular-Einsendungen in deinem E-Mail-Posteingang landen.
Erstelle dein Formular, setze die action-URL auf den Formpaste-Endpunkt und trage deinen Zugangsschlüssel ein.
Formular erstellen
Melde dich an, verifiziere deine E-Mail und erstelle einen Zugangsschlüssel im Dashboard.
Code kopieren
Füge das Snippet oben in dein Projekt ein. Wähle CSS oder Tailwind passend zu deiner Website.
<form action="https://api.formpaste.com/submit" method="POST" class="mx-auto flex w-full max-w-md flex-col gap-4 rounded-xl border border-gray-200 bg-white p-6 shadow-sm dark:border-gray-800 dark:bg-gray-950">
<input type="hidden" name="access_key" value="YOUR_ACCESS_KEY_HERE">
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">E-Mail
<input type="email" name="email" placeholder="du@beispiel.de" required class="rounded-md border border-gray-300 bg-white px-3 py-2 text-sm text-gray-900 shadow-sm outline-none focus-visible:ring-2 focus-visible:ring-gray-900 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-100 dark:focus-visible:ring-gray-100" />
</label>
<button type="submit" class="w-full rounded-md bg-gray-900 px-4 py-2 text-sm font-medium text-white shadow-sm transition-colors hover:bg-gray-800 disabled:opacity-60 dark:bg-white dark:text-gray-900 dark:hover:bg-gray-200">Abonnieren</button>
</form>Zugangsschlüssel hinzufügen
Ersetze den Platzhalter durch deinen Zugangsschlüssel, um Einsendungen zu empfangen.
<input type="hidden" name="access_key" value="YOUR_ACCESS_KEY_HERE">Docusaurus-Newsletter-Formular FAQ
Formular einfügen. Einsendungen erhalten.
Sofort, ohne Backend, Server oder Datenbanken einzurichten. 250 Einsendungen/Monat kostenlos - keine Kreditkarte.