leuchtfeuer / mautic-identity-sync

7.0.1 2026-10-22 08:46 UTC

Requires

• php: ^8.2
• ext-json: *
• mautic/core-lib: ^7.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.4
• phpunit/phpunit: ^9.5
• symfony/browser-kit: ^7.4

GPL-3.0

• Leuchtfeuer Digital Marketing GmbH

• plugin
• contacts
• integration
• pixel
• Mautic

Published on Packagist.org on 2026-10-22 08:47 UTC

README

Overview

Allow sync of Mautic lead identity from external systems (e.g. CMS login) through a control-pixel with query-parameter.

Requirements

Tip

Other releases of this plugin may cover different Mautic versions!

• Mautic 7.x (minimum 7.0)
• PHP 8.2+

Installation

Composer

This plugin can be installed through composer.

Manual Installation

Alternatively, it can be installed manually, following the usual steps:

• Download the plugin
• Unzip to the Mautic plugins directory
• Rename folder to LeuchtfeuerIdentitySyncBundle
• In the Mautic backend, go to the Plugins page as an administrator
• Click on the Install/Upgrade Plugins button to install the Plugin.

OR

• If you have shell access, execute php bin/console cache:clear and php bin/console mautic:plugins:reload to install the plugins.

Configuration

The plugin has feature-settings to specify the contact-fields for identification:

1. Primary identifier (required): set the contact-field which is used as query-parameter for identification (e.g. email). Only fields are shown where field-setting "Is Unique Identifier" is true.
2. Secondary identifier (optional): specify an additional query-parameter which is used in combination with the first one to enforce identification.

Usage

1. Embed the control-pixel to the template of an external CMS where a customer is identified, e.g. after a successful login.
2. Pass the identifier (e.g. the email-address) as query parameter to the control-pixel: https://my-mautic.site/mcontrol.gif?email=[e-mail].
3. Optional: pass additional attributes or custom-fields of Mautic contacts to the control-pixel to update them (make sure that these attributes are set to "Publicly updatable"!): mcontrol.gif?email=[e-mail]&title=Sir&my_custom_field=Demo-Value.

Known Issues

None.

Troubleshooting

Make sure you have not only installed but also enabled the Plugin. If things are still funny, please try:

php bin/console cache:clear

Change log

• https://github.com/Leuchtfeuer/mautic-identity-sync/releases

Future Ideas

Sponsoring & Commercial Support

We are continuously improving our plugins. If you are requiring priority support or custom features, please contact us at [e-mail].

Get Involved

Feel free to open issues or submit pull requests on GitHub. Follow the contribution guidelines in CONTRIBUTING.md.

Credits

@Moongazer @JonasLudwig1998

Author

Leuchtfeuer Digital Marketing GmbH

Please raise any issues in GitHub. For all other things, please email [e-mail]

License

This plugin is licensed under the GPL v3 License.