We use cookies to understand how you use our site and to improve your experience on our website.

If you do not change browser settings, you agree to it. Learn more

I understand

By continuing to use our site, you accept our use of cookies, Privacy Note and Terms of Service.

JoomPush Documentation

JoomPush Documentation

This documentation contains Guides and How-tos to setup and configure JoomPush on your Joomla site.


Before we begin, ensure that you have met the System Requirements in order for JoomPush to operate correctly. You may find the most basic requirements for JoomPush below:


Every information related to PHP and MySQL is presented on Joomla’s page, click here to see details

  • Joomla 3.x

PHP Requirements

JoomPush runs on PHP and it requires PHP to exist on the site.

  • 5.3+ and above.

MySQL Requirements

JoomPush requires a minimum version of MySQL 5+

Checking System Requirements

You may review these requirements from the management system: System → System Information → PHP Settings

You can also create a very simple PHP script and include the codes below in your php file.

   // This is a very simple method to load up php's settings.

SSL certificate websites

Push Notifications will work only on sites have HTTPS / SSL certificates and on Google Chrome and Mozilla Firefox latest version browsers.

How to Install

Installation and Configuration

Assuming that you have already downloaded the JoomPush package


  1. From the backend of your Joomla site (administration) select Extensions → Install/Uninstall.
  2. Click the Browse button and select the extension package on your local machine.
  3. Click the Upload File & Install button.
  4. Some extensions may provide further instructions on installation.
  5. Note that modules and plugins must be enabled before they will work.

There are some situations in which this procedure will not work. Sometimes you need to unzip the file locally prior to installing. If you get an error saying that the file is not in the correct format, the need to unzip is a common cause of this. After unzipping try installing the individual items. Note that the files you upload using the installer still need to be zipped.

Component Configure

First save the component config

  • Go to administrator->Component->Joompush
  • In Component option save 'Allow Guest' option
  • Yes=> guest user will able to subscribe for notification. No => Only registered user will able to subscribe

Welcome Notification on Subscribe

Set 'Yes' to 'Welcome Notification on Subscribe' option to push welcome notification to new subscriber. Admin user can manage welcome notification text, message and icon from the the config. See below image for more details.

JoomPush Configuration

GDPR Configure

Steps for GDPR setup

  • Go to administrator->Component ->Joompush Option
  • In Component option save GDPR settings As Follows:

Right to Informed Message

If user clicks on ‘Yes’ button 'Right to Informed' notification is displayed on the screen. Admin user can manage Right to Informed notification text, message from the the config.

Legal Consent Bottom of Page

If user clicks on ‘Yes’ button 'Legal Consent’ display on Bottom of Screen. Admin user can manage Right to Informed notification text, message from the the config.

Allow Unsubscribe to user

If user clicks on ‘Yes’ button 'Allow Unsubscribe’ the User Unsubscribe facility will be display on screen. Admin user can manage Unsubscribe Modal Popup Message text using 'Unsbuscribe Modal Popup Message' and also admin can set custom 'After Unsbuscribe Message' from the the config

JoomPush GDPR Configuration

JoomPush GDPR Configuration

JoomPush GDPR Configuration

Get Google Firebase API and Secret Key

Joompush works with google firebase cloud messaging, so you need to create google firebase project to get API keys and other data.

Please refer following video to create firebase project.

To save firebase config details, go to administrator->Component->Joompush. You just need to configure google firebase parameters. Parameters details as below:

Server Key:
        Firebase project cloud messaging ‘Legacy Server key’
API Key:
        Firebase project Web API Key
Sender ID:
        Firebase project cloud messaging sender id
Project ID:
        Firebase project id
Default Push Notification Icon:
        Default icon for push notification. Just need to add path
Default Push Notification Url:
      Default push notification click action url.

JoomPush Configuration

Administrator Guide


Admin can stay updated with all the subscribers and Push notification related activities at glance.

JoomPush Dashboard


Note: These are the ones who accept by clicking “Allow” button of the pop-up that appears on your site when the user visits it for the first time.

Subscribers will be added in the list view at the backend. You can view all the subscribers in the “Subscriber” menu at the backend

Subscriber Groups

Push Notifications can be sent in Groups. You will have to select specific subscribers and add then in the new group which you will be creating.

JoomPush Groups

Create new Templates

Create a Push Notification message by Adding an Icon that will be shown in the notification. You will also be able to add Title and Message Body (Max Length 235 characters). Admin has the ability to customize the icon and also the redirection path of the notification by adding a URL in it.

JoomPush Notification Template

Notification Template

Once you you create a message template that will be saved in by default. These ready templates will be available every time you click “Push”. Here you will also have an option to create a new message template.

Select Notification Template

Notifications Overview

Manage all the Google Firebase related configuration from here.

Joompush Notification Overview


Admin user can overview and manage all sent notification status.

Joompush System Plugin

Go to extensions menu in the backend then click on plugin. Search for “JoomPush”. This is the JoomPush system plugin, which is enabled by default. We would still suggest you to double check if it is enabled or not.

JoomPush Allow Notification

JoomPush J2Store Integration

JoomPush j2store integration plugin is used to get push notifications of j2store order related activity to admin users.

To integrate j2store with JoomPush you need to install Joompush j2store plugin and also need JoomPush 1.2. Using joompush j2store plugin you can configure the notification messages.

JoomPush j2store Integration plugin

JoomPush j2store Integration plugin view

Using plugin params admin user can set the notification icon and also enable disable the new and confirmation order push notification to himself.

Admin can set their own language notification message and title. In this message {order_id} will replace with order id, {order_amount} will replace by order amount with currency code and {user_name} will be replace by username.

JoomPush JomSocial Integration

JoomPush Web Push Notification plugin for JomSocial! is used to Sends Web Push Notifications to all the Subscribed registered users. Users will receive Web Push Notifications wherever they receive JomSocial notifcations..

To integrate JomSocial with JoomPush you need to install Joompush JomSocial plugin and also need JoomPush 1.2. Using joompush jomsocial plugin you can configure the notification messages.

JoomPush jomsocial Integration plugin

JoomPush JomSocial Integration plugin related config

You just needs to enable plugin to integrate JoomPush with JomSocial Notification

Since you want to use JoomPush with Jomsocial then need to do some config chnage in JoomPush component as below

  • Site Section should be set to Frontend (Site)
  • Allow Guest User Access should be set to 'No'. Because only registered users will get the web push notification.