Installation

This guide explains how to install JEM 5.0.0 on a Joomla site. JEM is installed as a Joomla package, which includes the main component together with the official JEM modules and plugins.

Before installing, check the System requirements and make sure your Joomla and PHP versions are supported by the JEM package you are going to install.
Important: make a full backup of your Joomla files and database before installing JEM on an existing site. For production sites, test the installation on a staging copy first.

Version Compatibility

Use the JEM package that matches your Joomla version. JEM 5.0.0 is the JEM line for Joomla 6. Do not install a package built for another Joomla major version.

  • JEM 4.5.x: for Joomla 5.
  • JEM 5.0.0: for Joomla 6.
If you are moving an existing Joomla 5 / JEM 4 site to Joomla 6 / JEM 5, follow the Upgrading and Updating documentation instead of treating it as a fresh installation.

Download the Package

Download the full JEM package ZIP from the official JEM download area. The package file normally has a name similar to pkg_jem_v5.0.0.zip.

Install the full package ZIP. Do not unzip it and install the component, modules, or plugins one by one unless the release instructions explicitly say so.

Install JEM

  1. Log in to the Joomla administrator area.
  2. Go to System → Install → Extensions.
  3. Open the Upload Package File tab.
  4. Select the JEM package ZIP file.
  5. Upload and install the package.
  6. Wait for Joomla to show the installation success message.

After installation, JEM is available from Components → JEM in the Joomla administrator menu.

What the JEM 5.0.0 Package Installs

The JEM 5.0.0 package installs the main JEM component and the official modules and plugins listed below. Some plugins may be installed disabled and can be enabled when needed.

Component

  • JEM Component: event, venue, category, type, registration, attachment, and configuration management.

Modules

  • JEM Basic Module
  • JEM Wide Module
  • JEM Calendar Module
  • JEM Venues Map Module
  • JEM Teaser Module
  • JEM Banner Module
  • JEM Jubilee Module
  • JEM Types Module

Plugins

  • JEM List Events Content Plugin
  • JEM Embed Content Plugin
  • JEM Smart Search Plugin
  • JEM Comments Plugin
  • JEM Mailer Plugin
  • JEM Quick Icon Plugin

After Installation

Open the JEM dashboard and review the basic configuration before creating events. At minimum, check the settings for date and time display, event lists, event detail pages, venue pages, images, attachments, registration, and frontend permissions.

  1. Go to Components → JEM.
  2. Open Settings and review the configuration tabs.
  3. Create or check the categories that will be used for events.
  4. Create or check venues if your events use venue data.
  5. Create the Joomla menu items that should display JEM views on the frontend.
  6. Enable and configure any JEM modules you want to publish.
  7. Enable only the JEM plugins that are needed for your site.

Create Frontend Menu Items

JEM pages are shown on the frontend through Joomla menu items. Create menu items for the views your site needs, such as event lists, calendars, category views, venue views, maps, search, user area, submit event, or submit venue.

Frontend submit and edit pages also depend on Joomla permissions, JEM settings, categories, and user groups. Users will only see the actions they are allowed to use.

Enable Optional Plugins and Modules

The package installs several JEM modules and plugins, but you only need to publish the ones used by your site.

  • Use System → Manage → Extensions to check installed JEM extensions.
  • Use Content or System plugin management to enable JEM plugins when required.
  • Use Content → Site Modules to configure and publish JEM modules.
  • Check module positions and menu assignment so modules appear only where intended.

Check the Installation

  • Open the JEM dashboard in the Joomla administrator.
  • Open JEM Settings and confirm that the configuration loads correctly.
  • Create a test category, venue, and event.
  • Open the frontend menu item that displays JEM events.
  • Check event detail pages, venue pages, and calendar views if used.
  • Test registration if your site allows users to book events.
  • Test frontend event or venue submission if frontend users can create content.

Troubleshooting

The package does not install

  • Confirm that the package matches your Joomla major version.
  • Confirm that your PHP version meets the system requirements.
  • Confirm that you selected the full JEM package ZIP.
  • Check the Joomla installer error message for the exact cause.

JEM appears in the administrator but not on the frontend

  • Create a Joomla menu item for a JEM frontend view.
  • Check that at least one event is published and assigned to a published category.
  • Check access levels, language filters, publish up/down dates, and event status.
  • Clear Joomla cache if the site uses caching.

A module or plugin is missing

  • Check System → Manage → Extensions.
  • Filter by JEM or by the extension type.
  • Enable the extension if it is installed but disabled.
  • Reinstall the full JEM package if the installation was incomplete.

Related Documentation