You can implement Mautic in Tiki in two ways.
The first way is the basic configuration and the second is for the advanced configuration.
Basic Configuration
The basic configuration is sufficient in case you only want to track the activity on your instance.
Follow these steps for basic integration:
- You need to make sure these two things are enabled:
By activating this, the Mautic plugin will be available in the list of usable plugins.
To activate the Mautic plugin, go to Control Panels -> Main Features -> Editing and Plugins -> Plugins (Tab).
Find Mautic Integration and activate the plugin.
Although the plugin is enabled, if the feature is not, you will not be able to use the Mautic plugin.
So to enable this feature, go to Control Panels -> Global Setup -> Features, search for Integration and enable the feature.
- Connect Tiki to Mautic
It's even the first thing to do to use Mautic in Tiki.
To connect Tiki to Mautic go to Control Panel-> Advanced-> Mautic Automation. Or go directly to the tiki-admin.php?page=mautic page.
On this page you will:
- Fill in the Mautic URL field: the domain on which your Mautic instance is hosted.
- Add the Tracking Script Location: This is where you want the Mautic script to be inserted (either between the tags or before the closing tag). If you don't want to track visitor activities, then select the third option
- Credentials: fill in the credentials allowing Tiki to connect to your Mautic dashboard.
Now that you have completed these steps, your Tiki should already be connected to Mautic and ready for tracking (unless you checked the third option for Tracking script location).
Advanced Configuration
The advanced configuration is suitable for the following cases:
- You would like to include a Mautic form in a Tiki page to be able to save your contacts in Mautic.
- You would like to display/list the contacts created in Mautic from your Tiki instance.
This part is therefore the continuation of the basic configuration.
Make sure the following is already done, if not refer to the previous part:
- The Mautic Plugin and the Mautic Feature are enabled.
- The plugin is configured (Mautic URL, Tracking Script Location, and Credentials are provided)
Embed the Mautic form in a Wiki page
To embed a Mautic form in Tiki, you need to do it in two steps:
In Mautic Instance
In Mautic, there is not much to do; you just have to create the form(s) you need to collect the data from your Tiki instance and save it.
To do this, log into your Mautic instance, go to Components->Forms->New; then create a form of your choice (standard or campaign), then put in it all the fields necessary for data collection.
All that remains is to integrate this form into a Wiki page.
In Tiki Instance
In Tiki, create a page, then use the help button to search for the Mautic plugin and select it.
A pop-up will open with options depending on the selected Data Type.
Type data is the type of the Mautic object you want to insert into the page. These values do not come from Mautic but they are values known to the plugin.
As the goal here is to insert a Mautic form in the page, we will leave the default type "Mautic Form".
We, therefore, have another very important field to fill in, the Form Id.
Form ID is mandatory because you must specify the id of the Mautic form you want to embed. You can get it from your Mautic address bar just by clicking on the form you want to insert.
If for example, your Mautic form has id 1, you can directly copy and paste this syntax into the page:
Copy to clipboard {mautic type="form" form_id="1"}
After inserting the plugin, save the page and you will see the Mautic form included in the Wiki page.
Note: If you don't see the form, you need to check if you have put the correct Mautic credentials in the admin panel.
After submitting the form, you can find the contact already created in Mautic.
Congratulations, you have successfully included the Mautic form in a Wiki page. Let's meet in the next part if you would like to retrieve them and then display them on a Wiki page.
From Tiki, you can also view contacts already saved in Mautic.
For this to be possible, you must authorize the use of the Mautic API and the basic auth authentication without which you will not receive any data, because Mautic will block access to the API.
API and HTTP basic auth
In Mautic, make sure that the API is authorized so that you can access your data, and that the basic auth authentication method is activated.
To enable the API and HTTP basic auth, log in to the dashboard, then go to settings->Configurations->API Settings.
You can now create a new page and then, using the help button, search for the Mautic plugin and select it.
Here you have to change the type of object to Mautic Contact by changing the value of Type data, you will see a new field Vote options.
You can leave this field empty as it only limits the actions you can take once the contacts have been listed.
After submitting the pop-up form and saving the page, you can find all Mautic contacts listed on it.
You can directly copy and paste this syntax into the page: Copy to clipboard {mautic type="contacts"}
|