KSIDol-Dokumentation > KSIDol-Module > Öffentliches Ticket Pro

Modulanleitung: Öffentliches Ticket Pro

Nicht-technische Bedienungsanleitung: wofür das Modul dient, wie man es verwendet und wie es mit Dolibarr zusammenspielt.

Dolibarr-ObjektNative Tickets

Anfrage einreichenOhne Konto

Benutzerdefinierte FelderBis zu 12

Änderung am KernKeine

1. Moduluberblick

KSI Ticket Public Pro ergänzt Ihr Dolibarr um eine öffentliche Seite zur Einreichung von Support-Anfragen, vollständig an Ihr Erscheinungsbild angepasst, die Ihre Kunden oder Besucher ohne Konto nutzen. Jede gesendete Anfrage wird zu einem echten Ticket im nativen Tickets-Modul von Dolibarr: Sie bearbeiten es anschließend genau wie gewohnt in Ihrem Backoffice, mit Ihren Regeln und Ihren Teams. Das Modul ändert keine Datei des Dolibarr-Kerns: Es veröffentlicht seine eigene öffentliche Seite, die Sie frei anpassen (Logo, Farben, Texte, abgefragte Felder), indem es sich auf die bereits in Dolibarr vorhandenen Objekte und Einstellungen stützt — das Tickets-Modul, die Wörterbücher für Typ/Kategorie/Dringlichkeit, den Datensatz Unternehmen für das Logo und die Zusatzfelder (Extrafields) des Tickets. Es ist eine „Pro“- und maßgeschneiderte Alternative zur standardmäßigen öffentlichen Seite zur Ticket-Erstellung.

Bietet eine dedizierte öffentliche Web-Adresse für die Einreichung von Anfragen im Corporate Design Ihres Unternehmens.
Wandelt jede Besuchereingabe in ein standardmäßiges Dolibarr-Ticket um, das normal im Backoffice bearbeitet wird.
Wird vollständig über die Administrationsseite des Moduls konfiguriert (Texte, Farben, Logo, Felder).
Verändert keine native Dolibarr-Datei und bleibt mit Updates kompatibel.
Stützt sich auf native Objekte: Tickets, Geschäftspartner/Kontakte, Zusatzfelder, Wörterbücher.

2. Eine öffentliche Seite zur Ticket-Einreichung, ohne Konto

Das Modul stellt seine eigene öffentliche Seite zur Erstellung von Anfragen bereit. Der Besucher füllt ein Formular aus; bei der Bestätigung wird ein natives Ticket in Dolibarr erstellt und ihm eine Vorgangsnummer mitgeteilt.

Eine dedizierte öffentliche Web-Adresse bereitstellen (in der Modulkonfiguration angezeigt).
Einem Kunden oder Besucher ermöglichen, eine Anfrage ohne Benutzername und Passwort einzureichen.
Jede Einreichung als standardmäßiges Dolibarr-Ticket speichern, das anschließend in Ihrem gewohnten Ablauf weiterverarbeitet wird.
Dem Besucher nach der Erfassung seiner Anfrage eine Vorgangsnummer (Track-ID) anzeigen.
Die nach dem Absenden angezeigte Bestätigungsmeldung anpassen.
Seite bewusst nicht von Suchmaschinen indexiert.

3. Design, Logo und Texte anpassen

Über die Modulverwaltung gestalten Sie die öffentliche Seite in den Farben und Worten Ihres Unternehmens, ohne ein Theme oder den Dolibarr-Kern zu berühren.

Den angezeigten Namen/die Marke, den Haupttitel und den Untertitel der Seite festlegen.
Einen Hilfetext verfassen, der den Kunden führt, sowie eine benutzerdefinierte Erfolgsmeldung.
Das Logo Ihres Unternehmens automatisch anzeigen (aus Dolibarr übernommen) oder ein anderes Logo per URL erzwingen.
Das Logo mit einer Adresse Ihrer Wahl verlinken.
Eine Schaltfläche „Zurück zur Website“ mit gewünschter URL und Beschriftung hinzufügen.
Die Hauptfarbe und die Akzentfarbe wählen (Hexadezimal-Codes).
Benutzerdefiniertes CSS einfügen (nur für Administratoren) für eine vollständig maßgeschneiderte Gestaltung.

4. Die dem Kunden angezeigten Felder auswählen

Sie entscheiden Feld für Feld, was der Besucher sieht und ausfüllen muss, sowie über das Layout des Formulars.

Die Felder Unternehmen, Telefon und Bestell-/Vorgangsreferenz anzeigen oder ausblenden.
Diese Felder je nach Bedarf optional oder pflicht machen.
Die Felder E-Mail, Betreff und Nachricht stets vorhanden und obligatorisch halten.
Die Felder neu anordnen und auf drei Zonen verteilen: oben, Formular, unten.
Die Breite jedes Felds wählen (halbe Breite oder volle Breite).
Ein Kunden-Einwilligungskästchen hinzufügen, bei Bedarf angezeigt und erforderlich.

5. Eigene Felder hinzufügen (Feld-Baukasten)

Über die Standardfelder hinaus bietet das Modul einen Baukasten, mit dem Sie eigene Fragen zum öffentlichen Formular hinzufügen. Die Antworten werden direkt am Ticket gespeichert.

Bis zu 12 zusätzliche benutzerdefinierte Felder erstellen.
Den Typ jedes Felds wählen: Kurztext, Langtext, E-Mail, Telefon, Zahl, Datum, Kontrollkästchen oder Dropdown-Liste.
Beschriftung, Pflichtangabe, Reihenfolge, Zone und Breite festlegen.
Die Optionen einer Dropdown-Liste eingeben (eine pro Zeile, Format „Wert|Beschriftung“ oder einfache Beschriftung).
Die Antworten automatisch als native Zusatzfelder des Tickets speichern, sichtbar im Datensatz.

6. Automatische Zuordnung zum richtigen Kunden

Beim Absenden versucht das Modul, die Anfrage anhand der eingegebenen E-Mail-Adresse mit einem bereits in Dolibarr bekannten Kunden zu verknüpfen, um Dubletten zu vermeiden und Zeit zu sparen.

Anhand der eingegebenen E-Mail automatisch nach einem bereits in Dolibarr erfassten Unternehmen und Kontakt suchen.
Das Ticket dem richtigen Geschäftspartner und dem richtigen Kontakt zuordnen, sofern vorhanden.
Die ursprüngliche E-Mail-Adresse des Anfragenden am Ticket behalten.
Möglichkeit, zu verlangen, dass die E-Mail einem bestehenden Kontakt entspricht (native Dolibarr-Ticket-Einstellung).

7. Anti-Spam, Sicherheit und DSGVO-Einwilligung

Da die Seite öffentlich ist, verwendet das Modul die Schutzmechanismen von Dolibarr wieder und legt keine bestehenden Daten offen: Sie dient ausschließlich zum Einreichen einer neuen Anfrage.

Die Einreichung mit dem Anti-CSRF-Token von Dolibarr schützen.
Ein Captcha anzeigen, wenn die native Captcha-Option der Tickets aktiviert ist.
Die Anzahl der Einreichungen pro IP-Adresse begrenzen (native Anti-Missbrauchs-Einstellung).
Die Einwilligung des Kunden zur Bearbeitung seiner Anfrage einholen und speichern.
Niemals den Inhalt eines bestehenden Tickets anzeigen: Die Seite erlaubt nur das Erstellen.

8. Typ, Kategorie und Dringlichkeit aus Dolibarr

Um mit Ihrer gewohnten Konfiguration konsistent zu bleiben, stammen die Qualifizierungslisten aus den nativen Ticket-Wörterbüchern, ohne eine parallele Liste zu pflegen.

Die Listen Anfragetyp, Kategorie und Dringlichkeit aus den nativen Ticket-Wörterbüchern anbieten.
Nur die als öffentlich markierten Kategorien anzeigen.
Bei Bedarf eine dieser Listen ausblenden und dann einen in der Konfiguration festgelegten Standardcode anwenden.
Eine Qualifizierung beibehalten, die mit der Ihrer intern erstellten Tickets identisch ist.

9. Verknupfungen mit Dolibarr

Das Modul arbeitet nicht isoliert: Es ist mit den nativen Bausteinen von Dolibarr verzahnt.

Tickets (natives Modul) : Jede öffentliche Anfrage wird zu einem standardmäßigen Dolibarr-Ticket, das über das Ticket-Objekt erstellt wird. Das Modul ist vom Tickets-Modul und dessen öffentlicher Schnittstelle abhängig, die aktiviert sein muss.
Geschäftspartner und Kontakte : Anhand der eingegebenen E-Mail sucht das Modul automatisch das bereits in Dolibarr erfasste Unternehmen und den Kontakt und ordnet ihnen das Ticket zu.
Zusatzfelder (Extrafields) : Die Kundenfelder (Unternehmen, Telefon, Referenz, Einwilligung, Quelle) und Ihre benutzerdefinierten Felder werden als native Zusatzfelder des Tickets gespeichert, sichtbar im Datensatz und in den Listen.
Ticket-Wörterbücher : Die Listen Typ, öffentliche Kategorie und Dringlichkeit stammen aus den nativen Ticket-Wörterbüchern, ohne Dublette oder parallele Liste.
Unternehmen / Organisation : Das auf der öffentlichen Seite angezeigte Logo wird automatisch aus dem Datensatz Unternehmen / Organisation von Dolibarr übernommen (oder durch eine URL Ihrer Wahl ersetzt).
Dolibarr-Sicherheitseinstellungen : Das Modul verwendet das Ticket-Captcha und die in der Dolibarr-Sicherheit konfigurierte Begrenzung der Einreichungen pro IP-Adresse wieder, ohne eine eigene zusätzliche Sicherheitseinstellung.