Formularvorlagen erstellen

[lindsey (Lindsey Fogle)]

Dieser Leitfaden erklärt, wie man Formularvorlagen zur Strukturierung von Inhalten in Discourse verwendet.

Erforderliches Benutzerniveau: Administrator

Formularvorlagen ermöglichen es Ihnen, strukturierte Formulare mit Validierungsregeln zu erstellen, die Benutzer beim Erstellen von Themen ausfüllen können, sodass Sie sicherstellen können, dass Benutzer alle Informationen bereitstellen, die Sie zur Unterstützung benötigen, z. B. für Fehlerberichte, Funktionsanfragen usw.

Hinweis: Für Vorlagen, die eher als Richtlinien denn als strukturiertes Formular fungieren, sollten Sie Themenvorlagen in Betracht ziehen.

Formularvorlagen aktivieren

Sie können Formularvorlagen in Bevorstehende Änderungen aktivieren, indem Sie Formularvorlagen aktivieren auf „Jeder“ setzen.

Formularvorlagen erstellen

Sie können Formularvorlagen erstellen und verwalten, indem Sie zu Admin > Erscheinungsbild > Formularvorlagen (/admin/customize/form-templates) navigieren.

Um eine Formularvorlage zu erstellen:

1. Klicken Sie auf Neue Vorlage.

2. Aktualisieren Sie das Feld Vorlagenname mit einem internen Namen für Ihre Vorlage.

3. Verwenden Sie die Schaltflächen oben auf der Seite, um die verschiedenen Felder Ihres Formulars hinzuzufügen, und aktualisieren Sie die Feldattribute (unten detailliert). Viele der Optionen sind Standard-Formularfeldtypen (z. B. Kontrollkästchen, Kurzantwort, Dropdown usw.), aber es gibt einige spezifische Felder:

   • Tag-Gruppen-Auswahl: Benutzer können ein oder mehrere Tags aus einer bestimmten Gruppe auswählen.

   • Markdown-Antwort: Benutzer können Inhalte direkt in eine Mini-Version des Komponisten eingeben. Dies ist ideal, wenn Mitglieder Markdown direkt eingeben müssen, z. B. Code, oder andere Formatierungen benötigen, die vom Rich-Editor unterstützt werden.

4. Fügen Sie alle gewünschten Validierungen zu Ihren Eingaben hinzu. Klicken Sie auf die Schaltfläche Validierung für einen Schlüssel (wird auch unten angezeigt).

5. Klicken Sie auf die Schaltfläche Vorschau, um sicherzustellen, dass alles korrekt aussieht.

6. Klicken Sie auf Speichern.

Feldattribute

Allgemeine Attribute für alle Feldtypen:

• label: Der sichtbare Feldname
• placeholder: Hilfetext, der in leeren Feldern (Eingabe, Textbereich, Dropdown, Mehrfachauswahl) angezeigt wird
• description: Zusätzlicher Kontext oder Anweisungen, die unter dem Feld angezeigt werden.

Upload-spezifische Attribute:

• file_types: Durch Kommas getrennte Liste der zulässigen Dateierweiterungen (z. B. .jpg, .png, .pdf)
• allow_multiple: Boolescher Wert, der angibt, ob Benutzer mehrere Dateien hochladen können

Dropdown- und Mehrfachauswahl-Attribute:

• none_label: Text, der angezeigt wird, wenn keine Option ausgewählt ist
• choices: Array der verfügbaren Optionen

Validierungsoptionen

Schlüssel	Typ	Beschreibung
required	boolean	Erfordert, dass das Feld ausgefüllt wird, um das Formular abzuschicken.
minimum	integer	Für Textfelder gibt die minimal zulässige Anzahl von Zeichen an.
maximum	integer	Für Textfelder gibt die maximal zulässige Anzahl von Zeichen an.
pattern	regex; string	Für Textfelder ein regulärer Ausdruck, der die zulässige Eingabe festlegt.
type	string	Für Eingabefelder können Sie den erwarteten Eingabetyp angeben (text, email, date, number, url, tel, color

Formularvorlagen zu einer Kategorie hinzufügen

Nachdem Sie eine Vorlage erstellt haben:

1. Navigieren Sie zu der Kategorie, in der Sie die Vorlage verwenden möchten.
2. Klicken Sie auf die Schaltfläche , um die Kategorie zu bearbeiten.

3. Schalten Sie die Schaltfläche Erweiterte Einstellungen um (falls Sie das neue vereinfachte Kategorie-Design verwenden).
4. Gehen Sie zur Registerkarte Vorlage.
5. Schalten Sie den Umschalter Formularvorlage ein.
6. Wählen Sie die Formularvorlage im Dropdown-Menü aus.
7. Klicken Sie auf Kategorie speichern.

Wenn mehreren Kategorien Vorlagen zugewiesen sind, sehen Benutzer beim Erstellen von Themen eine Vorlagenauswahl.

Benutzererfahrung

Themen mit Formularvorlagen erstellen

Wenn ein Mitglied ein Thema in einer Kategorie mit Formularvorlagen erstellt, wird das Formular automatisch im Komponisten angezeigt. Wenn mehrere Vorlagen derselben Kategorie zugewiesen sind, können Mitglieder die richtige Vorlage aus einem Dropdown-Menü auswählen. Wenn Benutzer versuchen, ein Thema zu erstellen, ohne jedes Feld korrekt auszufüllen, wird eine Validierungsfehlermeldung angezeigt.

Formularwerte vorab ausfüllen

Formularfelder können mithilfe von URL-Parametern, die mit den Feld-IDs übereinstimmen, vorab ausgefüllt werden. Zum Beispiel: /new-topic?software-version=2.4.1&severity=Critical

Dies ist nützlich, um auf die Themenerstellung mit bereits ausgefüllten Feldern zu verlinken.