Title: WP Mautic
Author: Mautic
Published: <strong>Februarie 27, 2015</strong>
Last modified: Februarie 26, 2026

---

Soek deur uitbreidings

![](https://ps.w.org/wp-mautic/assets/banner-772x250.png?rev=3337392)

![](https://ps.w.org/wp-mautic/assets/icon.svg?rev=3337392)

# WP Mautic

 Deur [Mautic](https://profiles.wordpress.org/mautic/)

[Laai Af](https://downloads.wordpress.org/plugin/wp-mautic.2.5.1.zip)

 * [Besonderhede](https://af.wordpress.org/plugins/wp-mautic/#description)
 * [Aanbevelings](https://af.wordpress.org/plugins/wp-mautic/#reviews)
 *  [Installation](https://af.wordpress.org/plugins/wp-mautic/#installation)
 * [Ontwikkeling](https://af.wordpress.org/plugins/wp-mautic/#developers)

 [Hulp](https://wordpress.org/support/plugin/wp-mautic/)

## Beskrywing

[Mautic](http://mautic.org) [WordPress Plugin](https://wordpress.org/plugins/wp-mautic/)
injects Mautic tracking script and image in the WP website. Your Mautic instance
will be able to track information about your visitors. You can also insert Mautic
content inside your website using different shortcodes.

### Key features

 * You don’t have to edit source code of your template to insert tracking code.
 * Plugin adds additional information to tracking image URL so you get better results
   than using just plain HTML code of tracking image.
 * You can use Mautic form embed with shortcode described below.
 * You can choose where the script is injected (header / footer).
 * Tracking image can be used as fallback when JavaScript is disabled.

### Configuration

Once installed, the plugin must appared in your plugin list :

 1. Enable it.
 2. Go to the settings page and set your Mautic instance URL.

And that’s it !

### Usage

### Mautic Tracking Script

Tracking script works right after you finish the configuration steps. That means
it will insert the `mtc.js` script from your Mautic instance. You can check HTML
source code (CTRL + U) of your WP website to make sure the plugin works. You should
be able to find something like this:

    ```
    <script>
        (function(w,d,t,u,n,a,m){w['MauticTrackingObject']=n;
            w[n]=w[n]||function(){(w[n].q=w[n].q||[]).push(arguments)},a=d.createElement(t),
            m=d.getElementsByTagName(t)[0];a.async=1;a.src=u;m.parentNode.insertBefore(a,m)
        })(window,document,'script','http://yourmauticsite.com/mtc.js','mt');

        wpmautic_send();
    </script>
    ```

#### Custom attributes handling

If you need to send custom attributes within Mautic events, you can use the `wpmautic_tracking_attributes`
filter.

    ```
    add_filter('wpmautic_tracking_attributes', function($attrs) {
        $attrs['preferred_locale'] = $customVar;
        return $attrs;
    });
    ```

The returned attributes will be added to Mautic payload.

### Mautic Forms

To load a Mautic Form to your WP post, insert this shortcode to the place you want
the form to appear:

    ```
    [mautic type="form" id="1"]
    ```

Replace “1” with the form ID you want to load. To get the ID of the form, go to 
your Mautic, open the form detail and look at the URL. The ID is right there. For
example in this URL: http://yourmautic.com/s/forms/view/3 the ID is 3.

### Mautic Focus

To load a Mautic Focus to your post, insert this shortcode to the place you want
the form to appear:

    ```
    [mautic type="focus" id="1"]
    ```

Replace “1” with the focus ID you want to load. To get the ID of the focus, go to
your Mautic, open the focus detail and look at the URL. The ID is right there. For
example in this URL: http://yourmautic.com/s/focus/3.js the ID is 3.

### Mautic Dynamic Content

To load dynamic content into your WP content, insert this shortcode where you’d 
like it to appear:

    ```
    [mautic type="content" slot="slot_name"]Default content to display in case of error or unknown contact.[/mautic]
    ```

Replace the “slot_name” with the slot name you’d like to load. This corresponds 
to the slot name you defined when building your campaign and adding the “Request
Dynamic Content” contact decision.

### Mautic Gated Videos

Mautic supports gated videos with Youtube, Vimeo, and MP4 as sources.

To load gated videos into your WP content, insert this shortcode where you’d like
it to appear:

    ```
    [mautic type="video" gate-time="#" form-id="#" src="URL"]
    [mautic type="video" src="URL"]
    ```

Replace the # signs with the appropriate number. For gate-time, enter the time (
in seconds) where you want to pause the video and show the mautic form. For form-
id, enter the id of the mautic form that you’d like to display as the gate. Replace
URL with the browser URL to view the video. In the case of Youtube or Vimeo, you
can simply use the URL as it appears in your address bar when viewing the video 
normally on the providing website. For MP4 videos, enter the full http URL to the
MP4 file on the server.

Since the Mautic v2.9.1 release, the form-id is not mandatory anymore, mautic video
can be tracked.

### Mautic Tags

You can add or remove multiple lead tags on specific pages using commas. To remove
an tag you have to use minus “-” signal before tag name:

    ```
    [mautic type="tags" values="mytag,anothertag,-removetag"]
    ```

## Installation

### Via WP administration

Mautic – WordPress plugin [is listed](https://wordpress.org/plugins/wp-mautic/) 
in the in the official WordPress plugin repository. That makes it very easy to install
it directly form WP administration.

 1. Go to _Plugins_ / _Add New_.
 2. Search for **WP Mautic** in the search box.
 3. The “WP Mautic” plugin should appear. Click on Install.

### Via ZIP package

If the installation via official WP plugin repository doesn’t work for you, follow
these steps:

 1. [Download ZIP package](https://github.com/mautic/mautic-wordpress/archive/master.zip).
 2. At your WP administration go to _Plugins_ / _Add New_ / _Upload plugin_.
 3. Select the ZIP package you’ve downloaded in step 1.

## Aanbevelings

![](https://secure.gravatar.com/avatar/f4b8a28fced57a07973bc5fe6b492ee079e2734cedbfaed87373ef4b135e8df5?
s=60&d=retro&r=g)

### 󠀁[trouble. Track user’s in comments](https://wordpress.org/support/topic/trouble-track-users-in-comments/)󠁿

 [joseayres](https://profiles.wordpress.org/joseayres/) Julie 28, 2020 1 reply

plugin don’t track user’s in comments in wordpress site in my website paznasmaos.
com.br. How fix it?

![](https://secure.gravatar.com/avatar/a53646764fda6f9095d1b18478b82373661653805542e29c5a65c2807741a49a?
s=60&d=retro&r=g)

### 󠀁[Works perfectly thank you!](https://wordpress.org/support/topic/works-perfectly-thank-you-3/)󠁿

 [inspiretk](https://profiles.wordpress.org/inspiretk/) Julie 2, 2017

Works perfectly thank you! Saved me a lot of time from using the manual way of copying
the code across from Mautic to Wordpress. Now if I update my form in Mautic, its
automatically updated in my Wordpress.

![](https://secure.gravatar.com/avatar/e21b9b561a60c50d6c139b9e19db29beeb76d04ebd5b4b1576f888f9137e8554?
s=60&d=retro&r=g)

### 󠀁[Perfect](https://wordpress.org/support/topic/perfect-4113/)󠁿

 [giangadotti](https://profiles.wordpress.org/giangadotti/) Junie 7, 2017

Works realy fine… bet on it!

![](https://secure.gravatar.com/avatar/2211f292ef42b7128faabeb93da07ad3ed071fa4bddd010220a23c41a3e16942?
s=60&d=retro&r=g)

### 󠀁[Great Integration, but need some updates!](https://wordpress.org/support/topic/great-integration-but-need-some-updates/)󠁿

 [erikdigitalpixel](https://profiles.wordpress.org/erikdigitalpixel/) September 
3, 2016 1 reply

Amazing Plugin, working fine in Worpdress 4.4.2 But i miss some functions: #1 – 
Add the Shortcode in Text Widgets, or exist some widget form; #2 – Select to import
or not the CSS;

![](https://secure.gravatar.com/avatar/d067d24f02454fb36c94ab1665e1706f1e90d69ef2d3809eea4b2d20317899ac?
s=60&d=retro&r=g)

### 󠀁[Perfeito](https://wordpress.org/support/topic/perfeito-66/)󠁿

 [Rogerio Martins](https://profiles.wordpress.org/irogerthat/) September 3, 2016

Funciona perfeitamente. agradável.

![](https://secure.gravatar.com/avatar/b0df3b69e5d285303d2f59f221ea591a93d80bbccbaaa36b3c167609258e98fa?
s=60&d=retro&r=g)

### 󠀁[Excellent addon](https://wordpress.org/support/topic/excellent-addon-2/)󠁿

 [valkalon](https://profiles.wordpress.org/valkalon/) September 3, 2016

A must have to interface WordPress and mautic. Works like a charm, gret work !

 [ Read all 8 reviews ](https://wordpress.org/support/plugin/wp-mautic/reviews/)

## Contributors & Developers

“WP Mautic” is oopbron sagteware. Die volgende mense het bygedra tot die ontwikkeling
van hierdie uitbreiding:

Contributors

 *   [ Mautic ](https://profiles.wordpress.org/mautic/)
 *   [ hide ](https://profiles.wordpress.org/hideokamoto/)
 *   [ shulard ](https://profiles.wordpress.org/shulard/)
 *   [ escopecz ](https://profiles.wordpress.org/escopecz/)
 *   [ dbhurley ](https://profiles.wordpress.org/dbhurley/)
 *   [ macbookandrew ](https://profiles.wordpress.org/macbookandrew/)
 *   [ Dog Byte Marketing ](https://profiles.wordpress.org/dogbytemarketing/)

“WP Mautic” has been translated into 9 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/wp-mautic/contributors)
for their contributions.

[Translate “WP Mautic” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-mautic)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/wp-mautic/), check 
out the [SVN repository](https://plugins.svn.wordpress.org/wp-mautic/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/wp-mautic/) by [RSS](https://plugins.trac.wordpress.org/log/wp-mautic/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### v2.5.1

Release date: 2026-2-26

 * Changes
    - Added: Handling for SVN publishing

#### v2.5.0

Release date: 2026-2-26

 * Changes
    - Refactored: Codebase to be OOP and PSR-4 compliant.
    - Updated: Pixel setting to allow it to be the default tracking method
    - Updated: Translations

#### v2.4.2

Release date: 2020-12-14

 * Changes
    - Add missing style on shortcode embedded image.

#### v2.4.1

Release date: 2020-12-14

 * Changes
    - Add an alt text on the `<noscript>` image that can be handled with WP
       translation.

#### v2.4.0

Release date: 2020-09-28

 * Changes
    - Update text to be more clear regarding tracking cookies injection when using
      
      shortcodes and tracking pixel.
    - Create a specific `wpmautic_send` javascript function that can be called by
      
      third party scripts to start tracking when user accepts it (GDPR compliance).

#### v2.3.2

Release date: 2020-03-09

 * Changes
    - Fix error in the `plugin_action_links` named call which to the filter to never
      being called.

#### v2.3.1

Release date: 2020-03-09

 * Changes
    - We are now compatible with WordPress 5.4.*
    - Our “settings” link in the “Plugins” screen is now only applied to WPMautic.

#### v2.3.0

Release date: 2020-02-20

 * Added
    - Refine wording on the settings page, to be more meaningful.
    - Introduce readme.txt generator to avoid manual manipulation during release.
    - Add Makefile to simplify the command to run inside the project.
    - Add a new `script_location` value to disable script rendering on page load(
      GDPR compliance).
 * Changes
    - We are now compatible with PHP 7.4 and WordPress 5.3.*

#### v2.2.2

Release date: 2017-11-13

 * Changed
    - We are now compatible with PHP7.2 and WordPress 4.9.

#### v2.2.1

Release date: 2017-08-24

 * Changed
    - Fix an escaping error when using HTML in Mautic Dynamic Content shortcode.
      Previously, the HTML code was escaped…
    - Remove obsolete shortcode syntax from documentation and code comments. They
      are still handled and not marked deprecated at the moment.

#### v2.2.0

Release date: 2017-08-07

 * Changed
    - Add compatibility with the new Mautic 2.9.1 video features. It allow to track
      video even when not linked to a form ID (https://github.com/mautic/mautic/
      pull/4438).

#### v2.1.1

Release date: 2017-07-19

 * Changed
    - Update some labels which are not clear enough.

#### v2.1.0

Release date: 2017-07-19

 * Added
    - Call translation on all labels, plugin is translation ready !
    - Add a new function `wpmautic_get_tracking_attributes` which defines attributes
      to be sent through JS and Image trackers.
    - Add a filter `wpmautic_tracking_attributes` to allow developers injecting 
      custom attributes in trackers.
    - Add the ability to track logged user (within an option)
 * Changed
    - Add valid text domain and start official translation process.

#### v2.0.4

Release date: 2017-06-03

 * Changed
    - Hotfix release, the async attribute on form generator script blocks `document.
      write`.

#### v2.0.3

Release date: 2017-06-02

 * Changed
    - Hotfix release, the option group wasn’t valid.

#### v2.0.2

Release date: 2017-06-02

 * Added
    - Make a solid test suite to check every plugin parts (settings, loading, injection)
    - Add a new setting to activate tracking image as a fallback when javascript
      is disabled
 * Changed
    - Refactor shortcode handling and put everything in shortcodes.php.
    - Clean old code from the repository (wpmautic_wp_title).

#### v2.0.1

Release date: 2017-05-25

 * Added
    - Add a new option in settings screen to choose where the script is injected.
    - Add new tests around script injection.

#### v2.0.0

Release date: 2017-05-25

 * Added
    - Composer development requirement (squizlabs/php_codesniffer).
    - Code sniffer configuration : phpcs.xml.
    - Update code using the sniff.
    - Add basic unit tests using PHPUnit.
    - Activate continuous integration using Travis-CI (check .travis.yml file).
 * Changed
    - Use escape functions when printing data: esc_url.

#### v1.1.0

Release date: 2017-05-06

 * Added
    - Add support for Gated video.
    - Use JavaScript tracker instead of Gif image.
 * Changed
    - First release on the Github repository, will start changelog from that point…

#### v1.0.1

Release date: 2015-11-05

#### v1.0.0

Release date: 2015-03-02

 * Changed
    - First release made on the WordPress repository.

## Meta

 *  Version **2.5.1**
 *  Last updated **2 maande gelede**
 *  Active installations **6 000+**
 *  WordPress version ** 4.6 or higher **
 *  Tested up to **6.8.5**
 *  Languages
 * [Dutch](https://nl.wordpress.org/plugins/wp-mautic/), [English (UK)](https://en-gb.wordpress.org/plugins/wp-mautic/),
   [English (US)](https://wordpress.org/plugins/wp-mautic/), [French (France)](https://fr.wordpress.org/plugins/wp-mautic/),
   [Japanese](https://ja.wordpress.org/plugins/wp-mautic/), [Marathi](https://mr.wordpress.org/plugins/wp-mautic/),
   [Spanish (Chile)](https://cl.wordpress.org/plugins/wp-mautic/), [Spanish (Colombia)](https://es-co.wordpress.org/plugins/wp-mautic/),
   [Spanish (Mexico)](https://es-mx.wordpress.org/plugins/wp-mautic/), en [Spanish (Spain)](https://es.wordpress.org/plugins/wp-mautic/).
 *  [Vertaal na jou taal](https://translate.wordpress.org/projects/wp-plugins/wp-mautic)
 * Tags
 * [automation](https://af.wordpress.org/plugins/tags/automation/)[marketing](https://af.wordpress.org/plugins/tags/marketing/)
 *  [Gevorderde Aansig](https://af.wordpress.org/plugins/wp-mautic/advanced/)

## Punte-toekennings

 4.9 out of 5 stars.

 *  [  7 5-star reviews     ](https://wordpress.org/support/plugin/wp-mautic/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/wp-mautic/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/wp-mautic/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/wp-mautic/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/wp-mautic/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/wp-mautic/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/wp-mautic/reviews/)

## Contributors

 *   [ Mautic ](https://profiles.wordpress.org/mautic/)
 *   [ hide ](https://profiles.wordpress.org/hideokamoto/)
 *   [ shulard ](https://profiles.wordpress.org/shulard/)
 *   [ escopecz ](https://profiles.wordpress.org/escopecz/)
 *   [ dbhurley ](https://profiles.wordpress.org/dbhurley/)
 *   [ macbookandrew ](https://profiles.wordpress.org/macbookandrew/)
 *   [ Dog Byte Marketing ](https://profiles.wordpress.org/dogbytemarketing/)

## Hulp

Got something to say? Need help?

 [Gaan na die hulp-forum](https://wordpress.org/support/plugin/wp-mautic/)

## Skenk

Wil jy graag die ontwikkeling van hierdie uitbreiding ondersteun?

 [ Skenk aan hierdie uitbreiding ](https://opencollective.com/mautic/donate)