Knowledge Base

Installing the Firebase Plugin for Mobile App Push Notification
How incredible would it be if the AMS could send Push Notifications to your app?  Well yes you can do this with OneSignal, however not everyone is using OneSignal and we have found that many of our customers are using Firebase.

So there is a company that has released a plugin, and as always I rushed out to get it.

The plugin can be purchased from here.

The main problem is that the plugin is not that simple to install if you are a Mautic newbie or not very technical.  I went through many different iterations and frustrations before I got it up and running.

And today I am going to document the steps that are needed in order to getting it functional.  In the next blog post we will dive deeper into the configuration and workings of the module.

Installation Instructions:

1. Download the plugin

2. Save the plugin in your working directory.

3. I created a directory called Firebase as I wanted to see what was inside the zip.

4. Create a directory inside your mautic plugins folder called “FCMNotificationBundle”:
sudo mkdir /var/www/mautic/plugins/FCMNotificationBundle

5. Copy the contents of the Firebase directory to the new plugin directory:
sudo cp * /var/www/mautic/plugins/FCMNotificationBundle

6. Change the permissions on this directory to your web user, in my case it was:
sudo chown -R www-data:www-data /var/www/mautic/plugins/FCMNotificationBundle

7. This plugin requires an external php extension called bolt.  You can download it from here.

8. The way I like to do this is I made a directory called BOLT in my working directory and from there ran the command:
sudo wget

9. Unzip this file:
sudo unzip

10. Once you do this it will make a new folder with all the different versions of bolt that are relevant for your server.

11. You now need to understand what ubuntu version you are running, if it is 34 bit or 64 bit.  In order to find this out type in the following command:
getconf LONG_BIT
You will get output of either 32 or 64.

12. You then need to find out what version of php you are running.  There are many ways to find this out, if you are not that technical simply go into your Mautic and click on the Settings Cog in the top right part of your screen and choose “System Info”, Then “Pph Info” and you will see this screen:

In the above you can see that I am running php-7.3

13. Now you need to go back to your bolt directory and choose the correct version of bolt to install.  Below you will see the commands I did and the subdirectories in order to find the correct one for you. [Remember I am running on a linux 64 Bit with php-7.3]

14. Next we need to put the file in a place that the system can find it.  What I did was went and created a directory called bolt in my corresponding php directory:
sudo mkdir /etc/php/7.3/bolt

15. Next I copied the file to that directory:
sudo cp /etc/php/7.3/bolt/

16. Now we need to tell php where to find this file.  So in order to do so we need to edit our php.ini file.  As you can see from the first picture above inside the php info screen we look at, we can see that the php.ini file that Mautic is using is located in /etc/php/7.3/fpm/php.ini

17. I always like to make a backup of files I am editing, so i did the following:
sudo cd /etc/php/7.3/fpm/
sudo cp php.ini php.ini.bak

18. Now you need to go and edit this file.  You can use either nano or vim, whatever is easier for you.  Open the file and search for the word “extension”. You need to look for the section that begins with Dynamic Extensions

19. Next scroll to the bottom of that section and add in a line:

20. Now you need to restart the php-fpm service in order for it to re-read the php.ini file:
sudo systemctl restart php7.3-fpm

21. At this stage I suggest going back to Mautic and refreshing the System Info window and searching for the word bolt.  You should see something like this:

22. Next thing is you need to make sure you have composer installed, if you do not you can follow the instructions here.

23. Now we need to run composer to get the plugins dependancies installed.  To do this go to your mautic directory:
sudo cd /var/www/mautic/
sudo -u www-data composer require plokko/firebase-php

24. Some Issues that might come up

25. You might have installed version 2 of composer and if so you will get the following error

26. If this is the case you will need to downgrade your version of composer.  In order to do so run the following command:
sudo composer self-update –1

27. Once this is done you can go back to point #23 and rerun composer.

28. The last thing to do it to clear mautic cache:
cd /var/www/mautic/var/cache/
sudo rm -rf *

29. No go back to Mautic and click on Settings-> Plugins and you should see the new plugin installed and ready to be configured there.


Stay tuned for the next blog on how to configure the plugin and put it to the test!!

5 Best Practices for Effective Marketing Automation with Surge.AMS

Surge.AMS is a powerful marketing automation tool that allows you to create and execute complex marketing campaigns to engage your audience and drive business growth. One of the key features of Surge.AMS is its ability to create targeted segments, campaigns, emails,...

Surge.AMS – easy to implement tips

Automated marketing can be a powerful tool for businesses of all sizes, and Surge.AMS is a great platform for those looking to get started. One of the key features of Surge.AMS is its ability to track visitors and segment them dynamically, which can be used to create...

Cape Media enjoying the power of Surge.Media

Cape Media, one of the leading SportsBook Affiliates in the United States has seen great success with Surge.AMS. In the beginning of 2021 Surge.Media formed a relationship with Cape Media where they began to provide both strategic, operational and technical services...

Benefits of Automated Marketing

In 2022, more and more companies began to realize the potential of automated marketing to improve their bottom line. Automated marketing refers to the use of software and technology to automate repetitive, time-consuming tasks related to marketing campaigns, such as...

Surge.Media is happy to announce the onboarding of Cipher Sports Technology Group as its latest customer

Surge. will be providing its Automated Marketing System to Cipher Sports Technology Group, bringing a high level of hyper personalized customer communication and automation to the groups web brands. Using Surge. technology will assist in enabling Cipher’s customers to...

Protected: Installing Metabase BI & Building Customized BI For the AMS

Password Protected

To view this protected post, enter the password below:

I sent an email and made a sale!

This is a sentence I am always surprised to hear from our clients.  So many people are under the impression that e-mails don't work anymore.  People are focused on social platforms, text messages and whatsapp. We meet so many clients that have legacy data that they...

Using Campaigns to Manage Sales Follow Up Cycle

In continuation from our previous post on "Using Campaigns to Improve Sales Cycle" we now move into using Mautic campaigns to help the sales team follow up with leads that come in. Firstly we consulted with our clients on their needs, and in a very general case what...

Using Campaigns to Improve Sales Cycle

The AMS has many hidden features that can be used in conjunction to improve your overall sales cycle. At Surge we have used advanced campaigns and logic to help increase a business overall sales cycle and to boost conversion rates. How did we do this ? We started off...

E-Mail Frequency – Is Too Little Too Much or Vice-a-Versa

What a question to ask ? Probably the most debated question among marketeers throughout time (or at least since email was around). Everyone has their own opinion, and each opinion is valid and correct. There is no real right or wrong answer over here. At Surge we...