Skip to main content

Overview

Add your Invent AI assistant to any Joomla website with a floating bubble. Perfect for community sites, corporate websites, and portals.

Installation

Method 1: Custom HTML Module (Easiest)

1

Create New Module

Go to ExtensionsModulesNew
2

Select Custom HTML

Choose Custom HTML as the module type
3

Configure Module

  • Title: Invent Assistant
  • Show Title: No
  • Position: Choose a position (usually footer or debug)
  • Status: Published
4

Add the Code

In the Custom Output field, switch to editor and paste:
Replace YOUR_ASSISTANT_ID with your actual assistant ID.
5

Set to All Pages

In the Menu Assignment tab, select On all pages or choose specific menu items
6

Save

Click Save & Close

Method 2: Template Override

Add directly to your template:

Method 3: Using a Plugin

Create a system plugin:

Customization

Match Your Joomla Template

Show Only on Specific Components

In your Custom HTML module settings:
  1. Go to Menu Assignment tab
  2. Select Only on the pages selected
  3. Choose specific menu items (e.g., only on Articles, or only on com_content)

Component-Specific Display

User Authentication

Security Requirement: When using any user-* attributes (user-id, user-name), you must also provide user-hash. Both user-id and user-hash must be provided together, or neither should be provided. The user-hash must be generated on your backend using HMAC-SHA256 with your assistant’s secret key. Never expose the secret key to the client.
Pass Joomla user information to provide personalized experiences:

Tips for Joomla

Joomla 3 & 4

Compatible with both Joomla 3.x and 4.x

Multilingual

Works with Joomla multilingual sites

VirtueMart

Perfect for e-commerce support

Community Sites

Help forum and community members

Extension Compatibility

Works seamlessly with:
  • K2 - Advanced content management
  • VirtueMart - E-commerce
  • HikaShop - Online store
  • JomSocial - Social networking
  • Community Builder - User profiles
  • JEvents - Event management

Module Positions

Common positions for the assistant:
  • debug - Bottom of page (recommended)
  • footer - Footer area
  • user3 - Various template positions
  • Custom position in your template

Troubleshooting

Solutions:
  • Verify module is Published
  • Check module position exists in template
  • Ensure “Show Title” is set to No
  • Clear Joomla cache (System → Clear Cache)
  • Check Menu Assignment settings
Solutions:
  • Verify position exists in your template
  • Try using “debug” position (always available)
  • Check template’s templateDetails.xml for valid positions
Solutions:
  • Check for JavaScript conflicts in browser console
  • Adjust module ordering
  • Try different module position
  • Update to latest template version

Joomla Version Compatibility

  • Joomla 3.x: Fully supported
  • Joomla 4.x: Fully supported
  • Joomla 5.x: Fully compatible (when released)
Tested with:
  • Helix Ultimate
  • JA Templates
  • Gantry 5
  • T3 Framework
  • Warp Framework
  • RocketTheme
  • And most other Joomla templates

Cache Considerations

If using Joomla cache:
  1. Go to SystemGlobal ConfigurationSystem tab
  2. Clear cache after adding the assistant
  3. Consider excluding the module from cache if needed