Plugin name: JEM - List Events Plugin
Extension: plg_content_jemlistevents
Plugin group: Content
Applies to: JEM 5.0 beta 3 for Joomla 5/6 and JEM 4.5 beta 5 for Joomla 4/5, when the plugin is available in the installed package.
Overview
The JEM List Events Content Plugin allows administrators and editors to insert a table of JEM events inside Joomla articles, custom modules, or other content areas that process Joomla content plugins.
The plugin is activated with the {jemlistevents} tag. It can use the global plugin settings, or each tag can override those settings with inline parameters. This makes it suitable for documentation pages, landing pages, category pages, venue pages, newsletters rendered as articles, and editorial content that needs an embedded event list.
Requirements
- The plugin must be enabled in System → Manage → Plugins.
- The content area must run Joomla content plugins.
- JEM must be installed and events must exist.
- The current visitor must have access to the events, categories, and venues returned by JEM.
Basic Syntax
{jemlistevents}
This uses the plugin configuration defaults.
Full Syntax
{jemlistevents type=upcoming; featured=on; title=link; date=on; time=off; enddatetime=on; eventids=3,10; catids=2,14; category=link; venueids=4; venue=link; max=5; cuttitle=30; noeventsmsg='No events found'}
Important: Inline options are separated with semicolons. Boolean display options use on, off, or link depending on the option.
Plugin Options
Event Selection
| Option | Tag Parameter | Default | Description |
|---|
| Type of events |
type |
unfinished |
Selects which events are listed: today, unfinished, upcoming, ongoing, archived, newest, open-date, or all events except trashed. |
| Show Featured Events |
featured |
on |
Controls featured events: on shows all, off hides featured events, and only shows only featured events. |
| Categories |
catids |
Empty |
Comma-separated category IDs. Empty means all accessible categories. |
| Venues |
venueids |
Empty |
Comma-separated venue IDs. Empty means all accessible venues. |
| Event IDs |
eventids |
Empty |
Comma-separated event IDs. Useful for curated article blocks. |
| Maximum events |
max |
10 |
Maximum number of events listed. |
Event Type Values
| Value | Meaning |
|---|
today |
Events happening today. |
unfinished |
Events that have not ended yet. This includes upcoming and currently running events. |
upcoming |
Future events that have not started yet. |
ongoing |
Events taking place now. |
archived |
Archived events. |
newest |
Recently created events, ordered by highest event ID. |
open |
Open-date events without a normal date/time. |
all |
Published and archived events, except trashed events. |
Displayed Columns
| Option | Tag Parameter | Default | Values |
|---|
| Show title |
title |
link |
on, link, off |
| Max. title length |
cuttitle |
40 |
Number of characters before truncation. |
| Show date |
date |
on |
on, link, off |
| Date format |
Global option only |
d.m.Y |
PHP date format. |
| Show time |
time |
off |
on, off |
| Time format |
Global option only |
Empty |
PHP time format. Empty uses JEM formatting. |
| Show end date/end time |
enddatetime |
on |
on, off |
| Show category |
category |
link |
on, link, off |
| Show venue |
venue |
link |
on, link, off |
| No events message |
noeventsmsg |
Empty |
Text displayed when no matching events are found. |
Frontend Output
- The plugin replaces each
{jemlistevents} tag with an HTML table.
- The table uses Bootstrap-compatible classes:
table, table-hover, and table-striped.
- Each plugin instance receives a unique wrapper ID such as
jemlistevents-0.
- Featured events receive an additional CSS class:
jemlistevent-featured.
- Titles, dates, categories, and venues can be plain text, links, or hidden.
- The plugin does not run while Joomla Smart Search is indexing content.
CSS Override
The plugin loads its default stylesheet from:
media/plg_content_jemlistevents/css/jemlistevents.css
If the active Joomla template contains the following file, it is used instead:
templates/YOUR_TEMPLATE/css/jemlistevents.css
Examples
Upcoming Events From Two Categories
{jemlistevents type=upcoming; catids=2,14; max=5; noeventsmsg='No upcoming events found'}
Only Featured Events
{jemlistevents featured=only; max=3; title=link; date=on; venue=link}
Simple Venue-Specific List
{jemlistevents venueids=4; type=unfinished; max=10; category=off; venue=off}
Curated Event List By IDs
{jemlistevents eventids=12,18,24; title=link; date=on; time=on; max=3}
Archive List Without Links
{jemlistevents type=archived; title=on; date=on; category=on; venue=on; max=20}
Troubleshooting
| Problem | Possible Cause | Suggested Fix |
|---|
| The tag is shown as plain text. |
The plugin is disabled or the content area does not run content plugins. |
Enable the plugin and test inside a standard Joomla article. |
| No events are listed. |
No matching event type, filters are too restrictive, or access rules hide the events. |
Test with {jemlistevents type=all; max=20}, then add filters one by one. |
| Featured filtering does not behave as expected. |
The featured parameter is set to off or only. |
Use featured=on to include both featured and non-featured events. |
| Dates or times are not shown as expected. |
Date/time display options or formats are configured differently globally or inline. |
Check date, time, enddatetime, date format, and time format. |
| The table needs custom styling. |
The default plugin CSS is being used. |
Create templates/YOUR_TEMPLATE/css/jemlistevents.css to override the plugin stylesheet. |
Related Development Notes
The following GitHub references are useful for understanding recent behaviour around event listing, ACL, content plugins, and plugin packaging. Direct issue coverage for this plugin is limited, so related high-value issues are included where they affect the same behaviour.
