Add-on TYPO3 extension that enhances the "EXT:marketing_automation" TYPO3 extension by connecting it to the Mautic Marketing Automation platform: Determine "Persona" from Mautic segments. Also provides additional services e.g. language synchronisation between Mautic and TYPO3.
This package is auto-updated.
Last update: 2022-11-18 13:40:32 UTC
Welcome to the official Mautic extension for TYPO3!
Please use this Extension version 3.x for TYPO3 v9
Please use this Extension version 4.x for TYPO3 v10
Both support Mautic v2, v3 and v4.
The Mautic TYPO3 extension has many features that allow you to integrate your marketing automation workflow in TYPO3.
Ever wanted to serve different content to different users based on their Mautic segments? With this extension you will be able to set aside content in your TYPO3 website for specific Mautic segments. This way, you will be able to decide what content to serve to which people!
With the Mautic extension for TYPO3 you can create your forms in the TYPO3 backend, and have all data collected in Mautic too! You no longer need to maintain two forms, the extension will automatically sync all forms you have marked as 'Mautic forms' with Mautic. You can then easily post form results to Mautic, while your form will always stay up-to-date with your TYPO3 edits.
In case you got own elements or similiar customization within the EXT:form component you should be aware of the possibly necessary adaptions you have to do. A custom element needs a transformation and field property depending of the element content and what you want to do with it. In case of an e.g. LinkedCheckbox element providing an GDPR checkbox along with a linked text you might not want the data to be transferred into mautic. In this case you can do the following:
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['mautic']['transformation']['formField']['LinkedCheckbox'] = \Bitmotion\Mautic\Transformation\FormField\IgnoreTransformation::class;
If you actually want to transfer the data into mautic you need to choose a fitting Transformation class along with extending the inheritance of the custom element to use the mautic mixin. This provides the possibility to choose a property for the element in the form module.
The side effect of not handling those custom elements could be that the form data is not transferred into mautic correctly. This is only the case on initial setup and first submitting of the form with such an non configured element. Once the form is submitted those custom elements are getting ignored.
Create contacts or modify the points of a contact straight from a TYPO3 Form.
If you wish to use Mautic forms directly, you can now add them with the Mautic Form content element that comes shipped with this extension.
Integrate the Mautic tracking script into your frontend with one click of a button!
All requests made by this extension are secured using OAuth (with Mautic only supping OAuth2 in recent versions). You can easily configure your API tokens in the extension manager of TYPO3.
Set tags for users when they are visiting a page!
Link to Mautic assets directly in TYPO3 using file relations or the TYPO3 link wizard!
You can run the following command using Composer to install the extension:
composer require mautic/mautic-typo3
Then you must go into the backend of Mautic and create a pair of OAuth1a tokens. You can read how to correctly configure the API here under section "3. How to authorize your Mautic API application". After correctly configuring the API and creating a pair of OAuth1a tokens, you can enter them alongside of your Mautic URL in the extension configuration. As soon as these are saved, a button should pop up. This button will allow you to complete the OAuth authentication process and will retrieve the needed tokens. Once that is done, you are all set!
Documentation and a getting started guide can be found here.
Clone the repository and run the following in the extension root directory:
You can contribute by making a pull request to the master branch of this repository.