Diskussionsvorlagen

[Discourse]

	Zusammenfassung	Mit dem Plugin Discourse Templates können Inhaltsschablonen für die wiederholte Verwendung erstellt werden. Die Schablonen werden als Themen in einer speziellen Kategorie gespeichert, wo sie bei Bedarf bearbeitet und diskutiert werden können.
	Installationsanleitung	Dieses Plugin ist im Discourse-Kern enthalten. Eine separate Installation des Plugins ist nicht erforderlich.

Da dies ein #offizielles Plugin ist, das vom Discourse-Team gepflegt wird, können Support, Contribute > Bug, Contribute > UX und #contribute:feature-Anfragen in den jeweiligen Kategorien hier auf Meta gestellt und mit dem entsprechenden Plugin-Tag versehen werden. Klicke auf einen der unten stehenden Links, um eine Anfrage zu starten.

 Support  Fehlerbericht  Benutzeroberfläche (UX)  Funktion

Dieses Plugin ist im Wesentlichen eine neue Version von Discourse Canned Replies, bietet jedoch mehr Flexibilität und speichert die Schablonen auf eine andere Weise.

Funktionen

Dieses Plugin verwendet eine oder mehrere Kategorien, um die Schablonen zur späteren Verwendung zu speichern. Der erste Beitrag jedes Themas in diesen Kategorien wird als Vorlage für die Antworten verwendet.

Dieser Ansatz bietet deutlich mehr Funktionen als die frühere Version mit discourse-canned-replies, da jede Schablone einen Bearbeitungsverlauf hat, mit Tags versehen werden kann und die nachfolgenden Beiträge zur Diskussion des Schabloneninhalts verwendet werden können, falls erforderlich.

Nur sichtbare Themen werden als Schablonen verwendet, daher werden nicht gelistete und archivierte Themen nicht angezeigt.

Das Plugin nutzt auch die Sicherheitseinstellungen der Kategorien, um zu prüfen, welche Benutzer die Schablonen verwenden dürfen. Wenn der Benutzer die Themen in der Kategorie lesen kann, steht die Option „Schablonen einfügen“ im Composer zur Verfügung. Der Benutzer sieht nur die Schablonen/Themen in den Kategorien, auf die er Zugriff hat.

Mehrere übergeordnete Kategorien und/oder Unterkategorien können verwendet werden, um verschiedenen Benutzergruppen unterschiedliche Sets von Schablonen zur Verfügung zu stellen und die Schablonen zu organisieren.

Private Schablonen

Das Plugin unterstützt auch private Schablonen. Private Schablonen sind private Nachrichten, die als Schablonen markiert sind. Diese Nachrichten stehen nur dem Autor der Nachricht als Schablone zur Verfügung.

Archivierte Nachrichten werden nicht als Schablonen angezeigt.

Du findest alle deine privaten Schablonen unter:
/u/{BENUTZERNAME}/messages/tags/{PRIVATE-TEMPLATE-TAG}

Einstellungen:

• discourse templates enabled: Aktiviert das Plugin
• discourse templates categories: Kategorien, in denen die Schablonen gespeichert werden. Jedes Thema in diesen Kategorien und ihren Unterkategorien wird als Vorlage verwendet und ist für Benutzer verfügbar, die sie in ihren ursprünglichen Kategorien sehen können.
• discourse templates enable private templates: Aktiviert die Verwendung privater Schablonen.
• discourse templates groups allowed private templates: Benutzergruppen, die private Schablonen verwenden dürfen.

Mitarbeiter (Staff) sind immer zugelassen.

• discourse templates private templates tags: Tags, die verwendet werden, um private Nachrichten als Schablonen zu markieren.

Verwendung

Nach der Installation des Plugins musst du mindestens eine Kategorie erstellen, um die Schablonen zu speichern.

Beachte, dass jeder Benutzer, der Zugriff hat, um die Themen in dieser Kategorie zu lesen, die Plugin-Funktion im Composer verwenden kann.

Pro-Tipp: Die gleichen Einstellungen zum Bearbeiten von Themen gelten auch für „Schablonen“-Themen. Wenn du möchtest, dass jeder mit Schreibzugriff in der Kategorie die vorhandenen Schablonen bearbeiten kann, solltest du in den Kategorieeinstellungen Make new topics wikis by default (Neue Themen standardmäßig als Wiki markieren) aktivieren.

Danach gibst du die Kategorie in den Plugin-Einstellungen an.

Das war’s. Jetzt musst du nur noch einige Themen in der angegebenen Kategorie erstellen, und sie stehen zur Verwendung als Schablonen zur Verfügung.

Falls gewünscht, kannst du Unterkategorien erstellen, um die Schablonen besser zu organisieren oder verschiedenen Benutzergruppen unterschiedliche Antwort-Sets zur Verfügung zu stellen.

Um Schablonen einzufügen, musst du zuerst den Antwort-Composer öffnen und auf die Extras-Schaltfläche klicken, dann die Option „Schablone einfügen“ auswählen.

Wähle die gewünschte Schablone aus. Du kannst nach Text oder Tags suchen und dann auf das „Einfügen“-Symbol klicken.

Tastenkürzel
Du kannst auf PCs Strg+Umschalt+I oder auf Macs ⌘+Umschalt+I verwenden, um Schablonen einzufügen.

Das Tastenkürzel funktioniert in jedem Textfeld in Discourse.

Private Schablonen

Private Schablonen funktionieren nur in Instanzen, in denen private Nachrichten und Tags aktiviert sind.

Du musst die folgenden Discourse-Einstellungen konfigurieren, damit es funktioniert:

• tagging enabled (Tagging aktiviert): Muss aktiviert sein.
• enable personal messages (Persönliche Nachrichten aktivieren): Sollte aktiviert sein, wenn du diese Funktion auch für Nicht-Mitarbeiter verfügbar machen möchtest.
• pm tags allowed for groups: Du musst die Gruppen, die private Schablonen verwenden sollen, dazu berechtigen, private Nachrichten zu taggen.

Um private Schablonen zu verwenden, musst du sie zunächst in den Einstellungen aktivieren, die Benutzergruppen zuweisen, die sie verwenden dürfen, und mindestens ein Tag zuweisen, um die PMs als Schablone zu markieren.

Um eine persönliche Schablone zu erstellen, müssen die Benutzer:

• eine unverschlüsselte persönliche Nachricht an sich selbst senden, die mit einem der in den Plugin-Einstellungen konfigurierten Tags versehen ist. Nur der Autor der Nachricht wird sie als private Schablone sehen.

Private Nachrichten, die an andere Benutzer gesendet werden, können ebenfalls getaggt werden, aber nur der Autor der Nachricht kann sie als Schablone verwenden.

Vorausgefüllte Variablen

Das Plugin unterstützt die folgenden Variablen in den Schablonen:

• my_username
• my_name
• topic_title
• topic_url
• original_poster_username
• original_poster_name
• reply_to_username
• reply_to_name
• last_poster_username
• reply_to_or_last_poster_username.

Alle oben genannten Variablen unterstützen Ersatztexte (Fallbacks) und werden die Variable entfernen, wenn kein Fallback angegeben ist und die Variable nicht ersetzt werden kann.

Sowohl Titel als auch Textkörper unterstützen die Variablenersetzung.

Beispiel:

Hallo %{reply_to_username,fallback:da},

...

Mit freundlichen Grüßen,
%{my_name}

Wenn der reply_to_username nicht verfügbar ist, lautet die Schablone:

Hallo da,

...

Mit freundlichen Grüßen,
Arpit Jalan

---

Migration von discourse-canned-replies

Es gibt eine Rake-Aufgabe, um die vorhandenen Canned Replies in Schablonen zu migrieren:

rake "discourse-templates:migrate-from-canned-replies"

Dies dauerte auf Meta nur wenige Sekunden, um 47 Canned Replies zu migrieren, daher sollte die Verwendung sicher sein, es sei denn, du hast eine enorme Anzahl von Canned Replies.

TODO

• Erweiterung der Funktionalität auf andere Bereiche außerhalb des Composers
• Ermöglichung der Verwendung von mehr als einer übergeordneten Kategorie als Schablonenquelle

Änderungsprotokoll

• 2022-07-14T03:00:00Z: Möglichkeit hinzugefügt, mehrere übergeordnete Kategorien als Quelle für Schablonen zu verwenden
• 2022-07-18T03:00:00Z: Private Schablonen
• 2022-08-10T03:00:00Z: Globales Tastenkürzel