DEPRECATION WARNING

This documentation is not using the current rendering mechanism and will be deleted by December 31st, 2020. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Add a new Form

Introduction

A powermail forms is the main record which contains multiple pages and fields. So if you create and store a form, you can use this on one or more pages. A form that is included in a plugin/pagecontent (see Add a new Plugin) will be shown in frontend and can be used by website visitors.

First step

Choose a page (could also be a folder) where to store the new form-record and change to the list view. Click on the New Button to add a new record to this page and choose “Forms”.

powermail_records

Form Settings

record_form_detail1

Field Description Explanation Tab
Title Add a title for your form. The title is used to find the form in the backend. You can also show the title in the frontend. General
Pages Add one or more pages to a form. A form collects a couple of pages. You need minimum 1 page to show a form. If you choose a multistep form, every step is splitted in one page. General
Layout Choose a layout. This adds a CSS-Class to the frontend output. Administrator can add, remove or rename some of the entries and switch the frontend layout of your form. Extended
Language Choose a language. Choose in which frontend language this form should be rendered. Access
Hide Disable the form Enable or disable a form with all pages and fields. Access
Start Startdate for this record. Same function as known from default content elements or pages in TYPO3. Access
Stop Stopdate for this record. Same function as known from default content elements or pages in TYPO3. Access

Page Settings

record_page_detail1

Field Description Explanation Tab
Title Add a title for your page. The title is used to find the page in the backend. You can also show the title in the frontend. General
Fields Add one or more fields to this page. A page collects a couple of fields. You need minimum 1 field to show a form. General
Note Just a small Note (in some cases). This note shows you if there is no Sendermail or Sendername marked in the fields. Without this information powermail will set default values for the Sendername and Senderemail. If you are aware of this and you don’t want to see this information in future (for this form), you can disable this note. General
Layout Choose a layout. This adds a CSS-Class to the frontend output. Administrator can add, remove or rename some of the entries. Extended
Language Choose a language. Choose in which frontend language this record should be rendered. Access
Hide Disable the form Enable or disable this record. Access
Start Startdate for this record. Same function as known from default content elements or pages in TYPO3. Access
Stop Stopdate for this record. Same function as known from default content elements or pages in TYPO3. Access

Field Settings

General

Backend Configuration Example

record_field_input_tab1

record_field_input_tab2

Explanation

Field Description Explanation Tab
Title Add a label for this field. The label is shown in the frontend near to this field. General
Type Choose a fieldtype. See explanation below for a special fieldtype. Different fields are related to some fieldtypes – not all fields are shown on every type. General
Email of sender Check this if this field contains the email of the sender. This is needed to set the correct sender-email-address. If there is no field marked as Senderemail within the current form, powermail will use a default value for the Senderemail. General
Name of sender Check this if this field contains the name (or a part of the name) of the sender. This is needed to set the correct sender-name. If there is no field marked as Sendername within the current form, powermail will use a default value for the Sendername. General
Mandatory Field This field must contain input. Check this if the field must contain input, otherwise submitting the form is not possible. Extended
Validation Validate the user input with a validator. Possible Validation Methods are: Email, URL, Phone, Numbers only, Letters only, Min Number, Max Number, Range, Length, Pattern (RegEx) Extended
Prefill with value Prefill field value with a static content. Other possibilities to prefill a field: TypoScript, GET or POST params Extended
Placeholder Add a placeholder for this input field. A placeholder text is an example, that should help the user to fill out an input field. This text is shown in bright grey within the input field. If you have a name field, you could use the placeholder “John Doe”. Extended
Value from logged in Frontend User Check if field should be filled from the FE_Users table of a logged in fe_user. This value overwrites a static value, if set. Extended
Layout Choose a layout. This adds a CSS-Class to the frontend output. Administrator can add, remove or rename some of the entries. Extended
Description Add a description for this field. Per default a description will be rendered as title-attribute in the labels in frontend. Extended
Variables – Individual Fieldname This is a marker of this field. Use a field variable with {marker} in any RTE or HTML-Template. The marker name is equal in any language. Extended
Add own Variable Check this, if you want to set your own marker (see row before). After checking this button, TYPO3 ask you to reload. After a reload, you see a new field for setting an own marker. Extended
Language Choose a language. Choose in which frontend language this record should be rendered. Access
Hide Disable the form Enable or disable this record. Access
Start Startdate for this record. Same function as known from default content elements or pages in TYPO3. Access
Stop Stopdate for this record. Same function as known from default content elements or pages in TYPO3. Access

Field Types

Field Description HTML Tab Example Details
Textfield (input) Simple text field (one line) <input type=”text” /> Standard example_field_input Textfield (Input)
Textfield with more rows (Textarea) Text field with more lines <textarea></textarea> Standard example_field_textarea Text with more rows (Textarea)
Selectfield Selector box (Dropdown) <select><option>X</option></select> Standard example_field_select Selectfield
Checkboxes Checkbox (Possibility to select more than only one) <input type=”checkbox” /> Standard example_field_checkbox Checkboxes
Radiobuttons Radio Buttons (Possibility to check only one) <input type=”radio” /> Standard example_field_radio Radio Buttons
Submit Send Form <input type=”submit” /> Standard example_field_submit Submit
Captcha Captcha Check against spam <input type=”text” /> Extended example_field_captcha Captcha Field
Reset Reset cleans all fieldvalues in the form <input type=”reset” /> Extended example_field_reset Reset
Show some text This field let you show some text in the form This is a Test Extended example_field_label Show some Text
Content Element Show an existing Content Element Text with <img src=”…” /> Extended example_field_content Content Element
Show HTML Add some html text. Per default output of fields of type HTML is parsed through a htmlspecialchars() function to avoid Cross-Site-Scripting for security reasons. If you are aware of possible XSS-problems, caused by editors, you can enable it and your original HTML is shown in the Frontend. This is a <b>Test</b> Extended example_field_html Show HTML
Password Field Two fields for a password check <input type=”password” /> <input type=”password” /> Extended example_field_password Password Field
File Upload Upload one or more files <input type=”file” /> Extended example_field_file File Upload
Hidden Field Renders a hidden field, where you can store some additional information within the form. <input type=”hidden” /> Extended - Hidden Field
Date Datepicker field (Date, Datetime or Time) <input type=”date” /> Extended example_field_date Date
Countryselection Choose a Country <select><option>France</option><option>Germany</option></select> Extended example_field_country Country
Location Location field. Browser will ask the user if it’s ok to fill the field with his current location. <input type=”text” /> Extended example_field_location Location
TypoScript Fill values from TypoScript This is a <b>Test</b> Extended example_field_typoscript TypoScript

Fieldtype Details