Before you start, please be aware of the following:

1. 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.
2. 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:

1. Go to the page where you want to place your Powermail form.
2. Add a new content element.
3. Select the 'Plugins' tab.
4. Choose the 'Powermail' element type.

The element is inserted, and you now need to create the Powermail form itself:

1. Go to the 'Plugin' tab.
2. Create a new form by clicking on the '+.'

Name your form so that you can find it again later. Create and name the first page of your form. Click 'Save' and close.
 

1. Under Primære indstillinger (Main settings) finder du din formular under listen Available Items.

Her kan du se samtlige oprettede formularer, men det er din egen, du skal vælge, med mindre du ønsker at bruge præcis samme formular på to forskellige sider.

      2. Vælg din formular, og tryk Gem og luk.

The purpose of the form is to meet your needs as the sender, but also ensure that it is understandable for users. Consider whether you truly need all the information you are asking users to provide, or if you can eliminate some fields. If the form becomes too long and complicated, it may lead users to reach out with questions and not provide the benefit you might have expected.

1. Pages are your way to create visual separations in the form. If you have chosen a multi-step view, this will be a division of the pages. Click 'Create new page' to add a new one. Each page must have a name, and there must be at least one page in a form.
2. Fields are the input fields in your form, created on the actual pages. Click 'Create new field' to add new ones.
3. Field Types: You need to define everything in the form yourself, so you must create all fields, including a button to submit the form. See the different options for field types in this sample form. Each field requires different information, and when you select a new field type, TYPO3 will automatically load the necessary field details. This often means that it collapses the sidebar tree, and you will need to find the field again.
4. Remember to specify which field contains the user's email address. For the Powermail to work and correctly send the form with the appropriate information, user's email must be specified.

Under each field in the 'Advanced' tab, you have the option to make additional settings for the field:

1. Should the field be mandatory, meaning the form cannot be submitted until it is filled out correctly.
2. Under 'Validation,' you can specify the type of content the user should enter in the field, such as only numbers or letters.
3. If a help text is needed for a field, you can add it under 'Description.' In the frontend, this is indicated by an 'i' after the field name.
4. Each field has a 'Variables' section that can be used when setting up automated emails for the sender and recipient.

*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.

1. User's name. Here, you can use the variable from the field where the user has entered their name. See Find a fields variable.
2. Enter the email address that should receive notification when the user submits the form.
3. Enter the subject for the email you will receive when the user submits the form. Note: This field must be filled out before Powermail will send the email.
4. Here you can write a message to yourself about which data you are receiving. You can set which data you want to see in the email by inserting the variables of different fields. By entering {powermail_all}, all fields in your Powermail form will be displayed in the email.

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.

1. Here you enter the name that will appear as the sender of the email.
2. Here you insert the email address of the person who will appear as the sender of the email to the user.
3. Here you enter the subject of the email that the user will receive. Note: This field must be filled out before Powermail will send the email.
4. Here you can write a message to the user as a confirmation of the completed form. You can customize the data you want to include in the email by inserting the variables of the various fields. By using {powermail_all}, all fields in your Powermail form will be shown in the email. See Find a fields variable.

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.

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.

1. If you want to use the same page as the one where the Powermail form is located, you should fill out the Submit Page field. This is done just like you would with a regular text element. You can personalize the confirmation by using your field variables, e.g., Dear {navnpaabruger}.
2. If you prefer to redirect the user to a different confirmation page, you can enter the link to the desired page here. Note: You cannot do both (1+2). When a link to another page is set, that page will be used, and you should create your confirmation text there, e.g., 'Thank you for your registration. You will hear from us as soon as possible.

In your Powermail element, you can reference the collected data (e.g., the user's name and email) using the field's variable.

1. To find a field's variable. Open the form and select a field, such as "User Name."
2. Go to the Extended tab.
3. Copy the field's name under Variables (e.g., {username}).

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.

Translate plugin and form in list view

1. 1.We assume that the page itself has already been translated. If not, see how to translate your page.
2. 2. Go to List view in the left menu.
3. 3. Find the Powermail form in List view under Forms.
4. 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!

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.

1. TYPO3 has automatically identified the new Danish field, but it has not been translated yet.
2. Click on "Translate all elements." This button appears in the English form because you added a field in the original language (Danish).
3. 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.

1. Go to the page where the Powermail form you want to copy is saved.
2. Switch to List View in the left menu.
3. Scroll down until you reach Forms. Here you can find the Powermail form used on the page in the Powermail element.
4. Click the icon next to the form and select Copy.

1. Now go to the page where you want to use the copied Powermail form.
2. Switch to List View in the left menu.
3. Insert the Powermail form by clicking the insert icon at the top.

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.

1. Locate the page where the Powermail form is currently situated.
2. Go to the List view.
3. Find the form and click on the cut tool.

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'.

1. Go to the page properties of the page where the Powermail form is located.
2. Select the Extended tab.
3. Insert the following in the Field for extra JavaScript:

<link rel="stylesheet" type="text/css" href="//cdn.au.dk/vendor/css/tipso.min.css" media="all">
<script type="text/javascript" charset="UTF-8" src="//cdn.au.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>

• Get the script in a text document.

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:

1. Go to the page where your Powermail data is stored.
2. Select Powermail (Mails) from the left menu.
3. You will automatically see a view of the registered data as shown below.
4. You can also export the data, which can be done from the Powermail menu item. Here, you have the option to export as .csv and .xls.

You can only delete a maximum of 25 entries at a time.

To delete form data:

1. Go to the Powermail backend module (Mails).
2. To select the entries, click on the top [+] icon on the far right.
3. At the bottom, there are now two icons: Clicking on the eye icon will hide the data without deleting it. However, clicking on the trash can icon will delete the data from your form.