mauticinsights / mautic-observer
Observes Mautic contact, email, campaign, form, page and segment events and streams them to the Mautic Insights ingest API.
Package info
github.com/mauticinsights/mautic-observer
Type:mautic-plugin
pkg:composer/mauticinsights/mautic-observer
Requires
- php: >=8.2
Requires (Dev)
- dg/bypass-finals: ^1.9
- doctrine/dbal: ^3.8
- doctrine/orm: ^2.14
- friendsofphp/php-cs-fixer: ^3.59
- phpstan/phpstan: ^1.12
- phpunit/phpunit: ^9.6
- symfony/config: ^6.4
- symfony/console: ^6.4
- symfony/dependency-injection: ^6.4
- symfony/form: ^6.4
- symfony/http-client: ^6.4
- symfony/http-kernel: ^6.4
- symfony/translation-contracts: ^3.0
- symfony/validator: ^6.4
Suggests
- ext-redis: Optional: Redis fallback for the API event buffer when the filesystem cache directory is not writable.
- mautic/core-lib: Mautic 7.x core (^7.0) — required in production; not installed in this repo for standalone dev tooling.
Provides
None
Conflicts
None
Replaces
None
README
Observes Mautic contact, email, campaign, form, page and segment events and streams them to the Mautic Insights ingest API.
Requirements
| Line | PHP | Mautic | Packagist constraint |
|---|---|---|---|
| Mautic 5 | PHP 8.0+ | Mautic 5.x | mauticinsights/mautic-observer:^5 |
| Mautic 6 | PHP 8.1+ | Mautic 6.x (mautic/core-lib ^6.0) |
mauticinsights/mautic-observer:^6 |
| Mautic 7 | PHP 8.2+ | Mautic 7.x (mautic/core-lib ^7.0) |
mauticinsights/mautic-observer:^7 |
- Composer 2.x
Installation
Recommended (Packagist)
Install from the root of your Mautic project. Use a constraint that matches your Mautic major version.
Mautic 7
composer require mauticinsights/mautic-observer:^7
Mautic 6
composer require mauticinsights/mautic-observer:^6
Mautic 5
composer require mauticinsights/mautic-observer:^5
Composer installs the bundle into plugins/MauticInsightsBundle (extra.install-directory-name).
then
php bin/console cache:clear php bin/console mautic:plugins:reload
Alternative: install from ZIP (no Composer)
-
Download Source code (zip) for the release that matches your Mautic major version (plugin
5.x→ Mautic 5.x,6.x→ Mautic 6.x,7.x→ Mautic 7.x, …): github.com/mauticinsights/mautic-observer/releases. -
Extract the ZIP into your Mautic plugins directory as
plugins/MauticInsightsBundle(on Composer-based installs oftendocroot/plugins/MauticInsightsBundle).The plugin root must contain
composer.jsonat:plugins/MauticInsightsBundle/composer.jsonGitHub ZIPs usually unpack to a folder like
mautic-observer-7.0.4— rename that folder toMauticInsightsBundle(or extract so the contents land directly inplugins/MauticInsightsBundle/). -
In the Mautic UI, open Settings → Plugins and click Install/Upgrade Plugins (instead of
composer require).
Then in the Mautic UI:
- Open Settings → Plugins (after a ZIP install, use Install/Upgrade Plugins first if the plugin is not listed yet).
- Find Mautic Insights
- Enter the Insights API token and required settings
- Publish / enable the integration
License
Proprietary — see LICENSE.