Joomla Integration Guide

Complete guide to integrate CallMeBack with Joomla

Setup time: 10 minutes

Difficulty: Intermediate

Compatible versions: Joomla 3.x, 4.x

Integrate CallMeBack with your Joomla website to capture leads from contact forms and custom modules. Joomla powers over 2 million websites worldwide with its flexible CMS architecture.

Prerequisites

A CallMeBack account - Sign up here
Your CallMeBack integration code from your dashboard
Joomla admin access (Super User level)
Joomla 3.x or 4.x installation
Basic understanding of Joomla modules and templates

Integration Methods

Template Integration

10 minutes Intermediate

Add CallMeBack to your Joomla template for site-wide integration. This is the most reliable method for Joomla sites.

Access Template Manager

Navigate to Joomla's template management system.

Log into your Joomla admin panel
Go to Extensions → Templates → Templates
Click on your active template name
Find the index.php file

Important Note

Always backup your template before making modifications. Consider creating a template override if using a third-party template.

Edit Template File

Add CallMeBack integration code to your template's index.php file.

Click index.php to edit it
Locate the <jdoc:include type="head" /> tag
Add CallMeBack code just after this tag
Click Save

<?php defined('_JEXEC') or die; ?>
<!DOCTYPE html>
<html lang="<?php echo $this->language; ?>">
<head>
    <jdoc:include type="head" />
    
    <!-- CallMeBack Integration for Joomla -->
    <script>
    (function() {
        var script = document.createElement('script');
        script.src = 'https://widget.callmebackbutton.com/widget.js';
        script.setAttribute('data-account', 'YOUR_ACCOUNT_ID');
        script.setAttribute('data-joomla', 'true');
        document.head.appendChild(script);
    })();
    </script>
</head>

Important Note

The data-joomla attribute helps optimize the widget for Joomla-specific features and compatibility.

Test Integration

Verify that CallMeBack is working correctly on your Joomla site.

Clear Joomla cache via System → Clear Cache
Visit your website frontend
Look for the CallMeBack widget
Test the callback form functionality
Check your CallMeBack dashboard for submissions

Important Note

Joomla caching can prevent changes from appearing immediately. Always clear cache after template modifications.

Custom HTML Module

8 minutes Easy

Create a custom HTML module to load CallMeBack. Useful for specific page or position targeting.

Create New Module

Create a custom HTML module in Joomla.

Go to Extensions → Modules
Click New
Select Custom HTML
Enter module title: 'CallMeBack Integration'

Configure Module Content

Add CallMeBack integration code to the module.

In the module editor, switch to Code View
Paste your CallMeBack integration code
Set Show Title to Hide
Choose module position (e.g., 'debug' for invisible loading)

<script>
(function() {
  // Only load if not already loaded
  if (!window.callmebackJoomlaLoaded) {
    var script = document.createElement('script');
    script.src = 'https://widget.callmebackbutton.com/widget.js';
    script.setAttribute('data-account', 'YOUR_ACCOUNT_ID');
    script.setAttribute('data-joomla', 'true');
    script.setAttribute('data-module', 'true');
    document.head.appendChild(script);
    window.callmebackJoomlaLoaded = true;
  }
})();
</script>

Important Note

Using a hidden position ensures the module loads without affecting your site layout.

Assign Module to Pages

Configure which pages should display the module.

Go to Menu Assignment tab
Select On all pages for site-wide integration
Or choose specific pages if preferred
Set Status to Published
Click Save & Close

System Plugin

15 minutes Advanced

Create a custom system plugin for CallMeBack integration. Best for developers who want full control.

Create Plugin Structure

Set up the basic plugin file structure.

Create folder: /plugins/system/callmeback/
Create main plugin file: callmeback.php
Create XML manifest: callmeback.xml

<?php
// plugins/system/callmeback/callmeback.php
defined('_JEXEC') or die;

use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\CMS\Factory;

class PlgSystemCallmeback extends CMSPlugin
{
    public function onBeforeCompileHead()
    {
        $doc = Factory::getDocument();
        
        $script = "
        (function() {
            var script = document.createElement('script');
            script.src = 'https://widget.callmebackbutton.com/widget.js';
            script.setAttribute('data-account', 'YOUR_ACCOUNT_ID');
            script.setAttribute('data-joomla', 'true');
            script.setAttribute('data-plugin', 'true');
            document.head.appendChild(script);
        })();
        ";
        
        $doc->addScriptDeclaration($script);
    }
}

Important Note

This plugin will automatically load CallMeBack on every page without template modifications.

Create Plugin Manifest

Create the XML manifest file for the plugin.

<?xml version="1.0" encoding="utf-8"?>
<extension version="3.1" type="plugin" group="system" method="upgrade">
    <name>System - CallMeBack Integration</name>
    <author>Your Name</author>
    <creationDate>2024</creationDate>
    <copyright>Copyright (C) 2024</copyright>
    <license>GNU General Public License version 2</license>
    <version>1.0.0</version>
    <description>Integrates CallMeBack widget with Joomla</description>
    
    <files>
        <filename plugin="callmeback">callmeback.php</filename>
    </files>
    
    <config>
        <fields name="params">
            <fieldset name="basic">
                <field name="account_id" type="text" label="CallMeBack Account ID" description="Your CallMeBack account ID" />
            </fieldset>
        </fields>
    </config>
</extension>

Important Note

The manifest allows you to configure the account ID through Joomla's plugin manager.

Install and Enable Plugin

Install and activate the custom plugin.

Zip the plugin folder
Go to Extensions → Manage → Install
Upload the plugin zip file
Go to Extensions → Plugins
Find 'System - CallMeBack Integration' and enable it

Troubleshooting

Still having issues?

Can't find the answer you're looking for? Our support team is here to help with your integration.

Contact Support

Related Integrations

References & Official Documentation

Next Steps

Configure CallMeBack

Set up your business hours and timezone
Configure callback phone numbers
Set up email notifications
Add team members to your account

Advanced Features

Set up custom form templates
Configure lead scoring rules
Integrate with your CRM
Set up automated workflows

Need Help?

Our support team is here to help you with your integration.

Contact Support

Prerequisites

A CallMeBack account - Sign up here
Your CallMeBack integration code from your dashboard
Joomla admin access (Super User level)
Joomla 3.x or 4.x installation
Basic understanding of Joomla modules and templates

Integration Methods

Template Integration

10 minutes Intermediate

Add CallMeBack to your Joomla template for site-wide integration. This is the most reliable method for Joomla sites.

Access Template Manager

Navigate to Joomla's template management system.

Log into your Joomla admin panel
Go to Extensions → Templates → Templates
Click on your active template name
Find the index.php file

Important Note

Always backup your template before making modifications. Consider creating a template override if using a third-party template.

Edit Template File

Add CallMeBack integration code to your template's index.php file.

Click index.php to edit it
Locate the <jdoc:include type="head" /> tag
Add CallMeBack code just after this tag
Click Save

<?php defined('_JEXEC') or die; ?>
<!DOCTYPE html>
<html lang="<?php echo $this->language; ?>">
<head>
    <jdoc:include type="head" />
    
    <!-- CallMeBack Integration for Joomla -->
    <script>
    (function() {
        var script = document.createElement('script');
        script.src = 'https://widget.callmebackbutton.com/widget.js';
        script.setAttribute('data-account', 'YOUR_ACCOUNT_ID');
        script.setAttribute('data-joomla', 'true');
        document.head.appendChild(script);
    })();
    </script>
</head>

Important Note

The data-joomla attribute helps optimize the widget for Joomla-specific features and compatibility.

Test Integration

Verify that CallMeBack is working correctly on your Joomla site.

Clear Joomla cache via System → Clear Cache
Visit your website frontend
Look for the CallMeBack widget
Test the callback form functionality
Check your CallMeBack dashboard for submissions

Important Note

Joomla caching can prevent changes from appearing immediately. Always clear cache after template modifications.

Custom HTML Module

8 minutes Easy

Create a custom HTML module to load CallMeBack. Useful for specific page or position targeting.

Create New Module

Create a custom HTML module in Joomla.

Go to Extensions → Modules
Click New
Select Custom HTML
Enter module title: 'CallMeBack Integration'

Configure Module Content

Add CallMeBack integration code to the module.

In the module editor, switch to Code View
Paste your CallMeBack integration code
Set Show Title to Hide
Choose module position (e.g., 'debug' for invisible loading)

<script>
(function() {
  // Only load if not already loaded
  if (!window.callmebackJoomlaLoaded) {
    var script = document.createElement('script');
    script.src = 'https://widget.callmebackbutton.com/widget.js';
    script.setAttribute('data-account', 'YOUR_ACCOUNT_ID');
    script.setAttribute('data-joomla', 'true');
    script.setAttribute('data-module', 'true');
    document.head.appendChild(script);
    window.callmebackJoomlaLoaded = true;
  }
})();
</script>

Important Note

Using a hidden position ensures the module loads without affecting your site layout.

Assign Module to Pages

Configure which pages should display the module.

Go to Menu Assignment tab
Select On all pages for site-wide integration
Or choose specific pages if preferred
Set Status to Published
Click Save & Close

System Plugin

15 minutes Advanced

Create a custom system plugin for CallMeBack integration. Best for developers who want full control.

Create Plugin Structure

Set up the basic plugin file structure.

Create folder: /plugins/system/callmeback/
Create main plugin file: callmeback.php
Create XML manifest: callmeback.xml

<?php
// plugins/system/callmeback/callmeback.php
defined('_JEXEC') or die;

use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\CMS\Factory;

class PlgSystemCallmeback extends CMSPlugin
{
    public function onBeforeCompileHead()
    {
        $doc = Factory::getDocument();
        
        $script = "
        (function() {
            var script = document.createElement('script');
            script.src = 'https://widget.callmebackbutton.com/widget.js';
            script.setAttribute('data-account', 'YOUR_ACCOUNT_ID');
            script.setAttribute('data-joomla', 'true');
            script.setAttribute('data-plugin', 'true');
            document.head.appendChild(script);
        })();
        ";
        
        $doc->addScriptDeclaration($script);
    }
}

Important Note

This plugin will automatically load CallMeBack on every page without template modifications.

Create Plugin Manifest

Create the XML manifest file for the plugin.

<?xml version="1.0" encoding="utf-8"?>
<extension version="3.1" type="plugin" group="system" method="upgrade">
    <name>System - CallMeBack Integration</name>
    <author>Your Name</author>
    <creationDate>2024</creationDate>
    <copyright>Copyright (C) 2024</copyright>
    <license>GNU General Public License version 2</license>
    <version>1.0.0</version>
    <description>Integrates CallMeBack widget with Joomla</description>
    
    <files>
        <filename plugin="callmeback">callmeback.php</filename>
    </files>
    
    <config>
        <fields name="params">
            <fieldset name="basic">
                <field name="account_id" type="text" label="CallMeBack Account ID" description="Your CallMeBack account ID" />
            </fieldset>
        </fields>
    </config>
</extension>

Important Note

The manifest allows you to configure the account ID through Joomla's plugin manager.

Install and Enable Plugin

Install and activate the custom plugin.

Zip the plugin folder
Go to Extensions → Manage → Install
Upload the plugin zip file
Go to Extensions → Plugins
Find 'System - CallMeBack Integration' and enable it

Troubleshooting

Still having issues?

Can't find the answer you're looking for? Our support team is here to help with your integration.

Contact Support

References & Official Documentation

Next Steps

Configure CallMeBack

Set up your business hours and timezone
Configure callback phone numbers
Set up email notifications
Add team members to your account

Advanced Features

Set up custom form templates
Configure lead scoring rules
Integrate with your CRM
Set up automated workflows

Joomla Integration Guide

Prerequisites

Integration Methods

Template Integration

Access Template Manager

Important Note

Edit Template File

Important Note

Test Integration

Important Note

Custom HTML Module

Create New Module

Configure Module Content

Important Note

Assign Module to Pages

System Plugin

Create Plugin Structure

Important Note

Create Plugin Manifest

Important Note

Install and Enable Plugin

Troubleshooting

Still having issues?

Related Integrations

References & Official Documentation

Next Steps

Configure CallMeBack

Advanced Features

Need Help?

Joomla Integration Guide

Prerequisites

Integration Methods

Template Integration

Access Template Manager

Important Note

Edit Template File

Important Note

Test Integration

Important Note

Custom HTML Module

Create New Module

Configure Module Content

Important Note

Assign Module to Pages

System Plugin

Create Plugin Structure

Important Note

Create Plugin Manifest

Important Note

Install and Enable Plugin

Troubleshooting

Still having issues?

Related Integrations

References & Official Documentation

Next Steps

Configure CallMeBack

Advanced Features

Need Help?

Setup a Demo

Thank you for scheduling a demo!

Request a Call Back

Thank you for your request!

Join Our Waitlist

Welcome to the waitlist!