JEM Jubilee Module

Module name: JEM - Module-Jubilee
Extension: mod_jem_jubilee
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 Jubilee Module displays anniversary-style events by matching the current day and month against event dates from previous years, current years, or both. It is designed for “on this day”, annual memories, anniversaries, historic events, commemorations, recurring institutional dates, and archived event highlights.

Unlike a normal upcoming events module, this module is date-match oriented. It can search published events, archived events, or both, and can match single-day or multi-day events by start date, end date, start or end date, or any day between start and end.

Requirements

JEM component installed and enabled.
Events with valid dates. Open-date events are not used for anniversary matching.
Archived events if the module is intended to work as an anniversary or historic-events module.
Event images if flyer display is enabled.

Basic Options

Anniversary Selection

Option	Default	Description
Intro Text	Empty	Text shown beside the calendar image. Supports `[day]`, `[month]`, and `[year]`.
Publishing State	`Archived events`	Selects published events, archived events, or both. Archived events are the normal choice for anniversary use.
Events in Module	`5`	Maximum number of events displayed. Internally limited to a practical range from 1 to 100.
Show “No events”	No	Shows a message when no matching anniversary events are found.
Day Offset	Empty	Moves the matching date into the future or past. For example, `1` searches tomorrow’s anniversary date.
Date Match Mode	`Any time from start to end date`	Controls how multi-day events are matched against the selected anniversary date.
Include Past Years	No	Includes events from past years in the result set.

Date Match Modes

Mode	Meaning	Best For
Any time from start to end date	A multi-day event matches if the selected day/month falls anywhere between start and end.	Festivals, campaigns, exhibitions, and long-running events.
Exact on start date	The selected day/month must match the event start date.	Opening days, launch dates, first editions, or founding dates.
Exact on end date	The selected day/month must match the event end date.	Closing days, final dates, or commemorating the end of an event.
Exact on start or end date	The selected day/month can match either start or end date.	Events where both opening and closing anniversaries matter.

Ordering and Random Selection

Option	Default	Description
Shuffle Events	No	Randomly selects events from the available pool when more events exist than can be displayed.
Shuffle Pool Limit	Empty	Limits how many events are read before random selection. The module keeps this at least as high as the display count.
Event Order	`Date descending`	Controls whether matching events are ordered from newest to oldest or oldest to newest.

Display Options

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.
Show Calendar	Yes	Shows a calendar-style date image for the searched anniversary date.
Colour	`red`	Sets the calendar image colour. Options include red, blue, green, orange, and user-defined.
User Colour	`#EEEEEE`	Used when the colour option is set to user-defined.
Show Flyer	Yes	Shows the event image when available.
Flyer Links To	`Image on full page`	Controls whether the flyer opens the image, opens a modal image, opens the event details page, or has no link.

Description and Article Links

Option	Default	Description
Show Description	Yes	Shows the event intro text in the module.
Max Description Length	`300`	Limits the displayed description length.
Allow Line Breaks	No	Preserves or removes line breaks from the event description.
Show “Read More” Break	No	Shows a read-more link or button when the event text contains a read-more break.
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, Time, Category, Venue, and Location Filters

Option	Default	Description
Date Display-Type	`Hide date`	Can hide the date, show the formatted date, or show the year difference from the matched date.
Date Format	Empty	Uses the JEM/global date format unless a PHP date format is entered.
Show Time	No	Shows event time when available.
Time Format	Empty	Uses the JEM/global time format unless a PHP time format is entered.
Show Category	No	Displays event categories.
Link to Category	Yes	Makes category names link to JEM category views.
Show Venue	No	Displays venue name.
Link to Venue	Yes	Makes venue names link to JEM venue views.
Categories	Empty	Limits anniversary matching to selected categories.
Venues	Empty	Limits anniversary matching to selected venues.
County	Empty	Filters by venue county/state. Multiple values can be comma-separated.
County Match Mode	`Complete Match`	Controls whether county filtering must match exactly or only contain the entered text.

Advanced Options

Option	Default	Description
Layout	`default`	Selects the module layout. The module includes default and responsive layouts.
Module Class	Empty	Adds custom classes to the module container.
Caching	`Use Global`	Controls Joomla module caching.
Cache Time	`900`	Cache lifetime in seconds. The default is 15 minutes.

Recommended Configurations

Classic Anniversary Module

Publishing State: Archived events
Date Match Mode: Exact on start date
Include Past Years: Yes
Date Display-Type: Show year difference
Show Flyer: Yes

Best for “on this day” or institutional history blocks.

Festival Anniversary

Date Match Mode: Any time from start to end date
Publishing State: Both
Show Calendar: Yes
Show Description: Yes
Max Description Length: 200-300

Best for multi-day events where any matching day should count.

Troubleshooting

Problem	Possible Cause	Suggested Fix
No anniversary events are shown.	No event matches the current day/month, publishing state, date match mode, or filters.	Check event dates, archived/published state, category/venue filters, and the Date Match Mode.
Expected old events are missing.	Include Past Years is disabled or the event is not archived/published according to the selected state.	Enable Include Past Years and verify Publishing State.
Multi-day events do not match.	Date Match Mode is too strict.	Use Any time from start to end date for multi-day anniversary matching.
Flyer links do not behave as expected.	Flyer Links To is not set to the desired target.	Choose image page, modal image, event details, or no link according to the intended behaviour.