Docusaurus-Feedback-Formular
Füge deinen Docusaurus-Docs ein War-diese-Seite-hilfreich-Formular hinzu, ganz ohne Plugin. Füge das Markup in die MDX-Seite ein, benenne class in className um, und das Feedback der Leser landet in deinem Posteingang. Kein eigenes Backend.
So baust du es
- Erstelle ein Formular in deinem Formpaste-Dashboard und kopiere den Zugangsschlüssel.
- Füge das Markup in die .mdx-Seite 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
Eine Bewertung plus ein Kommentar ist der Sweet Spot
Ein Select für den Wert und ein Textfeld für das Warum geben dir eine Zahl zum Verfolgen und den Kontext dahinter, ohne ein langes Formular.
Lass Leute anonym bleiben
Markiere Name und E-Mail als optional. Feedback ist ehrlicher, wenn es nicht an eine Identität gebunden ist, und Spam wird trotzdem automatisch gefiltert.
Leite Feedback dorthin, wo du es siehst
Leite Einsendungen an einen gemeinsamen Posteingang oder per Webhook an dein Tracking-Tool weiter, damit nichts ungelesen bleibt.
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">Name (optional)
<input type="text" name="name" 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>
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">E-Mail (optional)
<input type="email" name="email" placeholder="du@beispiel.de" 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>
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">Bewertung
<select name="rating" 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">
<option>5 - Ausgezeichnet</option>
<option>4 - Gut</option>
<option>3 - Okay</option>
<option>2 - Schlecht</option>
<option>1 - Sehr schlecht</option>
</select>
</label>
<label class="flex flex-col gap-1.5 text-sm font-medium text-gray-900 dark:text-gray-100">Dein Feedback
<textarea name="message" required class="min-h-28 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"></textarea>
</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">Feedback senden</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-Feedback-Formular FAQ
Formular einfügen. Einsendungen erhalten.
Sofort, ohne Backend, Server oder Datenbanken einzurichten. 250 Einsendungen/Monat kostenlos - keine Kreditkarte.