![\"“Edit”](\"wp-content\/uploads\/cevento-docs\/en\/003-002-formulare_aktion-bearbeiten.jpg\")
<\/a><\/div>\nForm builder overview<\/h2>\n
The following image shows a numbered overview of the form builder. In this document, you’ll find numbers in parentheses, e.g. (1). These numbers correspond to the same numbers in the image, so you can see where each setting, action, or piece of information can be found. <\/p>\n
<\/a><\/div>\nForm title<\/h2>\n
At the top left, you’ll see the title of your form, preceded by a pencil icon (1)<\/a>. If you click on the pencil icon or directly on the title, you can edit the form title.<\/p>\n To the right of the title, you’ll see a row of buttons (2)<\/a>. These are the actions available for this form. Below them, you’ll find a switch to enable auto-save (3)<\/a>.<\/p>\n When you enable auto-save, all changes will immediately be visible online on your website. Use this feature with caution if you have already published an event with this form.<\/mark><\/p>\n One way to add a field is by clicking the plus icon in the actions. This will create a new field at the end of the list. Another way is to click on the desired field type in the Field Types<\/span> metabox, or drag & drop the field type to the desired position in the list. <\/p>\n You can also see these field types on the right-hand side of the form builder (4)<\/a>.<\/p>\n Each form field is displayed as a white element (bar with shadow) (5)<\/a>. This element provides the following actions and settings.<\/p>\n If you hover your mouse over the drag & drop icon (7)<\/a> and hold down the mouse button, you can change the order of the fields in the list. This order also determines the order in which the fields appear in the form on the website.<\/p>\n Next to the drag & drop icon is the display of your field label with a small icon indicating the field type (8)<\/a>. You can adjust the label in the field settings.<\/p>\n At the right end of the element, you’ll see a small number with the prefix field_<\/span>. This is the field key (9)<\/a>. It is required when inserting Cevento Data into E-Mail Templates<\/a>.<\/p>\n Clicking the down arrow expands the element to reveal the field settings.<\/p>\n To display more actions for your field, hover over the gear icon (6)<\/a>. The following actions will then appear to the left, which you can trigger by clicking the respective icon. The action bar remains visible as long as your cursor is placed over it. <\/p>\n To delete a form field, click the trash can icon. A pop-up will appear where you can confirm deletion (button Delete permanently<\/span>) or cancel the action (button Nevermind<\/span>). Once confirmed, this action cannot be undone.<\/p>\n To duplicate a form field, click the icon with two overlapping rectangles. After clicking, a copy of the field appears at the top of the list, and you immediately have the option to edit the field title in the input field. Don’t worry — the title can be changed later via an action<\/a> or in the form builder<\/a>.<\/p>\n To adjust the settings for a field, click the field element or the down arrow within the element. The element will expand to reveal the field settings. The following explains first the settings common to all field types, then the specific settings per field type. <\/p>\n The settings are grouped into tabs (see image). <\/p>\n Here you can find the basic settings for the field.<\/p>\n In this dropdown, you can select the field type<\/a>.<\/p>\n If you change the field type after configuring other settings, those settings will be lost, since different field types offer different options.<\/mark><\/p>\n Enter the text you want to display above the field in the form on the website.<\/p>\n Settings here vary depending on field type. Refer to the specific field type settings below.<\/p>\n The text entered here is shown in the form directly above the input field, providing guidance to users.<\/p>\n Here you can define rules to validate the user’s input. If the input does not meet the rules, the booking cannot be submitted until corrected. All field types have a switch for making the field required, and some have additional validation options. See the specific field type section for details.<\/p>\n Switch the This field is not required<\/span> switch. When activated, it changes to This field is required<\/span>. Required fields must be filled out by users before they can submit the booking. If a required field is empty, an error message appears, and the field is highlighted.<\/p>\n Here you can define conditions under which the field should be shown and\/or required. Each condition consists of three dropdowns:<\/p>\n To add conditions that must also be met, click the plus icon above the line labeled or<\/span>. If there are no “OR” conditions, then all “AND” conditions must be fulfilled for the state to apply.<\/p>\n If your conditions contradict each other, it may result in unwanted behavior or validation errors.<\/mark><\/p>\n The field type Checkbox<\/span> allows users to make a single selection. This field is very useful if, for example, you want to ask for confirmation that the privacy policy has been read.<\/p>\n You can find this setting in the General<\/span> tab. If the checkbox is selected by users, the text entered in the Value<\/span> input field is saved as the field’s value in the booking data.<\/p>\n You can find this setting in the General<\/span> tab. If this switch is active, the Checkbox is preselected in the booking form on your website.<\/p>\n If you add a checkbox to accept the privacy policy, this field must not be selected by default according to the GDPR.<\/mark><\/p>\n Only valid dates are accepted as values for the Date<\/span> field.<\/p>\n This setting is located in the General<\/span> tab. The chosen date will be displayed on the website as long as users do not enter another value in the input field. If users do not enter a different value upon submission of the booking, this default value will be part of the booking’s data as well.<\/p>\n You can find this setting in the tab named General<\/span>. With this input field you can choose the date format of the field. All formats of the PHP-DateTimeInterface<\/a> are valid.<\/p>\n This setting is located in the General<\/span> tab. If this switch is active, user can also choose a time additionally to the date.<\/p>\n You can find this setting in General<\/span> tab. If this switch is active, users only can choose future dates.<\/p>\n Both these settings are located in the Validation<\/span> tab. You can use these to set the start (inclusive) and end (inclusive) dates of the date range from which your users can select a date. However, this date range is relative to the date on which your users see the field. You can enter a whole number here to determine how many days from today the range begins and ends. With a + in front of the number (X), you select from X days in the future, with a – from X days in the past.<\/p>\n Only valid email addresses are allowed to be entered into the E-Mail<\/span> field.<\/p>\n This setting is located in the General<\/span> tab. The text entered in this input field will displayed on the website as long as users do not enter another value in the input field. If users do not enter a different value upon submission of the booking, this default value will be part of the booking’s data as well.<\/p>\n If this switch is active, the user emails of Cevento will be sent to this address. You find the setting in the tab General<\/span>.<\/p>\n This setting is located in the tab named General<\/span>. If the switch is active, only one booking may be completed per email address submitted for this field.<\/p>\n You can find these two settings in the Validation<\/span> tab. By entering a whole number in these two input fields, you can set limits for the text length available to users in this field.<\/p>\n Only whole numbers are accepted as values for the field Number<\/span>. <\/p>\n This setting is located in the General<\/span> tab. The number entered in this input field will displayed on the website as long as users do not enter another value in the input field. If users do not enter a different value upon submission of the booking, this default value will be part of the booking’s data as well.<\/p>\n You can find these two settings in the Validation<\/span> tab. By entering a whole number in these two input fields, you can set limits for the text length available to users in this field.<\/p>\n You can provide multiple options from which your users can choose with a field of the type Select<\/span>.<\/p>\n You can find this setting in the General<\/span> tab. Enter the options from which your users are allowed to choose. Each option requires a seperate line.<\/p>\n This setting is located in the General<\/span> tab. The text entered in this input field will define the option selected per default on the website. If users do not choose a different option, it will be part of their booking’s data as well.<\/p>\n You can find this setting in the General<\/span> tab. Activate this switch, if you want to allow users to select multiple options.<\/p>\n You can find this setting in the Display<\/span> tab. If this switch is active and the switch for using the browser’s native select is inactive, a search field will be added to your selection field. Users can then search for an option by entering text.<\/p>\n You can find this setting in the Display<\/span> tab. The text entered here will be displayed as a placeholder in the search field for your selection field (e.g. Search …).<\/p>\n This setting can be found in the Display<\/span> tab. If this input field is filled with text, a first option with no value (e.g. Please select …) will be added to the selection field on the website. If this option is selected upon users hitting the submit button and the selection field is a mandatory field, this will result in a validation error.<\/p>\n You can find this setting in the Display<\/span> tab. By default, Cevento adds certain styling and extended functionality to a selection field that go beyond usual web standards and are intended to make it easier to use. If you want to prevent this, activate the switch for this setting. If the switch is active, the element will be displayed in the way the user’s browser determines.<\/p>\n The field type Text<\/span> allows your users to provide short information. All characters are valid.<\/p>\n This setting is located in the General<\/span> tab. The text entered in this input field will displayed on the website as long as users do not enter another value in the input field. If users do not enter a different value upon submission of the booking, this default value will be part of the booking’s data as well.<\/p>\n You can find this setting in the General<\/span> tab. The text entered here will be displayed in the field on your website before users fill in the field. If users do not fill in this field, the placeholder will not<\/em> be included as a value in the booking data.<\/p>\n You can find these two settings in the Validation<\/span> tab. By entering a whole number in these two input fields, you can set limits for the text length available to users in this field.<\/p>\n The field type Textarea<\/span> allows your users to provide lengthier text. All characters are permitted.<\/p>\n This setting is located in the General<\/span> tab. The text entered in this input field will displayed on the website as long as users do not enter another value in the input field. If users do not enter a different value upon submission of the booking, this default value will be part of the booking’s data as well.<\/p>\n You can find this setting in the General<\/span> tab. The text entered here will be displayed in the field on your website before users fill in the field. If users do not fill in this field, the placeholder will not<\/em> be included as a value in the booking data.<\/p>\n You can find these two settings in the Validation<\/span> tab. By entering a whole number in these two input fields, you can set limits for the text length available to users in this field.<\/p>\n The field type Group<\/span> allows multiple fields to be grouped together as a unit.<\/p>\n You can find this setting in the General<\/span> tab. To add fields to the unit of your group drag and drop fields to the grey area of the field labelled Fields<\/span>. These will be grouped together and given a heading. The heading of the Group is the text stored in the Label<\/span> setting.<\/p>\n If you set the field as required in the Group<\/span> field type in the Validation<\/span> tab, then all subordinate fields of the Group are also required.<\/p>\n The field type Repeater<\/span> combines several fields into a group that can be duplicated and populated multiple times by users. This means that a single field of type Repeater<\/span> can contain multiple entries.<\/p>\n You can find this setting in the General<\/span> tab. The text entered in the Label<\/span> setting is displayed as the field heading.<\/p>\n You can find this setting in the General<\/span> tab. To add fields to the unit of your group drag and drop fields to the grey area of the field labelled Fields<\/span>. These will be grouped together and given a heading.<\/p>\n In the Display<\/span> tab, you will find the setting Singular Label<\/span>. The text entered here will be displayed as a heading above each individual entry.<\/p>\n Would you like the entries to be numbered (e.g. 1. entry, 2. entry, etc.)? You can insert the placeholder This setting is located in the Display<\/span> tab. The text entered here determines the content of the button that users can click to add another entry.<\/p>\n If you set the field as required in the Repeater<\/span> field type in the Validation<\/span> tab, then all subordinate fields of the Repeater are also required.<\/p>\n You can find this setting in the Validation<\/span> tab. The whole number entered here represents the minimum number of entries a user must add for this field to be considered complete.<\/p>\n You can also find this setting in the Validation<\/span> tab. The whole number entered here represents the maximum number of entries the user is allowed to add.<\/p>\n The field Participants<\/span> allows you to accept multiple participants for a booking. Without the field Participants, a booking is always considered for one person only. This also affects the allocation of spots for your event. One place in your event is occupied per participant. If you use the integration with WooCommerce<\/a>, one place is also sold per participant.<\/p>\n You can find this setting in the General<\/span> tab. The text stored in the Label<\/span> setting will be displayed as the field heading. We recommend using clear wording such as ‘Participants’ or ‘Visitors’.<\/p>\n You can find this setting in the General<\/span> tab. To add fields that are requested of each participant drag and drop fields to the grey area of the field labelled Fields<\/span>. This allows you to request various information from each participant that is useful for organising your event (e.g. age, skills, intolerances, etc.). <\/p>\n We have already added the two most important fields by default – name and email address. You can decide whether you want to use these fields. Replacing these fields with others has no effect (unless bookings have already been received for this form).<\/p>\n In the Display<\/span> tab, you will find the setting Singular Label<\/span>. The text entered here will be displayed as a heading above each individual participant. We recommend using the singular form of the Label.<\/p>\n Would you like the individual participants to be numbered (e.g. participant 1, participant 2, etc.)? You can insert the placeholder This setting can also be found in the Display<\/span> tab. The text stored here is the content of the button that users can use to add another participant.<\/p>\n If you set the field as required in the field type Participants<\/span> in the Validation<\/span> tab, then all subordinate fields of Participants are also required.<\/p>\n This setting can be found in the Validation<\/span> tab. The whole number entered here represents the minimum number of participants a user must add for this field to be considered complete.<\/p>\n Also in the Validation<\/span> tab, you will find the setting Maximum Items<\/span>. The whole number entered here determines the limit on the number of participants a user can add.<\/p>\nActions and auto-save<\/h2>\n
Add a field<\/h3>\n
<\/a><\/div>\nField Types<\/h2>\n
\n
Field element and field actions<\/h2>\n
Actions<\/h3>\n
Drag & Drop<\/h4>\n
Label<\/h4>\n
Field key<\/h4>\n
Expand field settings<\/h4>\n
More actions<\/h4>\n
<\/a><\/div>\nDelete<\/h5>\n
Duplicate<\/h5>\n
Field settings<\/h3>\n
<\/a><\/div>\n<\/a><\/div>\nSettings common to all field types<\/h4>\n
General<\/h5>\n
Type<\/h6>\n
Label<\/h6>\n
Display<\/h5>\n
Instructions<\/h5>\n
Validation<\/h5>\n
Required fields<\/h6>\n
Conditions<\/h5>\n
\n
Adding an “AND” condition<\/h6>\n
Special settings per field type<\/h4>\n
Checkbox<\/h5>\n
Value<\/h6>\n
Checked by default<\/h6>\n
Date<\/h6>\n
Default Value<\/h6>\n
Date Format<\/h6>\n
Enable Time Selection<\/h6>\n
Only future dates<\/h6>\n
Minimum Date & Maximum Date<\/h6>\n
E-Mail<\/h5>\n
Default Value<\/h6>\n
This is the recipient for all user emails<\/h6>\n
Unique across submissions<\/h6>\n
Minimum text length & Maximum text length<\/h6>\n
Number<\/h5>\n
Default Value<\/h6>\n
Minimum Number & Maximum Number<\/h6>\n
Select<\/h5>\n
Select Options<\/h6>\n
Default Value<\/h6>\n
Allow multiple selections<\/h6>\n
Enable search (Not supported by native select)<\/h6>\n
Search Placeholder<\/h6>\n
Empty Option Text<\/h6>\n
Use the browser’s native select<\/h6>\n
Text<\/h5>\n
Default Value<\/h6>\n
Placeholder<\/h6>\n
Minimum text length & Maximum text length<\/h6>\n
Textarea<\/h5>\n
Default Value<\/h6>\n
Placeholder<\/h6>\n
Minimum text length & Maximum text length<\/h6>\n
Group<\/h5>\n
Fields<\/h6>\n
This field is required<\/h6>\n
Repeater<\/h5>\n
Label<\/h6>\n
Fields<\/h6>\n
Singular Label<\/h6>\n
{x}<\/code> at the point where you want the current number of the entry to be displayed (e.g. {x}. entry).<\/mark><\/p>\nAdd Button Label<\/h6>\n
This field is required<\/h6>\n
Minimum Items<\/h6>\n
Maximum Items<\/h6>\n
Participants<\/h5>\n
Label<\/h6>\n
Fields<\/h6>\n
Singular Label<\/h6>\n
{x}<\/code> at the point where you want to display the current number of the entry (e.g. participant {x}).<\/mark><\/p>\nAdd Button Label<\/h6>\n
This field is required<\/h6>\n
Minimum Items<\/h6>\n
Maximum Items<\/h6>\n
Next steps<\/h2>\n
\n
\n