The purpose of a web form is to standardize the collection of information from a user or colleague. In TYPO3, a web form (mail form) is a Powermail element. It is often used for purposes such as registrations, applications, guest registrations, etc. Note that a Powermail consists of two parts, which is important to remember if you need to copy, move, or translate your form.
This guide explains the standard functionality. There are additional options available, which you can get help with from your websupport, if you need it.
Before you start, please be aware of the following:
You cannot copy an existing Powermail element and edit the copy for reuse. The reason is that the copy uses the same form as the original, so editing the copy also edits the original. In other words, a copy acts as a reference between two forms. However, you can copy the actual Powermail form itself. See the guide for details.
If you move your Powermail element, the Powermail form will remain stored on the page where it was originally created. This means that you risk the Powermail form being deleted if the page is deleted. Therefore, remember to move both the Powermail element and the Powermail form. See the guide for details.
To create a new Powermail form:
The element is inserted, and you now need to create the Powermail form itself:
Here you can see all created forms, but you should select your own unless you want to use exactly the same form on two different pages.
2. Select your form and click 'Save' and 'Close.'
Open the editing of your Powermail element. You can now configure the general settings as described below:
The purpose of the form is to meet your needs as the sender, but also ensure that it is understandable for users.
Under each field in the 'Advanced' tab, you have the option to make additional settings for the field:
*The 'Layout' function is not currently in use.
Note: For fields where the user needs to enter their email address, it is essential that the field is set as a mandatory field with the 'Email' validation to ensure Powermail sends correctly. An email field marked as 'This field contains the Email of the sender' MUST be marked as a Mandatory Field in the 'Advanced' tab if a confirmation email is to be sent to the user. If the user should NOT receive a confirmation email, the 'Sender' tab (Mail to user) MUST NOT be filled out.
If you wish to receive an email when a user has filled out and submitted the form, you need to complete the following four items under 'Mail to Receiver.' You can find this tab under the settings for the plugin itself.
If you want users to receive an email (confirmation email) after they have filled out and submitted the form, you need to complete the following four points under Mail to User. Note: If the user should NOT receive a confirmation email, the Sender tab (Mail to user) should NOT be filled out.
Note: It may be a good idea to include a text in the form stating that the user will receive a confirmation email once they have filled out and submitted the form. This way, the user is aware that something may have gone wrong in the process if they do not receive the email. If you want to ensure that the user has read the information about the confirmation email, you might consider adding a mandatory checkbox in the form where the user must confirm that they have read it.
A suggestion for the text could be:
This form will be sent to [insert name of unit or functional mailbox, e.g., AU IT] when you click [insert the text you have chosen for the submit button, e.g., Send Registration]. You will subsequently receive a copy of your [insert name of the function of the form, e.g., registration] via email as confirmation that your [insert name of the function of the form, e.g., registration] has been received. If you do not receive a confirmation email, your [insert name of the function of the form, e.g., registration] has not been registered. Remember to check your spam filter/junk mail folder to see if the email may have ended up there.
The Submit Page is the information the user is directed to after they click Submit on the form. There are two options for selecting a confirmation page.
In your Powermail element, you can reference the collected data (e.g., the user's name and email) using the field's variable.
We recommend that you complete and test your Powermail form in the default language before starting the translation. Also, remember that a Powermail form consists of both a plugin and a form with fields. Both the plugin and the form need to be translated. This can be done either from the List module, as described first, or from the Page module, as described last.
1.We assume that the page itself has already been translated. If not, see how to translate your page.
2. Go to List view in the left menu.
3. Find the Powermail form in List view under Forms.
4. Click on the English icon under Localize to.
You can now translate the title of the form. After that, you can view and edit the translated version of the Powermail form in List view.
Remember, you also need to translate the plugin itself in the same way!
You can also translate the plugin and form from within the default language. Click on English [NEW] as shown here:
We assume that your Powermail has been translated according to the guide "Translate Powermail to another language" above. If you want to add a new field, it must be done in the form's original language (in this example, Danish). You will then translate your new field in the form's translation as shown below. Note: Avoid translating via List view.
TYPO3 has automatically identified the new Danish field, but it has not been translated yet.
Click on "Translate all elements." This button appears in the English form because you added a field in the original language (Danish).
Now name the translated field and click "Save."
If you want to reuse an existing Powermail form and just modify a few of the fields, you should copy the Powermail form itself.
A copy of the Powermail form has now been created on the page where the new Powermail form has also been saved.
It is a good idea to rename the Powermail form so you can find it again when setting up the Powermail element.
Note: If you copied a Powermail form with a language layer, the translation will automatically be included. However, you risk the language layer not being used in your new Powermail form if you rename the form. There is a workaround:
If you need to move a Powermail form to a different page than where it was originally created, you should move the Powermail form itself and the plugin.
All collected data and any language versions of the Powermail form will be automatically moved to the new page and stored there.
Tooltips are the small messages that appear when you hover over something on a website. They are designed to provide additional information about the specific element. If you have filled in the Description field for a form field in the backend, the text will appear as a tooltip next to the 'i' in your form on the frontend.
Powermail forms are responsive by default, adapting to the platform they are displayed on. However, on mobile devices, you cannot hover over the 'i' in your form. If you want tooltips to be displayed in your Powermail form regardless of screen size, you should follow these steps. The tooltips will then appear when you click on the 'i'.
<link rel="stylesheet" type="text/css" href="//www.aucdn.dk/vendor/css/tipso.min.css" media="all">
<script type="text/javascript" charset="UTF-8" src="//www.aucdn.dk/vendor/js/tipso.min.js"></script>
<script type="text/javascript">
jQuery(document).ready(function () {
jQuery('.tx-powermail .powermail_fieldset [title]:not([title=""])').tipso({
background : '#777',
position : 'top-left',
useTitle : true
});
});
</script>
To avoid manually deleting form data, you can create separate subpages (which are not visible in the frontend) that can be used as containers for submitted form data. Then, you can configure the Powermail form to store data on such a page. By changing the pointer to a new page once you have finished processing the submitted data, you can easily delete old data by deleting the subpage.
This way, you avoid spending time (as mentioned in the previous section) deleting 25 records at a time.
Data is sent to the recipient and is generally NOT stored in TYPO3. If there is a GDPR agreement specifying that data should also be temporarily stored in TYPO3 (during processing), you can extract this data using the following steps:
You can only delete a maximum of 25 entries at a time.
To delete form data: