Plugin name: JEM - Quick Icon Plugin
Extension: plg_quickicon_jem
Plugin group: Quick Icon
Applies to: JEM 5.0 beta 3 for Joomla 6. This plugin is specifically guarded for Joomla 6 installation by its installer script.
Overview
The JEM Quick Icon Plugin adds a JEM shortcut icon to the Joomla administrator dashboard. It gives administrators a fast entry point to the JEM backend and, when supported by the dashboard quick icon module, a direct add-event action.
This plugin does not affect frontend output, event display, registrations, maps, modules, or event data. It is an administrator convenience plugin.
Requirements
- Joomla 6 for this package version.
- JEM component installed.
- The plugin enabled in System → Manage → Plugins.
- The administrator user must have
core.manage permission for com_jem.
- The Joomla administrator dashboard must display the Quick Icons module/context.
Plugin Options
This plugin has no configurable options in the plugin manager.
What It Adds
| Dashboard Item | Value | Purpose |
|---|
| Name |
JEM Events |
Label shown for the quick icon. |
| Main link |
index.php?option=com_jem |
Opens the JEM backend component. |
| Add link |
index.php?option=com_jem&task=event.add |
Provides a direct add-event action where Joomla quick icons support secondary actions. |
| Icon |
icon-calendar |
Uses Joomla's calendar icon style. |
| Plugin ID |
plg_quickicon_jem |
Unique ID for the quick icon entry. |
Visibility Rules
The quick icon is only returned when both conditions are true:
- The quick icon context is
mod_quickicon.
- The current administrator user is authorised to manage
com_jem.
If the administrator does not have permission to manage JEM, the plugin returns no icon.
Installation Behaviour
The installer script contains a Joomla version guard:
Version::MAJOR_VERSION === 6
After install or discover install, the plugin enables itself automatically in the Joomla extensions table.
Important: Because this plugin is Joomla 6 specific in this package, it should not be expected to install or run on Joomla 4 or Joomla 5 in the same way.
Technical Structure
| File | Purpose |
|---|
jem.php |
Compatibility entry file so Joomla recognises the plugin. |
services/provider.php |
Registers the Joomla 6 service provider for the plugin. |
src/Extension/Jem.php |
Contains the actual quick icon plugin class and onGetIcons() logic. |
script.php |
Installer script that restricts installation to Joomla 6 and enables the plugin after install. |
Administrator Workflow
- Install the JEM package on Joomla 6.
- Confirm that JEM - Quick Icon Plugin is enabled.
- Open the Joomla administrator dashboard.
- Confirm that the JEM Events quick icon is visible.
- Click the icon to open the JEM backend.
Troubleshooting
| Problem | Possible Cause | Suggested Fix |
|---|
| The JEM quick icon is not visible. |
The plugin is disabled, the Quick Icons module is not shown, or the user lacks JEM manage permission. |
Enable the plugin, check the administrator dashboard quick icon module, and verify user permissions for com_jem. |
| The plugin cannot be installed on Joomla 4 or Joomla 5. |
The installer script is restricted to Joomla 6. |
Use the package/plugin variant intended for the Joomla version in use. |
| A class not found error appears. |
Plugin namespace, service provider, or file installation is incomplete. |
Reinstall the package and verify that services/provider.php and src/Extension/Jem.php exist. |
| The icon opens JEM but the add action is not visible. |
The dashboard quick icon module or template may not render secondary quick icon actions. |
Use the main JEM link and create new events from the JEM backend toolbar. |
Related Development Notes
The following GitHub references are useful for understanding historical quick icon issues, namespace problems, and installation behaviour.
