Skip to content

Latest commit

 

History

History
76 lines (45 loc) · 3.18 KB

channels-form.rst

File metadata and controls

76 lines (45 loc) · 3.18 KB

Forms

Hint

At the moment it is not possible to add more (or custom) fields to a Zammad Form.

Note

The form is currently limited to one form per instance.

Feedback or contact forms are quite often used on websites. Usually they will generate an email which will be sent to somebody who forwards it and so on. With Zammad it’s quite easy to integrate these forms into your website and directly generate tickets with them. In just 2 minutes.

Go to "Admin -> Channels -> Form" and enable the switch for this feature. Below you can adapt your form settings.

adapt your form settings

In preview mode you can test if the form fits your needs (e. g. if it opens as modal dialog or if it's shown inline on the website)

test it in preview mode

Just copy the JavaScript snippet and paste it into your website. That's all. Just 2 minutes.

copy the JavaScript snippet and paste it into your website - done

Finally, the forms will look as follows:

example form as modal dialog

Potential Spam-Issue

The Form function could be abused by sending a higher amount of messages / tickets to your Zammad instance. If you do not use Zammad-Forms: disable them.

But don't worry! Zammad does limit the maximum created tickets based on different criteria. It also ensure that the E-Mail-Address being used is valid (with MX-Check on the E-Mail-Domain).

Form settings to limit Ticket-Creation
Option Default value Description
form_ticket_create_by_ip_per_hour 20 Limits Ticket-creation per IP and hour to 20 Tickets
form_ticket_create_by_ip_per_day 240 Limits Ticket-creation per IP and day to 240 Tickets
form_ticket_create_per_day 5000 Limits Ticket-creation for forms to 5000 Tickets per day

Hint

You can change the above default values, please keep in mind, that setting those values higher might lead to problems in term of created Tickets.

Please note that the following changes require console access to your hosts that runs Zammad.

Change the Ticket-Creation per IP and hour to 10:

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

Change the Ticket-Creation per IP and hour to 50:

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

Change the Ticket-Creation per day to 500:

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

Further options to make it harder

Another way to make it harder for bots to automate against your Zammad instance is to change the location of form.js ( /opt/zammad/assets/form/form.js ).

Please keep in mind if you change the location of form.js (by e.g. copying) that you need to ensure that your form.js stays up to date if you update Zammad.

Further more it's not recommended to delete form.js from it's location, but to forbid the access to it with your webserver configuration (if wanted).