Module name: JEM - Wide Module
Extension: mod_jem_wide
Applies to: JEM 5.0 beta 3 for Joomla 5/6 and JEM 4.5 beta 5 for Joomla 4/5, when the module functionality is available in the installed package.
Overview
The JEM Wide Module displays events in a wider module format than the compact Basic Module. It is intended for positions where there is enough horizontal space to show several event details together: title, date, time, category, venue, city, county, images, and links.
It is useful for event landing pages, homepage event strips, wide content positions, and responsive layouts where events should look closer to a compact event list than a small sidebar module.
Requirements
- JEM component installed and enabled.
- Published events matching the selected date mode and filters.
- Venue and category data if venue/category display or filtering is used.
- Event or venue images if image display is desired in the selected layout.
Where To Find It
- Go to System → Manage → Site Modules.
- Create or edit a module of type JEM - Wide Module.
- Assign it to a template position with enough width for event list content.
- Configure event selection, filters, date display, links, layout, and module assignment.
Basic Options
Event Selection
| Option | Default | Description | Usage Notes |
|---|
| Events Display-Type |
Unfinished |
Controls which events are selected by date/status. |
Available modes are Upcoming, Unfinished, Archived, and Today. |
| Events in Module |
5 |
Maximum number of events displayed. |
Use fewer items for homepage strips and more items for event overview pages. |
| Show “No events” |
Yes |
Shows a message when no matching events are found. |
Disable if the module should disappear silently when empty. |
| Highlight Featured |
No |
Adds a special style to featured events. |
Useful when the module mixes normal and promoted events. |
| Time Offset |
Empty |
Moves the time window forward or backward in hours. |
Use positive values to look ahead and negative values to include recently finished events. |
Filtering
| Option | Default | Description |
|---|
| Categories |
Empty |
Limits output to selected JEM categories. Empty means all accessible categories are allowed. |
| Venues |
Empty |
Limits output to selected JEM venues. Empty means all accessible venues are allowed. |
Title and Links
| Option | Default | Description |
|---|
| Max. Title Length |
25 |
Limits the displayed event title length. |
| Link to Event on Title |
Yes |
Makes the event title link to the event details page when the visitor has access. |
| Link to Category |
Yes |
Makes category names link to the corresponding JEM category view. |
| Link to Venue |
Yes |
Makes venue names link to the corresponding JEM venue view. |
| Show More Information |
Yes (link) |
Shows a More information link or button when the event has an associated Joomla article. |
| Show More Information Title |
No |
Adds the associated article title after the More information label. |
Date and Time Display
| Option | Default | Description |
|---|
| Date Display-Type |
Show date |
Displays either the formatted event date or the difference in days from the current date. |
| Date Format |
Empty |
Uses the JEM/global date format unless a PHP date format is entered. |
| Time Format |
Empty |
Uses the JEM/global time format unless a PHP time format is entered. |
Note: When Date Display-Type is set to day difference, the time is hidden. Use formatted date display if the event time must be visible.
Images and Modal Display
| Option | Default | Description |
|---|
| Modal Window |
No |
Opens event or venue images in a modal/lightbox-style view when supported by the selected layout. |
Advanced Options
| Option | Default | Description |
|---|
| Layout |
default |
Selects the module layout. The module includes default and responsive layouts, plus internal event-list templates used by the responsive output. |
| Module Class |
Empty |
Adds custom classes to the module container. Some JEM responsive behaviours can be controlled through module class suffixes. |
| Caching |
Use Global |
Controls Joomla module caching. |
| Cache Time |
900 |
Cache lifetime in seconds. The default is 15 minutes. |
Available Layouts
| Layout | Purpose |
|---|
default |
Table-style wide event display with title, date/time, category, venue, and venue image columns. |
responsive |
Responsive event-list output that can switch between modern list style and table-like style using module class suffixes. |
Useful Module Class Suffixes
| Suffix | Effect |
|---|
jem-tablestyle |
Uses the table-like responsive layout instead of the modern list-style layout. |
jem-notitle |
Hides the event title in supported layouts. |
jem-novenue |
Hides the venue field in supported layouts. |
jem-nocity |
Hides the city field in supported layouts. |
jem-nostate |
Hides the county/state field in supported layouts. |
jem-nocats |
Hides category output in supported layouts. |
jem-noimageevent |
Hides the event image in supported layouts. |
jem-noimagevenue |
Hides the venue image in supported layouts. |
jem-imagewidth200px |
Sets image width to 200px in supported responsive layouts. Other widths can be used. |
jem-imageheight120px |
Sets image height to 120px in supported responsive layouts. Other heights can be used. |
Frontend Behaviour
- The module selects events according to display type, time offset, category filter, venue filter, and count limit.
- Upcoming and unfinished modes show published events ordered by date ascending.
- Archived mode shows archived events ordered by date descending.
- Today mode shows events active on the selected day, with the time offset rounded to full days.
- Event titles, categories, and venues can be linked when the corresponding options are enabled.
- Associated Joomla articles can be shown through a More information link or button.
- Event and venue images are prepared through JEM image helpers and can use modal/lightbox display when enabled.
- The output includes structured event date/location data where supported by the layout.
Recommended Configurations
Homepage Wide Event Strip
- Events Display-Type: Upcoming or Unfinished
- Events in Module: 3-5
- Link to Event on Title: Yes
- Show More Information: Yes, if associated articles are used
- Layout: responsive
Best for a homepage section that needs more detail than a small event list.
Venue Page Event List
- Venues: Select the target venue
- Link to Venue: Optional
- Module Class:
jem-novenue if the venue is already clear from the page context
- Date Display-Type: Show date
Best for showing upcoming events at a specific venue.
Category Page Event List
- Categories: Select the target category
- Link to Category: Optional
- Module Class:
jem-nocats if only one category is used
- Highlight Featured: Yes, if promoted events should stand out
Best for pages dedicated to one event type.
Compact Table-Like Module
- Layout: responsive
- Module Class:
jem-tablestyle jem-noimageevent jem-noimagevenue
- Events in Module: 5-10
- Date Display-Type: Show date
Best for dense information areas where the module should behave like a compact event table.
Examples
Show tomorrow’s events
- Events Display-Type: Today
- Time Offset:
24
Show events starting one week from now or later
- Events Display-Type: Upcoming
- Time Offset:
168
Show recently finished or still-running events
- Events Display-Type: Unfinished
- Time Offset:
-2
Troubleshooting
| Problem | Possible Cause | Suggested Fix |
|---|
| No events are shown. |
No event matches the selected type, filters, date window, publication state, or access rules. |
Check event dates, publication state, category filter, venue filter, access levels, and the time offset. |
| The module shows old events in Today mode. |
Date filtering, ordering, or an outdated module version may be involved. |
Verify the installed JEM version, test with Time Offset empty, and check whether related date-filter fixes are included in the installed package. |
| The time is not visible. |
Date Display-Type is set to day difference, or time data/format is missing. |
Use Show date mode and check event start/end time fields. |
| Images are not shown. |
The selected layout, module suffix, or missing event/venue images prevent image output. |
Remove jem-noimageevent or jem-noimagevenue, check event/venue images, and test the default layout. |
| The responsive layout is too wide or too dense. |
The selected layout or suffix combination does not match the template position. |
Try jem-tablestyle, hide unneeded fields, or set image dimensions with jem-imagewidth... and jem-imageheight.... |
| The More information link is missing. |
The event has no associated Joomla article or the option is disabled. |
Associate a Joomla article with the event and enable Show More Information. |
Related Development Notes
For this module, the most useful references are the recent JEM 4 changelog entries and issues related to module overrides, date/time handling, lightbox behaviour, responsive suffixes, and module CSS overrides.
