Formular

Konfigurieren Sie ein Feedback- oder Kontaktformular für Ihre Website, damit Kunden mit Ihnen in Kontakt treten können, ohne ihren E-Mail-Client zu benutzen. Normalerweise erzeugen solche Kontaktformulare eine E-Mail, die an jemanden gesendet wird, der sie weiterleitet und so weiter. Mit Zammad ist es ganz einfach, diese Formulare in Ihre Website zu integrieren und daraus direkt Tickets zu generieren. Um ein Formular unter Kanäle > Formular zu konfigurieren, benötigen Sie die Berechtigung admin.channel_formular.

Einschränkungen

• Die im Formular nutzbaren Felder sind beschränkt auf:

  • Name

  • E-Mail

  • Nachricht

  • Hochladen von Anhängen (optional)

  • Checkbox für individuelle Hinweise (optional)

• Nur ein Formular pro Instanz kann verwendet werden.

Einstellungen

Es gibt Einstellungen für Formulare in Zammad.

Aktiv

Standardmäßig ist der Formular-Kanal inaktiv. Verwenden Sie den Schalter, um diesen Kanal zu aktivieren. Das Formular wird auf Ihrer Website nicht angezeigt, wenn der Kanal nicht aktiv ist. Dies hat keine Auswirkungen auf die Formularvorschau auf der Einstellungsseite der Kanäle.

Gruppenauswahl bei Ticketerstellung

Die Gruppenauswahl legt fest, in welcher Gruppe die über das Formular kommenden Tickets erstellt werden sollen.

Designer

Dieser Abschnitt hilft Ihnen, Ihr Formular zu konfigurieren. Wenn Sie mit Ihrer Auswahl zufrieden sind, erhalten Sie einen Code, den Sie in Ihre Website kopieren müssen.

Warnung

Änderungen im Designer werden nicht in Zammad gespeichert. Das bedeutet, dass Sie den Code nach jeder Änderung erneut kopieren und in Ihrer Webseite einfügen müssen.

Titel des Formulars

Wählen Sie den Titel des Formulars. Dies ist nur relevant, falls Sie den Titel des Formulars anzeigen möchten.

Standardwert: Feedback-Formular

Name für den Absende-Knopf

Um die Beschriftung des „Übermitteln-Buttons“ anzupassen können Sie hier einen Freitext nach Ihrem Wunsch eingeben.

Nachricht nach dem Versenden des Formulars

Nachdem der Benutzer auf die Schaltfläche Übermitteln geklickt hat, wird eine Meldung mit der Ticketnummer des neu erstellten Tickets angezeigt. Beispiel für die Standardkonfiguration:

Thank you for your inquiry (#31015)! We'll contact you as soon as possible.

Optionen

Zammad bietet Ihnen die folgenden zusätzlichen Konfigurationsmöglichkeiten.

Debugging für Implementierung aktivieren

Diese Option aktiviert detaillierte Debug-Informationen in der Entwickler-Konsole Ihres Browsers.

Warnung

Diese Option sollte nicht in Produktivsystemen verwendet werden!

Titel im Formular anzeigen

Diese Einstellung hängt mit der Einstellung Titel des Formulars zusammen und legt fest, ob ein Titel im Formular angezeigt wird.

Modal-Dialog für Formular starten

Sofern ausgewählt, wird das Formular in einem Modal-Dialog beim Klick auf einen Button geöffnet. Sofern die Option nicht ausgewählt ist, wird das Formular innerhalb Ihrer Webseite eingebettet.

Unabhängig davon was Sie hier ausgewählt haben, wird das Formular immer komplett geladen, wenn ein Benutzer die Formularseite direkt aufruft. Diese Option ist standardmäßig aktiviert.

Kein CSS für das Formular laden. Es muss eigenes CSS für das Formular eingebunden werden.

Standardmäßig ist ein CSS Basis-Design enthalten. Dieses passt möglicherweise nicht zu Ihrem Webseiten-Design oder beeinträchtigen es sogar. Durch die Auswahl dieser Option können Sie das Formular frei gestalten, ohne bestehende Vorgaben überschreiben zu müssen.

Hinzufügen einer Option für Anhänge

Erlaubt den Benutzern, eine Datei als Anhang zum Formular hochzuladen.

Die zulässige Größe der Anhänge ist nicht begrenzt. Die einzige vorhandene Beschränkung ist das Upload-Limit Ihres Webservers.

Hinweis

Wenn Sie ein SaaS-Kunde sind, sind die Anhänge durch das von Ihnen gewählte Paket begrenzt.

Fügen Sie einen Bestätigungstext vor dem Absenden hinzu

Wenn diese Funktion aktiviert ist, können Sie einen Text definieren, der im Formular zusammen mit einem Kontrollkästchen angezeigt wird. Damit können Sie sicherstellen, dass Ihr Formular den gesetzlichen Anforderungen entspricht, z.B. durch Datenschutzhinweise, die der Benutzer vor dem Absenden des Formulars akzeptieren muss. Verwenden Sie die Schaltfläche 🔗 Weblink, um Links zu markierten Textpassagen hinzuzufügen.

Vorschau

Unter den Optionen für das Formular beinhaltet Zammad einen Vorschaubereich des Formulars. Standardmäßig sehen Sie einen Button mit den Namen Feedback. Durch Klicken auf die Schaltfläche wird das Formular-Dialog geöffnet. Wenn der Formularkanal aktiviert ist, können Sie bereits aus der Vorschau Tickets erstellen.

Anforderungen

Dieser Anforderungs-Bereich enthält alle notwendigen Schritte, um das Webformular auf Ihrer Website einzurichten. Es sind grundsätzlich zwei Dinge zu erledigen.

Header Bereich

Der erste Code-Block enthält die jQuery Anforderung. Das Script wird normalerweise im Header-Bereich Ihrer Website platziert.

Für das Formular wird folgendes Script-Tag vorgeschlagen, welches die benötigten Javascript-Bibliothek von einer externen Seite lädt. Das kann Ihren eigenen Anforderungen widersprechen. Sie können auch eine lokal gehostete jQuery-Version nutzen, allerdings ist die Version fest vorgegeben.

<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>

Warnung

Verwenden Sie nicht verschiedene jQuery-Versionen - die Wahrscheinlichkeit, dass etwas nicht funktioniert ist hoch.

Body-Sektion

Der zweite Codeblock ist der eigentliche Code, der für die Ausführung Ihres Formulars erforderlich ist. Er wird automatisch aktualisiert, wenn Sie die Einstellungen im obigen Designer ändern.

Die erste Zeile, welche id="zammad-feedback-form" enthält, hängt stark von den gewählten Konfiguration ab. Dieser Bereich gehört an die entsprechende Stelle, wo das Formular erscheinen soll. Der Rest kann auf derselben Ebene oder an einer anderen Stelle auf derselben Seite platziert werden.

Bemerkung

Diese Code-Statements hängen allerdings stark von Ihrer Website ab. Da Sie selbst für Ihre Website verantwortlich sind, liegt es an Ihnen, die genaue Implementierung in Erfahrung zu bringen und vorzunehmen.

Nehmen Sie die Zammad-Website als Beispiel. Die eingebettete Formularversion kann so aussehen, wenn Sie benutzerdefiniertes CSS darauf anwenden:

Potenzielles Spam-Risiko

Der Formular-Kanal könnte missbraucht werden, indem eine große Anzahl von Nachrichten/Tickets an Ihre Zammad-Instanz gesendet wird. Wenn Sie das Formular nicht verwenden, sollten Sie es deaktivieren. Wenn Sie es verwenden möchten, machen Sie sich trotzdem keine Sorgen: Zammad begrenzt die maximale Anzahl der erstellten Tickets anhand verschiedener Kriterien. Es stellt auch sicher, dass die angegebene E-Mail-Adresse gültig ist (mit MX-Prüfung der E-Mail-Domain).

Einstellungen

Sie können die Standardwerte ändern, indem Sie die unten stehenden Konsoleneinstellungen verwenden. Bitte beachten Sie, dass höhere Werte zu Problemen bei der Erstellung von Tickets führen können. Lesen Sie im Konsolenabschnitt der System-Dokumentation weiter, wie Sie die Rails-Konsole von Zammad verwenden.

Formular-Einstellungen zum Limitieren der Ticket-Erstellung

Option	Standardwert	Beschreibung
form_ticket_create_by_ip_per_hour	20	Schränkt die Erstellung pro IP-Adresse und Stunde auf 20 Tickets ein
form_ticket_create_by_ip_per_day	240	Schränkt die Erstellung pro IP-Adresse und Tag auf 240 Tickets ein
form_ticket_create_per_day	5000	Schränkt die Erstellung durch ein Formular auf 5000 Tickets pro Tag ein

Beispiele

Änderung der Ticketerstellung pro IP-Adresse und Stunde auf 10 Tickets:

>> Setting.set('form_ticket_create_by_ip_per_hour','10')

Änderung der Ticketerstellung pro IP-Adresse und Stunde auf 50 Tickets:

>> Setting.set('form_ticket_create_by_ip_per_day','50')

Änderung der Ticketerstellung pro Tag auf 500 Tickets:

>> Setting.set('form_ticket_create_per_day','500')

Weitere Maßnahmen, um Missbrauch zu erschweren

Als weitere Maßnahme, um Bots die Arbeit zu erschweren, können Sie den Speicherort der form.js ( /opt/zammad/assets/form/form.js ) ändern.

Bitte denken Sie daran: Wenn Sie den Speicherort von form.js ändern (z.B. durch Kopieren), müssen Sie sicherstellen, dass Ihr form.js auf dem neuesten Stand bleibt, wenn Sie Zammad aktualisieren. Es wird nicht empfohlen, form.js in diesem Fall zu löschen, sondern den Zugriff darauf über die Konfiguration Ihres Webservers zu verbieten.