Typo3 Form version (v4.0+)

The Typo3MaileonIntegration TYPO3 extension enables seamless integration between TYPO3 and Maileon, a powerful email marketing platform. With this extension, website administrators can effortlessly synchronize newsletter subscribers from TYPO3 to Maileon, ensuring that their email lists remain up to date without manual intervention.

This extension is designed for TYPO3 users who want to leverage Maileon’s advanced email marketing and automation features while managing their subscriber data directly within their TYPO3 website. Whether you’re running a small business newsletter or managing large-scale email campaigns, this extension helps streamline the process of collecting, organizing, and exporting subscriber data to Maileon.

Key Features:

• Automatic Synchronization – Send new subscribers from TYPO3 to Maileon in real-time.

• Flexible Subscription Handling – Support for opt-in confirmations and GDPR-compliant data processing.

With this extension, you can focus on building engaging email campaigns while keeping your subscriber lists automatically synchronized.

Open

The extension can be installed using Composer with the following command:

After installation, run the setup command to finalize the configuration:

Alternatively, the extension can be installed manually using a ZIP package:

1. Download the ZIP package from the TYPO3 Extension Repository: TYPO3 Maileon Integration Extension

2. Log in to the TYPO3 backend.

3. Navigate to Admin Tools → Extensions.

4. Upload the downloaded ZIP package to install the extension.

To insert TypoScript for the plugin, follow these steps:

1. In the TYPO3 backend, navigate to the “List” module in the left-hand menu.

2. Select the root page element in the page administration.

3. Edit the existing TypoScript record.

Open

Next, open the “Advanced Options” tab and locate the “Includes” section. Add “Configuration for TYPO3 - Maileon Integration (typo3_maileon_integration)” to the list of selected objects, then click “Save” to apply the changes.

Open

1. Navigate to Admin Tools → Settings → Extension Configuration

2. Locate TYPO3 Maileon Integration

3. Set the following:

   • API Key: Your Maileon API key

Open

Extension Configuration

Open

Maileon extension config

• Use the built-in Form Editor in TYPO3 to create either a subscription or unsubscription form.

• A subscription form template is included with the extension, which can be used as a starting point and customized as needed.

• Add the desired fields to the form.

Open

Duplicate the default subscribe form template

Open

Form wizard step one

Open

Form wizard step two

Open

The form duplicated

• In each field’s settings, add a property named Maileon field name and set its value to the corresponding Maileon field name.

• The mappings are shown in a table below.

Open

Email address edit page

• At the end of the form, add the MaileonSubscribeFinisher or MaileonUnsubscribeFinisher

• Configure the finisher with:

  • Initial permission (none, single opt-in, confirmed opt-in, double opt-in, double opt-in plus)

  • Enable DOI process

  • Final permission after DOI process (only if DOI process enabled)

  • Set DOI key (if required, only if DOI process enabled)

Open

Subscribe finisher

Open

Unsubscribe finisher

• Save and include the form on any TYPO3 page using a form content element.

Open

Add new content to a page

Open

Form elements → Form

Open

New page content edit

Open

Set the form at Plugin options

Open

Form at the frontend

For subscribe or unsubscribe forms, an email address input field is mandatory.

The extension will not process or submit the form data to Maileon unless a valid email address is provided.

Currently, the extension supports the following TYPO3 form input types:

If you want to use Maileon’s standard fields, you can refer to the fields listed in the table below:

Any field not listed in the standard fields table will be treated as a custom contact field. These fields are automatically created in Maileon before the first submission if they don’t already exist.

Naming Rules for Custom Fields:

• Must be in lowercase letters

• Cannot contain accented letters or special characters

• Spaces are not allowed – use underscores (_) instead

Make sure your field names follow these rules to avoid issues with field creation in Maileon. For example: phone_number

If you want to insert a link into the label text of a checkbox (e.g., for a privacy policy or terms and conditions), the checkbox element settings panel has been extended to support this functionality.

In the Label Link section, you can select the TYPO3 page where the link should navigate. In the Label field, enter the full label text. To define which part of the label should be hyperlinked, wrap that text in square brackets ([ ]).

Open