 |
Zusammenfassung | Discourse Templates ermöglicht die Erstellung von Inhaltsschablonen zur wiederholten Verwendung. 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. Es ist nicht erforderlich, das Plugin separat zu installieren. |
Dieses Plugin ist im Wesentlichen eine neue Version von Discourse Canned Replies, ist jedoch flexibler 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 viel mehr Funktionalität als zuvor 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 aufgeführte und archivierte Themen nicht angezeigt.
Das Plugin nutzt auch die Sicherheitseinstellungen der Kategorien, um zu prüfen, welche Benutzer die Schablonen verwenden können. Wenn der Benutzer die Themen in der Kategorie lesen kann, ist die Option „Schablonen einfügen“ im Editor verfügbar. Der Benutzer kann nur die Schablonen/Themen in den Kategorien sehen, auf die er Zugriff hat.
Es können mehrere übergeordnete Kategorien und/oder Unterkategorien verwendet werden, um verschiedenen Benutzergruppen unterschiedliche Sets von Schablonen bereitzustellen 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 sind nur für den Autor der Nachricht als Schablone verfügbar.
Archivierte Nachrichten werden nicht als Schablonen aufgelistet.
Sie können alle Ihre privaten Schablonen unter folgendem Pfad finden:
/u/{BENUTZERNAME}/messages/tags/{PRIVATER-SCHABLONEN-TAG}
Einstellungen:
discourse templates enabled: Aktiviert das Plugindiscourse templates categories: Kategorien, die zur Speicherung der Schablonen verwendet 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 von privaten Schablonen.discourse templates groups allowed private templates: Benutzergruppen, die berechtigt sind, private Schablonen zu verwenden.
Mitarbeiter sind immer berechtigt.
discourse templates private templates tags: Tags, die verwendet werden, um private Nachrichten als Schablonen zu markieren.
Verwendung
Nach der Installation des Plugins müssen Sie mindestens eine Kategorie zur Speicherung der Schablonen erstellen.
Beachten Sie, dass jeder Benutzer, der Zugriff hat, um die Themen in dieser Kategorie zu lesen, die Plugin-Funktionen im Editor verwenden kann.
Neue Themen standardmäßig als Wiki markierenaktivieren.
Danach geben Sie die Kategorie in den Plugin-Einstellungen an.
Das war’s. Jetzt müssen Sie nur noch einige Themen in der angegebenen Kategorie erstellen, und diese stehen als Schablonen zur Verfügung.
Falls gewünscht, können Sie Unterkategorien erstellen, um die Schablonen besser zu organisieren oder verschiedenen Benutzergruppen unterschiedliche Sets von Antworten bereitzustellen.
Um Schablonen einzufügen, öffnen Sie zunächst den Antwort-Editor und klicken Sie auf die Extras-Schaltfläche, wählen Sie dann die Option „Schablone einfügen“.
Wählen Sie die gewünschte Schablone aus, Sie können nach Text oder Tags suchen, und klicken Sie auf das „Einfügen“-Symbol.
Tastenkürzel
Sie können auf PCs Strg+Umschalt+I oder auf Macs ⌘+Umschalt+I verwenden, um Schablonen einzufügen.
Private Schablonen
Sie müssen die folgenden Discourse-Einstellungen konfigurieren, damit dies funktioniert:
tagging enabled: Muss aktiviert sein.enable personal messages: Sollte aktiviert sein, wenn Sie diese Funktion auch für Nicht-Mitarbeiter verfügbar machen möchten.pm tags allowed for groups: Sie müssen die Gruppen, die private Schablonen verwenden sollen, berechtigen, private Nachrichten zu taggen.
Um private Schablonen zu verwenden, müssen Sie diese zunächst in den Einstellungen aktivieren, die Benutzergruppen zuweisen, die sie verwenden dürfen, und mindestens einen Tag zur Kennzeichnung der PMs als Schablone zuweisen.
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.
Vorausgefüllte Variablen
Das Plugin unterstützt die folgenden Variablen in den Schablonen:
my_usernamemy_nametopic_titletopic_urloriginal_poster_usernameoriginal_poster_namereply_to_usernamereply_to_namelast_poster_usernamereply_to_or_last_poster_username.
Alle oben genannten Variablen unterstützen Text als Fallback und entfernen die Variable, 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 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 Standardantworten in Schablonen zu migrieren:
rake "discourse-templates:migrate-from-canned-replies"
Dies dauerte auf Meta nur wenige Sekunden, um 47 Standardantworten zu migrieren, daher sollte es sicher zu verwenden sein, es sei denn, Sie haben eine enorme Anzahl von Standardantworten.
TODO
Erweiterung der Funktionalität auf andere Bereiche außerhalb des Editors
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
Dieses Plugin ist jetzt Teil des Discourse-Kerns, wie in