FAQ-Plugin: SysConfig-Referenz für Znuny

In diesem Dokument findest du eine vollständige Übersicht aller SysConfig-Parameter des FAQ-Plugins samt kurzer Erläuterung.

Core-Einstellungen

Schlüssel	Beschreibung
FAQ::CacheTTL	Gültigkeitsdauer des FAQ-Cache in Sekunden (0 = deaktiviert).
FAQ::DefaultState	Standardzustand für neue FAQ-Einträge (z. B. Valid, Invalid).
FAQ::MultiLanguage	Aktiviert mehrsprachige FAQ-Einträge (Bool).
FAQ::SortBy	Standard-Sortierung im Explorer (Title, LastChange, Top10).
FAQ::ExplorerItemsPerPage	Anzahl der Einträge pro Seite im FAQ-Explorer (Integer).

Dynamic Fields

Schlüssel	Beschreibung
DynamicFields::DriverRegistration###FAQ	Registriert den FAQ-Driver für dynamische Felder.
DynamicFields::ObjectTypeRegistration###FAQID	Legt ObjectType FAQID für Verknüpfungen (LinkObject) fest.

Freigabe-Workflow (Approval)

Schlüssel	Beschreibung
FAQ::ApprovalRequired	Aktiviert den Genehmigungsprozess für FAQ-Einträge (Bool).
FAQ::ApprovalGroup	Gruppe(n), die FAQs freigeben dürfen (Array).
FAQ::ApprovalQueue	Queue(s), in der neuen FAQs landen, bis sie freigegeben sind (Array).
FAQ::NotificationOnApproval	Notification-Template für Genehmigungs-Benachrichtigungen.

Explorer-Konfiguration

Schlüssel	Beschreibung
FAQ::ExplorerPath	Breadcrumb-Pfad im Explorer (String).
FAQ::QuickSearch	Aktiviert Freitextsuche im Explorer (Bool).
FAQ::Top10Items	Anzahl der Einträge in der Top-10-Ansicht (Integer).
FAQ::ShowLastChange	Zeigt Änderungsdatum im Explorer an (Bool).
FAQ::ShowCreateDate	Zeigt Erstellungsdatum im Explorer an (Bool).

FAQ-Einträge (Item)

Schlüssel	Beschreibung
FAQ::Item::MaxBodyLength	Maximale Länge des Body-Texts im Zoom (chars).
FAQ::Item::HTMLAllowTags	Liste erlaubter HTML-Tags im Body (Array).
FAQ::Item::CategoryRequired	Kategorie bei Erstellung verpflichtend machen (Bool).

Voting & Feedback

Schlüssel	Beschreibung
FAQ::Voting::Enable	Aktiviert Like-/Dislike-Bewertung (Bool).
FAQ::Voting::LimitPerUser	Max. Bewertungen pro Benutzer und Tag (Integer).
FAQ::Voting::NotificationOnVote	Notification-Template bei neuem Feedback.

Verwandte Artikel & Service-Zuordnung

Schlüssel	Beschreibung
FAQ::RelatedArticles::Enable	Verknüpfen verwandter FAQs aktivieren (Bool).
FAQ::RelatedArticles::MaxItems	Max. Anzahl verwandter Einträge im Zoom (Integer).
FAQ::RelatedArticles::ServiceList	Services, für die verwandte Artikel angezeigt werden (Array).

Ticket-Einbettung

Schlüssel	Beschreibung
FAQ::TicketCompose::InsertMode	Einfügemodus im Ticket (Text, Link, Button).
FAQ::TicketCompose::ButtonLabel	Beschriftung des Insert-Buttons im Ticket-Dialog.
FAQ::TicketCompose::LinkText	Link-Text für Einfügen als Hyperlink.

Objektverknüpfungen (LinkObject)

Schlüssel	Beschreibung
LinkObject::PossibleLink###FAQ2FAQ	Erlaubt Verknüpfung FAQ ↔ FAQ (Bool).
LinkObject::PossibleLink###FAQ2Ticket	Erlaubt Verknüpfung FAQ ↔ Ticket (Bool).

Frontend-Modulregistrierungen (Agent)

Schlüssel	Beschreibung
Frontend::Agent::ModuleRegistration###FAQExplorer	Modul im Agenten-FAQ-Explorer aktivieren.
Frontend::Agent::ModuleRegistration###FAQZoom	Modul im Agenten-FAQ-Zoom aktivieren.
Frontend::Agent::ModuleRegistration###FAQSearch	Modul für Suchfunktion im Agenten-Interface.
Frontend::Agent::ModuleRegistration###FAQPrint	Modul für Drucken im Agenten-FAQ-Modus.

Frontend-Modulregistrierungen (Customer/Public)

Schlüssel	Beschreibung
Frontend::Customer::ModuleRegistration###FAQExplorer	Modul im Kundenportal-Explorer aktivieren.
Frontend::Customer::ModuleRegistration###FAQZoom	Modul im Kundenportal-FAQ-Zoom aktivieren.
Frontend::Public::ModuleRegistration###FAQSearch	Modul für öffentliche Suche (anonyme Nutzer).
Frontend::Public::ModuleRegistration###FAQPrint	Modul für Drucken im öffentlichen FAQ-Bereich.

Häufig gestellte Fragen

Wo konfiguriert man das Znuny FAQ-Plugin und welche Hauptbereiche gibt es?

Die Konfiguration des Znuny FAQ-Plugins erfolgt zentral in der SysConfig, die Sie über Admin → Systemverwaltung → SysConfig erreichen. Hier sind die Einstellungen in verschiedene logische Gruppen unterteilt, um eine übersichtliche Verwaltung zu gewährleisten. Zu den Hauptbereichen gehören die Core-Einstellungen, die grundlegende Funktionen wie die Gültigkeitsdauer des FAQ-Cache (FAQ::CacheTTL) oder den Standardzustand neuer Einträge (FAQ::DefaultState) regeln. Der FAQ-Explorer wird über Parameter wie FAQ::SortBy für die Standardsortierung oder FAQ::ExplorerItemsPerPage für die Anzahl der Einträge pro Seite angepasst. Für die Integration in Tickets gibt es den Bereich Ticket-Einbettung und für die Interaktion mit Nutzern Voting & Feedback. Darüber hinaus gibt es spezifische Abschnitte für den Freigabe-Workflow, Verwandte Artikel & Service-Zuordnung sowie die Frontend-Modulregistrierungen für Agenten und Kunden, die festlegen, welche FAQ-Funktionen in den jeweiligen Oberflächen verfügbar sind. Diese Struktur ermöglicht eine granulare Steuerung aller Aspekte des FAQ-Plugins, von der Inhaltserstellung bis zur Veröffentlichung und Interaktion.Quellen:- FAQ-Plugin: SysConfig-Referenz für Znuny | Znuny Community Docs- Znuny Documentation

Wie richte ich einen Freigabe-Workflow für FAQ-Einträge in Znuny ein?

Ja, das Znuny FAQ-Plugin bietet einen robusten Freigabe-Workflow, um sicherzustellen, dass neue oder geänderte FAQ-Einträge vor der Veröffentlichung geprüft werden. Um diesen Prozess zu aktivieren, müssen Sie den SysConfig-Parameter FAQ::ApprovalRequired auf Ja setzen. Anschließend definieren Sie unter FAQ::ApprovalGroup, welche Agentengruppen die Berechtigung haben, FAQs freizugeben. Dies können eine oder mehrere Gruppen sein, die als Array hinterlegt werden. Zusätzlich ist es ratsam, FAQ::ApprovalQueue zu konfigurieren. Hier legen Sie fest, in welcher Queue neue oder zur Überprüfung stehende FAQs landen sollen, bis sie von einer berechtigten Person freigegeben werden. Dies stellt sicher, dass die FAQs nicht sofort öffentlich zugänglich sind und eine Qualitätskontrolle stattfindet. Für Benachrichtigungen über ausstehende Genehmigungen oder den Status eines Eintrags können Sie zudem ein Notification-Template unter FAQ::NotificationOnApproval hinterlegen, um die relevanten Agenten automatisch zu informieren. Dieser Workflow ist entscheidend für die Aufrechterhaltung der Qualität und Richtigkeit Ihrer Wissensdatenbank.Quellen:- FAQ-Plugin: SysConfig-Referenz für Znuny | Znuny Community Docs- Znuny Documentation

Wie kann ich mehrsprachige FAQ-Einträge aktivieren und die Sortierung im FAQ-Explorer anpassen?

Das Znuny FAQ-Plugin unterstützt mehrsprachige FAQ-Einträge, was besonders nützlich ist, wenn Sie eine internationale Benutzerbasis bedienen. Um diese Funktion zu aktivieren, setzen Sie den SysConfig-Parameter FAQ::MultiLanguage auf Ja. Nach der Aktivierung können Sie für jeden FAQ-Eintrag Übersetzungen in verschiedenen Sprachen hinterlegen, die dann je nach gewählter Sprache des Benutzers angezeigt werden. Die Anpassung der Anzeige und Sortierung im FAQ-Explorer ist ebenfalls flexibel. Unter FAQ::SortBy können Sie die Standardsortierung der FAQ-Einträge festlegen. Optionen sind beispielsweise die Sortierung nach Title (Titel), LastChange (letzte Änderung) oder Top10 (häufig aufgerufene Einträge). Dies ermöglicht es Ihnen, die Relevanz oder Aktualität der angezeigten FAQs für Ihre Benutzer zu priorisieren. Darüber hinaus können Sie mit FAQ::ExplorerItemsPerPage die Anzahl der FAQ-Einträge bestimmen, die pro Seite im FAQ-Explorer angezeigt werden sollen, um die Übersichtlichkeit zu verbessern und die Ladezeiten zu optimieren. Diese Einstellungen tragen maßgeblich zur Benutzerfreundlichkeit und Effizienz Ihrer FAQ-Sektion bei.Quellen:- FAQ-Plugin: SysConfig-Referenz für Znuny | Znuny Community Docs

Welche Optionen gibt es für Agent:innen, um FAQs in Tickets einzubetten, und wie können Kunden FAQs im Portal nutzen?

Agent:innen haben flexible Möglichkeiten, FAQs direkt in Tickets einzubetten, um Kunden schnell und effizient zu helfen. Der Einfügemodus wird über den SysConfig-Parameter FAQ::TicketCompose::InsertMode gesteuert, der Optionen wie Text (FAQ-Inhalt wird direkt in den Ticket-Text eingefügt), Link (ein Hyperlink zur FAQ wird eingefügt) oder Button (ein klickbarer Button erscheint, der die FAQ öffnet oder einfügt) bietet. Die Beschriftung des Buttons kann über FAQ::TicketCompose::ButtonLabel angepasst werden, während der Link-Text für den Hyperlink-Modus mit FAQ::TicketCompose::LinkText definiert wird.Für Kunden im Portal können verschiedene FAQ-Module registriert werden, um ihnen den Zugriff auf die Wissensdatenbank zu ermöglichen. Dies geschieht über die SysConfig-Sektion Frontend::Customer::ModuleRegistration. Hier können Sie Module wie FAQExplorer (ermöglicht das Durchsuchen der FAQ-Kategorien), FAQZoom (zeigt den vollständigen Inhalt eines FAQ-Eintrags an) und FAQSearch (bietet eine Suchfunktion für FAQs) aktivieren. Durch die Registrierung dieser Module stellen Sie sicher, dass Ihre Kunden selbstständig Antworten auf ihre Fragen finden können, was die Anzahl der Supportanfragen reduzieren und die Kundenzufriedenheit erhöhen kann. Ähnliche Module können auch für den öffentlichen Bereich (Frontend::Public::ModuleRegistration) registriert werden, um anonymen Nutzern den Zugriff auf ausgewählte FAQs zu ermöglichen.Quellen:- FAQ-Plugin: SysConfig-Referenz für Znuny | Znuny Community Docs

Wie konfiguriere ich die Bewertungsfunktion (Voting) für FAQs und wie kann ich verwandte Artikel anzeigen lassen?

Das Znuny FAQ-Plugin ermöglicht es Nutzern, Feedback zu FAQ-Einträgen zu geben, was entscheidend für die Verbesserung der Wissensdatenbank ist. Die Bewertungsfunktion, oft als Like-/Dislike-System implementiert, wird über den SysConfig-Parameter FAQ::Voting::Enable aktiviert. Sobald diese Option auf Ja gesetzt ist, können Benutzer ihre Meinung zu den FAQs äußern. Um Missbrauch zu verhindern und aussagekräftiges Feedback zu gewährleisten, können Sie mit FAQ::Voting::LimitPerUser die maximale Anzahl von Bewertungen pro Benutzer und Tag festlegen. Dies verhindert, dass einzelne Nutzer die Bewertungen manipulieren. Bei neuem Feedback kann zudem ein Notification-Template unter FAQ::Voting::NotificationOnVote hinterlegt werden, um zuständige Agenten oder Redakteure über neue Bewertungen zu informieren, sodass sie bei Bedarf Anpassungen vornehmen können.Zusätzlich zur Bewertungsfunktion können Sie verwandte Artikel anzeigen lassen, um Benutzern relevante Informationen zu präsentieren und die Navigation zu erleichtern. Dies wird durch FAQ::RelatedArticles::Enable aktiviert. Die maximale Anzahl der angezeigten verwandten Einträge im Zoom-Modus kann mit FAQ::RelatedArticles::MaxItems begrenzt werden, um die Übersichtlichkeit zu wahren. Besonders nützlich ist die Möglichkeit, verwandte Artikel nur für bestimmte Services anzuzeigen. Dies konfigurieren Sie über FAQ::RelatedArticles::ServiceList, wo Sie ein Array von Services hinterlegen können, für die diese Funktion aktiv sein soll. Diese Einstellungen verbessern die Auffindbarkeit von Informationen und die Benutzererfahrung erheblich.Quellen:- FAQ-Plugin: SysConfig-Referenz für Znuny | Znuny Community Docs

Welche Möglichkeiten bieten dynamische Felder und Objektverknüpfungen im Zusammenhang mit dem Znuny FAQ-Plugin?

Das Znuny FAQ-Plugin lässt sich nahtlos mit dynamischen Feldern und Objektverknüpfungen integrieren, um die Funktionalität und Vernetzung Ihrer Wissensdatenbank zu erweitern. Dynamische Felder bieten die Möglichkeit, zusätzliche, benutzerdefinierte Informationen zu FAQ-Einträgen hinzuzufügen, die über die Standardfelder hinausgehen. Um dynamische Felder für FAQs nutzen zu können, müssen Sie den FAQ-Treiber registrieren, was über den SysConfig-Parameter DynamicFields::DriverRegistration###FAQ geschieht. Dies ermöglicht es Ihnen, spezifische Felder wie z.B. eine Gültigkeitsdauer oder eine interne Referenznummer direkt an Ihre FAQ-Einträge zu knüpfen. Des Weiteren wird DynamicFields::ObjectTypeRegistration###FAQID verwendet, um FAQID als ObjectType für Verknüpfungen (LinkObject) festzulegen, was die Basis für die Verknüpfung von FAQs mit anderen Objekten schafft.Objektverknüpfungen (LinkObject) sind ein mächtiges Werkzeug, um Beziehungen zwischen verschiedenen Entitäten in Znuny herzustellen. Für das FAQ-Plugin können Sie beispielsweise die Verknüpfung von FAQ-Einträgen untereinander aktivieren, indem Sie LinkObject::PossibleLink###FAQ2FAQ auf Ja setzen. Dies ist ideal, um thematisch zusammenhängende FAQs miteinander zu verbinden und Benutzern eine tiefere Navigation zu ermöglichen. Ebenso wichtig ist die Möglichkeit, FAQs mit Tickets zu verknüpfen. Durch die Aktivierung von LinkObject::PossibleLink###FAQ2Ticket können Agenten direkt aus einem Ticket heraus auf relevante FAQs verweisen oder umgekehrt sehen, welche Tickets mit einer bestimmten FAQ in Verbindung stehen. Diese Verknüpfungen verbessern die Effizienz der Agenten und die Konsistenz der bereitgestellten Informationen erheblich.Quellen:- FAQ-Plugin: SysConfig-Referenz für Znuny | Znuny Community Docs- ACL Reference Guide - Znuny Documentation