PHPackages                             mautic/mautic-typo3 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. mautic/mautic-typo3

ActiveTypo3-cms-extension[Utility &amp; Helpers](/categories/utility)

mautic/mautic-typo3
===================

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.

v12.0.0(2mo ago)236.3k18[17 issues](https://github.com/mautic/mautic-typo3/issues)[4 PRs](https://github.com/mautic/mautic-typo3/pulls)GPL-2.0-or-laterPHPPHP &gt;=8.0

Since Jul 19Pushed 1mo ago19 watchersCompare

[ Source](https://github.com/mautic/mautic-typo3)[ Packagist](https://packagist.org/packages/mautic/mautic-typo3)[ Docs](https://www.leuchtfeuer.com)[ RSS](/packages/mautic-mautic-typo3/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (10)Dependencies (8)Versions (47)Used By (0)

The Mautic Extension for TYPO3
==============================

[](#the-mautic-extension-for-typo3)

[![Mautic](https://camo.githubusercontent.com/880c6469e5764f17c24258c054f42201690689b299699abc955b5830ac979bd5/68747470733a2f2f692e696d6775722e636f6d2f6466626f7550312e706e67 "Mautic Open Source Marketing Automation together with the CMS power of TYPO3")](https://camo.githubusercontent.com/880c6469e5764f17c24258c054f42201690689b299699abc955b5830ac979bd5/68747470733a2f2f692e696d6775722e636f6d2f6466626f7550312e706e67)

Welcome to the official Mautic extension for TYPO3.

Supported Versions
------------------

[](#supported-versions)

We currently support Mautic v4 and higher.

- **For TYPO3 v12 please use extension release 12.0.x**
- **For TYPO3 v11 and above on PHP8, please use extension release 4.4.x**
- **For TYPO3 v10 and v11 on PHP7, please use extension release 4.3.x**
- For TYPO3 v9, please use extension release 3.x

Features
--------

[](#features)

The Mautic TYPO3 extension has many features that allow you to integrate your marketing automation workflow in TYPO3.

### Dynamic Content Blocks

[](#dynamic-content-blocks)

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. In good TYPO3 fashion, this can apply not only to content elements but also to entire pages or even data sets, templates, ...

### Form Synchronization

[](#form-synchronization)

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.

### TYPO3 Form Customization

[](#typo3-form-customization)

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'] = \Leuchtfeuer\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 a non configured element. Once the form is submitted, those custom elements are getting ignored.

### Mautic Form Actions

[](#mautic-form-actions)

Create contacts or modify the points of a contact straight from a TYPO3 Form.

### Mautic Form Content Element

[](#mautic-form-content-element)

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.

### Tracking Script Integration

[](#tracking-script-integration)

Integrate the Mautic tracking script into your frontend with one click of a button!

### OAuth 2.0 support

[](#oauth-20-support)

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.

### Tags

[](#tags)

Set tags for users when they are visiting a page!

### Assets

[](#assets)

Link to Mautic assets directly in TYPO3 using file relations or the TYPO3 link wizard!

### Language sync

[](#language-sync)

(currently in flux)

### API

[](#api)

The Mautic API  is made available (see "ContactRepository")

Installation
------------

[](#installation)

First, install the extensions *marketing\_automation* and *mautic* in your TYPO3.

Afterwards, establish the API connection:

- Go to "API Credentials" in Mautic and create a new "OAuth2" credential set (give your TYPO3 website's domain as "redirect URI")
- write down public and secret key
- go to the "API Connection" backend module in TYPO3, select "OAuth2", and enter the keys from above
- Now hit "Authorize with Mautic"
- A Mautic login windows comes up. Log in, and click "Accept"

Documentation
-------------

[](#documentation)

Documentation and a getting started guide can be found [here](https://docs.typo3.org/p/mautic/mautic-typo3/master/en-us/).

Known Issues &amp; Ideas for the Future
---------------------------------------

[](#known-issues--ideas-for-the-future)

### TYPO3 Form Builder

[](#typo3-form-builder)

- "Mautic Property Type" currently not working: Mautic field mappings are currently not possible through the TYPO3 UI, only for the pre-defined fields in template "Simple Contact Form"

### Form Framework: Currently limited support

[](#form-framework-currently-limited-support)

- Make sure to use Predefined Form from Prototype "Mautic Form"
- Recommended: Use template "Simple Contact Form"
- Mautic-side changes in form are NOT sync'd back to TYPO3
- TYPO3-side changes (fields, field properties, form type, ...) after creation are NOT sync'd to Mautic
- Make sure to use finisher "Create Mautic Contact"
- Use "Send to Mautic form" only if you wish to send to a different form ID
- Idea: Move "updating" of forms (normally by the form's Javascriupt snippets) to TYPO3 so that we can always deliver static HTML (which works even in restricted environments)

### Tags

[](#tags-1)

On the very first page visit, setting tags can not work reliably. (We are considering using mpixel in addition to API for that reason...)

### Language Sync, Assets

[](#language-sync-assets)

On the very first page visit, setting tags can not work reliably. (We are considering using mpixel in addition to API for that reason...)

Packaging for use in the Extension Manager
------------------------------------------

[](#packaging-for-use-in-the-extension-manager)

Clone the repository and run the following in the extension root directory:

```
composer package

```

Contributing Partners
---------------------

[](#contributing-partners)

- [Leuchtfeuer Digital Marketing](https://leuchtfeuer.com)
- [TYPO3 GmbH](https://typo3.com)
- [Beech](https://beech.it)

Contributing
------------

[](#contributing)

You can contribute by making a pull request to the master branch of this repository.

Questions or Suggestions?
-------------------------

[](#questions-or-suggestions)

You can always open an issue in this repository if you find a bug or have a feature request. Next to that you can also come visit us on Slack ([Mautic](https://www.mautic.org/slack) or [TYPO3](https://typo3.org/article/how-to-use-slack-in-the-typo3-community/)) in the channel `#typo3-mautic`.

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance75

Regular maintenance activity

Popularity32

Limited adoption so far

Community27

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~79 days

Recently: every ~234 days

Total

41

Last Release

62d ago

Major Versions

v2.1.0 → v3.0.02019-03-05

v2.1.1 → v4.0.0-beta2020-04-27

v3.1.2 → v4.1.02021-09-13

v3.4.0 → v4.3.0-beta32023-05-17

v4.3.4 → v12.0.02026-03-18

PHP version history (5 changes)1.1.0PHP &gt;=7.0.0

v3.0.0PHP &gt;=7.2.0

v4.3.0-beta4PHP &lt;=7.4

v4.3.1PHP &lt;8.0

v4.4.0PHP &gt;=8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2930593?v=4)[Ruth Cheesley](/maintainers/rcheesley)[@RCheesley](https://github.com/RCheesley)

![](https://avatars.githubusercontent.com/u/20301893?v=4)[Leuchtfeuer Digital Marketing](/maintainers/LeuchtfeuerDigitalMarketing)[@LeuchtfeuerDigitalMarketing](https://github.com/LeuchtfeuerDigitalMarketing)

---

Top Contributors

[![Woeler](https://avatars.githubusercontent.com/u/18422096?v=4)](https://github.com/Woeler "Woeler (108 commits)")[![flossels](https://avatars.githubusercontent.com/u/8256874?v=4)](https://github.com/flossels "flossels (46 commits)")[![ekkeguembel](https://avatars.githubusercontent.com/u/43146234?v=4)](https://github.com/ekkeguembel "ekkeguembel (29 commits)")[![balasch](https://avatars.githubusercontent.com/u/68707177?v=4)](https://github.com/balasch "balasch (28 commits)")[![Moongazer](https://avatars.githubusercontent.com/u/1685510?v=4)](https://github.com/Moongazer "Moongazer (21 commits)")[![mkauschmann](https://avatars.githubusercontent.com/u/173054489?v=4)](https://github.com/mkauschmann "mkauschmann (11 commits)")[![brosua](https://avatars.githubusercontent.com/u/34569593?v=4)](https://github.com/brosua "brosua (9 commits)")[![kreativekrise](https://avatars.githubusercontent.com/u/6876675?v=4)](https://github.com/kreativekrise "kreativekrise (6 commits)")[![ruudsilvrants](https://avatars.githubusercontent.com/u/9974197?v=4)](https://github.com/ruudsilvrants "ruudsilvrants (3 commits)")[![frans-beech-it](https://avatars.githubusercontent.com/u/4436635?v=4)](https://github.com/frans-beech-it "frans-beech-it (3 commits)")[![IchHabRecht](https://avatars.githubusercontent.com/u/1453345?v=4)](https://github.com/IchHabRecht "IchHabRecht (3 commits)")[![iwillenbrock](https://avatars.githubusercontent.com/u/132353832?v=4)](https://github.com/iwillenbrock "iwillenbrock (3 commits)")[![bmheins](https://avatars.githubusercontent.com/u/32935316?v=4)](https://github.com/bmheins "bmheins (2 commits)")[![yabid21](https://avatars.githubusercontent.com/u/78373325?v=4)](https://github.com/yabid21 "yabid21 (1 commits)")[![juliopontes](https://avatars.githubusercontent.com/u/649373?v=4)](https://github.com/juliopontes "juliopontes (1 commits)")[![stfnwbr](https://avatars.githubusercontent.com/u/2564447?v=4)](https://github.com/stfnwbr "stfnwbr (1 commits)")

---

Tags

contentformsmarketing-automationmauticpersonasphptagstargetingtypo3typo3-extensionautomationMauticmarketingTYPO3 CMS

### Embed Badge

![Health badge](/badges/mautic-mautic-typo3/health.svg)

```
[![Health](https://phpackages.com/badges/mautic-mautic-typo3/health.svg)](https://phpackages.com/packages/mautic-mautic-typo3)
```

###  Alternatives

[yoast-seo-for-typo3/yoast_seo

Yoast SEO for TYPO3

521.6M9](/packages/yoast-seo-for-typo3-yoast-seo)[derhansen/sf_event_mgt

Configurable event management and registration extension based on ExtBase and Fluid

64313.9k6](/packages/derhansen-sf-event-mgt)[brotkrueml/schema

Embedding schema.org vocabulary - API and view helpers for schema.org markup

33584.6k13](/packages/brotkrueml-schema)[ichhabrecht/mask-export

Export your mask elements as extension

45215.8k](/packages/ichhabrecht-mask-export)[extcode/cart

Shopping Cart(s) for TYPO3

57119.3k14](/packages/extcode-cart)[causal/extractor

This extension detects and extracts metadata (EXIF / IPTC / XMP / ...) from potentially thousand different file types (such as MS Word/Powerpoint/Excel documents, PDF and images) and bring them automatically and natively to TYPO3 when uploading assets. Works with built-in PHP functions but takes advantage of Apache Tika and other external tools for enhanced metadata extraction.

16244.5k](/packages/causal-extractor)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
