The JEM Banner Module displays JEM events in a visual banner-style layout. It is designed for highlighted event blocks, home page promotions, event teasers and layouts where images, calendar sheets, descriptions and calls to action are important.
Overview
The Banner Module is more visual than the Basic Module. It can display event titles, dates, calendar sheets, event flyers, descriptions, categories, venues, read more links and associated Joomla article links.
It supports multiple event selection modes, including upcoming events, unfinished events, archived events, today's events and open date events. It also supports filters by category, venue, event ID, featured state and venue county/region.
Important: the module respects JEM and Joomla access levels. If a visitor cannot access an event, the event details link may point to the Joomla login page.
Compatibility
| JEM versions |
JEM 5.0.0 beta 3 and JEM 4.5.0 beta 5 |
|---|
| Joomla versions |
Joomla 4, Joomla 5 and Joomla 6, depending on the JEM package used |
|---|
| Module name |
mod_jem_banner |
|---|
| Main purpose |
Visual event banner / event teaser module |
|---|
Requirements
- JEM must be installed and configured.
- Published events are required for upcoming, unfinished, current and open date modes.
- Archived events are shown only when the module display type is set to archived events.
- Event flyers require images assigned to the event.
- Category colours require category colour values when using category-based calendar colours.
- Associated article links require events to have linked Joomla articles.
Where To Find It
| Joomla area |
System / Manage / Site Modules |
|---|
| Module type |
JEM - Banner Module |
|---|
| Frontend output |
Visual event banners, cards or table layouts depending on the selected layout |
|---|
Options Tab
Event Selection
| Option | Default | Description | Example |
|---|
| Events Display-Type |
Upcoming events |
Selects which event date group the module displays. |
Use Upcoming events for normal promotional banners. |
| Events in module |
5 |
Maximum number of events displayed. |
Use 1 for a hero banner, 3 for cards, 5 for a list. |
| Show “No events” |
Yes |
Shows a message when no matching events are found. If disabled, the module outputs nothing. |
Disable for home page sections where empty output should collapse. |
| Max. days |
Empty |
Limits upcoming or unfinished events to a maximum number of days, relative to the time offset. |
Use 30 to show events within the next month. |
| Time offset (in hours) |
Empty |
Moves the event selection window forward or backward. For today's events it is rounded to full days. |
24 with Today's events shows tomorrow's events. |
Event Display-Type Values
| Value | Behavior | Typical Use |
|---|
| Upcoming events |
Shows published events starting after now plus the configured time offset. |
Promote future events. |
| Unfinished events |
Shows events that have not ended yet. |
Show current and upcoming events. |
| Archived events |
Shows archived events, ordered from newest to oldest. |
Past highlights or event archive blocks. |
| Today's events |
Shows events running on the selected day, affected by full-day offset. |
Today / tomorrow event banners. |
| Open date events |
Shows events without a fixed event date. |
Events where date is still to be announced. |
Shuffle And Random Selection
| Option | Default | Description | Example |
|---|
| Shuffle events |
No |
Randomly selects events from the available event pool. |
Enable for rotating promotional banners. |
| Shuffle pool limit |
Empty |
Limits how many events are read before randomly selecting the final visible items. |
Use 20 to randomly choose from the next 20 events. |
Title And Event Link
| Option | Default | Description | Recommendation |
|---|
| Max. Title length |
25 |
Shortens long event titles after the configured number of characters. |
Increase for wide layouts or cards. |
| Link to Event on Title |
Yes |
Makes the event title link to the event details page. |
Enable for most banner layouts. |
Calendar Sheet And Colours
| Option | Default | Description | Example |
|---|
| Show Calendar |
Yes |
Shows a calendar-style date image for each event. |
Enable for visual event cards or banners. |
| Colour |
red fallback behavior |
Selects the calendar sheet colour. Available values include red, blue, green, orange, category-based and user-defined. |
Use category-based colour when categories have meaningful colours. |
| Fallback Colour |
#EEEEEE |
Used when user-defined colour is selected, or when category colour cannot be resolved uniquely. |
Use a neutral brand-compatible colour. |
Category colour behavior: if “from Category” is selected and the event has exactly one usable category colour, that colour is used. If multiple different colours are found, the fallback colour is used.
Flyer And Images
| Option | Default | Description | Example |
|---|
| Show Flyer |
Yes |
Shows the event image when available. |
Enable for promotional layouts. |
| Flyer links to... |
Image on full page |
Controls what happens when the visitor clicks the event image. |
Use modal for image preview, event details for stronger navigation. |
| Image width max (px) |
Empty |
Sets a maximum image width in pixels. |
Use 300 for sidebar banners or leave empty for responsive layouts. |
Flyer Link Values
| Value | Behavior |
|---|
| Image on full page |
The flyer links directly to the original image. |
| Image in modal window |
The flyer opens in a modal/lightbox view. |
| Event's details view |
The flyer links to the JEM event details page. |
| No link |
The flyer is shown without a clickable link. |
Description And Read More
| Option | Default | Description | Recommendation |
|---|
| Show Description |
Yes |
Shows the event intro text in the banner. |
Enable for teaser-style banners, disable for compact lists. |
| Max description length |
300 |
Limits the number of description characters shown. |
Use 120-180 for cards, 300 for larger banners. |
| Allow Line Breaks |
No |
Preserves line breaks in the description. If disabled, line breaks are replaced with spaces. |
Disable for compact layouts. Enable when formatting matters. |
| Show “Read more...” Break |
No |
Shows a Read more link or button when the event description has a read more break. |
Use when event intro text should lead to full event details. |
| Show More Information |
Yes (link) |
Shows a More information link or button when the event has an associated Joomla article. |
Use for events connected to longer editorial content. |
| Show More Information Title |
No |
Shows the associated article title after the More information text. |
Enable when article titles are meaningful for visitors. |
Date And Time Display
| Option | Default | Description | Example |
|---|
| Date Display-Type |
Show date |
Shows either the formatted date or a relative day difference. |
Use day difference for “Today”, “Tomorrow” or “3 days ahead” style banners. |
| Date format |
Empty |
PHP date format used by the module. If empty, JEM/component defaults are used. |
j M Y, D, j F Y, Y-m-d |
| Time format |
Empty |
PHP time format used by the module. If empty, JEM/component defaults are used. |
H:i, g:i a |
Category, Venue And Location Output
| Option | Default | Description | Recommendation |
|---|
| Show Category |
No |
Shows event categories in the banner. |
Enable for category-driven sites. |
| Link to Category |
Yes |
Links category names to category pages when categories are shown. |
Enable if category browsing is part of the site navigation. |
| Show Venue |
No |
Shows the event venue name. |
Enable when location is important. |
| Link to Venue |
Yes |
Links the venue name to the JEM venue page when venue output is enabled. |
Enable for venue detail discovery. |
Advanced Event Filters
| Option | Default | Description | Example |
|---|
| Featured events only |
No |
Limits output to featured events only. |
Use for front page event highlights. |
| Categories |
Empty |
Limits output to selected JEM categories. |
Select “Concerts” for a music banner. |
| Venues |
Empty |
Limits output to selected JEM venues. |
Select a theatre to show only events at that venue. |
| Event ID |
Empty |
Comma-separated event IDs used to limit the output to specific events. |
12,18,25 |
| County |
Empty |
Comma-separated county/region values used to filter event venues. |
Madrid, Barcelona |
| County Match Mode |
Complete Match |
Controls whether the county must match exactly or only contain the entered text. |
Use Contains for broader regional matching. |
Advanced Tab
| Option | Default | Description | Recommendation |
|---|
| Alternative Layout |
default |
Selects the module layout. |
Use cards for modern grid output, responsive for flexible banners, table-advanced for structured data. |
| Module Class Suffix |
Empty |
Adds custom classes to the module wrapper. |
Can be used for layout hints such as horizontal/image sizing if supported by the layout. |
| Caching |
Use Global |
Controls whether Joomla caches the module output. |
Disable while testing filters or image output. |
| Cache Time |
900 |
Time in seconds before the module cache is refreshed. |
Reduce if event banners change frequently. |
Available Layouts
| Layout | Purpose |
|---|
default |
Classic banner layout with title, calendar, flyer, description and metadata. |
responsive |
Responsive banner layout with flexible image and content positioning. |
cards |
Card/grid style layout with image, date box, metadata and action links. |
table-advanced |
Structured table layout for event data. |
Frontend Behavior
- The module retrieves matching events according to display type and filters.
- Upcoming and unfinished events are ordered from nearest to later dates.
- Archived events are ordered from newest to oldest.
- Event titles may link to event details depending on the Link to Event setting and access permissions.
- Event flyers are generated from event images and may link to the image, modal or event page.
- Calendar sheet colour can be fixed, category-based or user-defined.
- Read more links depend on the event description read more break.
- More information links depend on associated Joomla articles.
- Venue and category links respect the corresponding show/link settings.
- Schema.org event metadata is included by the layouts.
Recommended Configurations
- Events Display-Type: Upcoming events
- Events in module: 1 or 3
- Show Flyer: Yes
- Show Calendar: Yes
- Show Description: Yes
- Max description length: 180
- Link to Event on Title: Yes
- Layout: cards or responsive
- Featured events only: Yes
- Events Display-Type: Upcoming events
- Events in module: 3
- Shuffle events: Optional
- Colour: from Category
- Show More Information: Yes (button)
- Events Display-Type: Today's events
- Time offset: Empty
- Show Venue: Yes
- Date Display-Type: Show day difference
- Show “No events”: Yes
- Event ID: Enter one or more event IDs
- Show Flyer: Yes
- Flyer links to: Event's details view
- Show Description: Yes
- Show Venue: Yes
- Show Category: Optional
Troubleshooting
| Problem | Possible Cause | What To Check |
|---|
| No events are shown. |
No matching events, restrictive filters, or Show “No events” disabled. |
Check event status, dates, categories, venues, event IDs, county filter and featured-only setting. |
| Wrong events appear for date-based filters. |
Display type, time offset or max days may not match the intended range. |
Review Events Display-Type, Max. days and Time offset. |
| Flyer does not appear. |
The event has no image, or Show Flyer is disabled. |
Check the event image and Show Flyer setting. |
| Flyer modal does not open. |
Flyer link type or lightbox support may not be active. |
Use “Image in modal window” and verify template JavaScript compatibility. |
| Category colour is not used. |
Multiple categories have different colours or no category colour is available. |
Use one category colour or configure a fallback colour. |
| Read more link appears unexpectedly. |
The event contains a read more break and the module option allows read more output. |
Check Show “Read more...” Break and the event description. |
| More information link is missing. |
No associated Joomla article exists or the visitor cannot access it. |
Check event article association and Joomla article access level. |
Related Development Notes
Recent JEM development and issue discussions include improvements around banner date filtering, module ACL behavior, calendar sheet colours, image/lightbox behavior, read more handling, event ID filtering and module layout overrides.
