Joomla Plugin

The Conferbot Joomla plugin embeds the AI chat widget on every frontend page of a Joomla 4/5 site and passes the logged-in user identity plus site context to the bot. Requires Joomla 4.2+ or 5.x and PHP 7.4+.

See it in action

Paste the Chatbot ID, enable the plugin, and the bot is live on the site - 30 seconds end to end:

How it works

The plugin subscribes to onBeforeCompileHead and injects the standard Conferbot loader into the document head of every frontend (site client) HTML page:

What the plugin injects
<script src="https://cdn.conferbot.com/dist/v1/widget.min.js" async id="conferbot-js"></script>
<script>
  window.ConferbotWidget("<CHATBOT_ID>", "live_chat", {
    user:       { id: "joomla-<user_id>", name, email },   // logged-in user, if any
    customData: { platform: "joomla", siteName, siteUrl, siteLanguage }
  });
</script>

Widget appearance and behavior - position, colors, theme, language, auto-open, proactive prompts, disabled URLs - is configured in the Conferbot dashboard under Customize and delivered at runtime; the plugin does not duplicate those settings.

Requirements

Joomla 4.2+ or 5.x
PHP 7.4+
A Conferbot account with a published chatbot, or the built-in demo bot to try it first

Installation

Get the plugin zip (plg_system_conferbot.zip) from the latest GitHub release, or zip the plugin folder contents yourself (the manifest conferbot.xml must be at the top level of the zip).
In the Joomla administrator, go to System > Install > Extensions and upload the zip.
Go to System > Manage > Plugins, search for "Conferbot", and open System - Conferbot.
Paste your Chatbot ID, set the Status to Enabled, and click Save.

Configuration

Enable/disable is Joomla's own plugin publish state; everything else lives in the plugin options. You can paste the bare ID, the full embed snippet, or a dashboard URL into the Chatbot ID field - the plugin extracts the ID when you save.

Chatbot ID (required) - in the Conferbot dashboard open your bot, click Share, then Copy Bot ID (24-character hex).
How the chat appears - floating chat bubble (default) or popup window.
Widget script URL (advanced) - leave as is for the Conferbot CDN; useful for staging/self-hosted widget builds.

💡

No account yet?

Paste 691c970890527a0468f9b2c9 to try the demo bot - it works right away, no signup needed.

What the plugin passes to the widget

user - the logged-in Joomla user as joomla-<user_id> with name and email (omitted for guests).
customData - platform: "joomla", site name, site URL, and site language.

The widget is injected on the site client only - administrator pages are never touched.

Troubleshooting

If the widget does not appear:

Check the plugin is enabled (System > Plugins).
Check the Chatbot ID is correct and the bot is published and not disabled.
Clear the Joomla cache (System > Clear Cache).

No API key or workspace ID is required - the widget resolves everything server-side from the Chatbot ID over Socket.IO (wdt.conferbot.com).

Source

Open source (GPL-2.0-or-later) on GitHub: Conferbot/conferbot-joomla. 19 PHPUnit tests (58 assertions) cover bot ID extraction, strict validation, embed type normalization, option building, and script-injection safety - the helper never touches Joomla APIs, so the contract is tested without a Joomla installation.