PHPackages                             punktde/mautic - 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 & Helpers](/categories/utility)
4. /
5. punktde/mautic

ActiveNeos-package[Utility & Helpers](/categories/utility)

punktde/mautic
==============

This Plugin enables the usage of Marketing Automation Tool Mautic together with Neos CMS.

1.0.1(6y ago)4952[1 PRs](https://github.com/punktDe/mautic/pulls)MITPHP

Since Aug 30Pushed 5y ago6 watchersCompare

[ Source](https://github.com/punktDe/mautic)[ Packagist](https://packagist.org/packages/punktde/mautic)[ RSS](/packages/punktde-mautic/feed)WikiDiscussions master Synced yesterday

READMEChangelog (1)Dependencies (2)Versions (3)Used By (0)

Neos Mautic Plugin
==================

[](#neos-mautic-plugin)

This Plugin enables the usage of Marketing Automation Tool Mautic together with Neos CMS. Its key features are:

- Add Mautic Tracking in two easy steps
- Data Collection via Neos Forms & Neos FormBuilder Forms
- SEO friendly dynamic content

Installation
============

[](#installation)

```
composer require punktde/mautic

```

Configuration
=============

[](#configuration)

### Configure Mautic

[](#configure-mautic)

- Visit your Mautic installation and [create a user for API](https://mautic.com/help/users-and-roles/).
- [Enable API and HTTP basic auth](https://mautic.com/help/api-quick-start/). Optional: Be sure your Mautic installation is running on HTTPS for the sake of security.
- Skip this, if your website and Mautic are running on the same server:
    - [Enable CORS](https://mautic.com/help/getting-started-mautic-cloud/#4), add your site to `valid domains`.

### Configure Plugin

[](#configure-plugin)

Add the following configuration to your site's Settings.yaml

```
PunktDe:
  Mautic:
    mauticServer:
      url: https://mymautic.com
    mauticUser:
      username: mautic-api
      password:

```

Enable Tracking
===============

[](#enable-tracking)

- Ensure you have entered the correct Mautic URL in your configuration.
- Place Mautic tracking template at the bottom of your ``:

    ```
    mautic = PunktDe.Mautic:MauticTracking

    ```

Add this code to every page's fusion file you want to be tracked. If you want to track all pages, add this piece to the `Root.fusion` or `AbstractPage.fusion` of your page.

Pass Information from Form to Mautic
====================================

[](#pass-information-from-form-to-mautic)

### Form in yaml format

[](#form-in-yaml-format)

To pass information from yaml forms to Mautic, you need to define which form elements should be taken into account. Add the following property to those fields:

```
mauticIdentifier: 'firstname'

```

**Due to a bug in Mautic API, `mauticIdentifier` must be small case.**

You also need to add the following finisher:

```
identifier: 'PunktDe.Mautic:UpdateUser'

```

An example form looks like this:

```
type: 'Neos.Form:Form'
identifier: 'form-identifier'
label: 'Blog comment'
renderingOptions:
  submitButtonLabel: 'Send'
renderables:
  -
    type: 'Neos.Form:Page'
    identifier: 'blog-comment'
    renderables:
      -
        type: 'Neos.Form:SingleLineText'
        identifier: 'name'
        label: 'Name'
        properties:
          mauticIdentifier: 'firstname'
        defaultValue: ''
finishers:
  -
    identifier: 'PunktDe.Mautic:UpdateUser'

```

The value of `mauticIdentifier` must be a defined user field (so called custom field) in Mautic. You can search, edit or create new [custom fields](https://www.mautic.org/docs/en/contacts/manage_fields.html) to fit your needs.

### Form in FormBuilder Format

[](#form-in-formbuilder-format)

Forms created by FormBuilder require the editor to enter the Mautic identifier in the Neos backend. This can be achieved by selecting the form element and setting up the value in the settings bar on the right side of your UI.

**Due to a bug in Mautic API, `mauticIdentifier` must be small case.**

You must also register the Mautic finisher for this form.

[![](ReadmeFiles/registerFinisher.gif)](ReadmeFiles/registerFinisher.gif)

Dynamic Content
===============

[](#dynamic-content)

You can show a different content dimension to users belonging to different Mautic segments.

- [Create a new segment in Mautic](https://mautic.com/help/segments/).
- Define segments in your `settings.yaml`. Use the same name for your Neos dimensions as well as your mautic segments.

    Neos: ContentRepository: contentDimensions: mautic: label: 'Mautic Segment' icon: 'icon-globe' default: defaultUser defaultPreset: defaultUser presets: all: null defaultUser: label: 'Default User' values: - defaultUser uriSegment: '' twitter: label: twitter values: - twitter uriSegment: twitter
- You can combine multiple dimensions (e.g. language) without problem.
- Visit the backend, change the dimension and edit content. Publish it.

[![](ReadmeFiles/changeDimension.gif)](ReadmeFiles/changeDimension.gif)

Social Media Tracking
=====================

[](#social-media-tracking)

It is possible to track users coming from different sources using UTM-Tags. Just add any UTM Tag to your link before you post it on social media:

```
https://punkt.de/blog/post?utm-source=AnySourceName

```

When a user has UTM-Tags and submit a form, this information will also saved in Mautic.

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~4 days

Total

2

Last Release

2444d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0fad3b9ab04057e586b701aca7a8dbbf9598718114cdfd6bf85dada030f7688e?d=identicon)[punktde](/maintainers/punktde)

---

Top Contributors

[![Jashi](https://avatars.githubusercontent.com/u/2505937?v=4)](https://github.com/Jashi "Jashi (1 commits)")

---

Tags

marketingmarketing-automationmauticneoscms

### Embed Badge

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

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

###  Alternatives

[sitegeist/monocle

An living-styleguide for Neos that is based on the actual fusion-code

45315.9k10](/packages/sitegeist-monocle)[sitegeist/kaleidoscope

Responsive-images for Neos

29352.4k10](/packages/sitegeist-kaleidoscope)[flowpack/listable

Tiny extension for listing things

35209.0k7](/packages/flowpack-listable)[kaufmanndigital/gdpr-cookieconsent

A ready-to-run package, that integrates an advanced cookie consent banner into your Neos CMS site.

2540.7k](/packages/kaufmanndigital-gdpr-cookieconsent)[neos/seo

SEO configuration and tools for Neos

13990.5k24](/packages/neos-seo)[shel/neos-colorpicker

A plugin for Neos CMS which provides a colorpicker editor

1494.4k6](/packages/shel-neos-colorpicker)

PHPackages © 2026

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