JEM Types Module

The JEM Types module displays published JEM event types in a module position. It can work as a compact navigation block with event counts, or as a richer module that shows the next upcoming events grouped by type.

This module is useful when the site uses event types as a second classification layer beside categories. Categories normally describe the section or topic of the event, while types describe the event format, such as Concert, Guided Tour, Workshop, Talk, Festival, Meeting, Webinar, or Exam.

What The Module Displays

Display ModeFrontend ResultBest Use
Summary with count Shows a list of event types, each linked to its Type Events page, with the number of upcoming visible events. Compact navigation module, sidebar block, dashboard-style overview.
Top N events per type Shows each event type with its next upcoming events. Landing pages, homepage blocks, programme highlights, activity previews.

Important Concepts

ConceptMeaning In JEM
Event type A classification assigned to an event to describe what kind of event it is.
Type Events page The frontend view that lists all events belonging to one selected event type.
Event count The number of upcoming published events of that type visible to the current visitor.
Associated article An optional Joomla article linked to an event. The module can show a More information link or button for it.

Basic Options

OptionDefaultDescriptionRecommendation
Display mode Summary Selects whether the module shows a compact type list with counts or upcoming events grouped by type. Use Summary for sidebars. Use Top N for homepage or landing-page content.
Events per type 3 Defines how many upcoming events are shown per type in Top N mode. Use 2 or 3 for compact layouts. Use more only in wide module positions.
Show More Information Yes, link Shows a More information link or button when an event has an associated Joomla article. Use link for compact modules, button for more visual landing-page blocks.
Show More Information Title No Adds the associated article title after the More information text. Enable only if article titles add useful context and do not make the module too long.
Hide types with no events No Removes event types that currently have no upcoming visible events. Enable for public navigation. Disable when the module should show the complete type catalogue.
Show module when no types No Controls whether the module area is still rendered when there are no types to display. Usually leave disabled on production sites.

Advanced Options

OptionDescription
Alternative layout Selects a module layout override if one exists in the template or module layout folder.
Module class Adds a custom class suffix to the module wrapper for template-specific styling.
Caching Uses Joomla module caching settings. Disable cache when testing changes or when event visibility changes frequently.
Cache time Defines how long the module output is cached when caching is enabled.

Summary Mode

In Summary mode, the module displays a list of event types. Each type links to the corresponding Type Events frontend page. The module also shows the number of upcoming events available for that type.

If the event type has an icon, the icon is shown before the type name. If the type has a valid color, the module uses it as a visual marker. If the type has a description, it can be used as tooltip text.

ElementShown In Summary Mode
Type name Yes, linked to the Type Events page.
Type icon Yes, when configured for the type.
Type color Yes, as a left visual marker when a valid color is configured.
Event count Yes, shown as a badge.
Upcoming event titles No. Use Top N mode for that.

Top N Mode

In Top N events per type mode, the module displays each type as a group and lists the next upcoming events for that type. Each event links to its event detail page.

If an event has an associated Joomla article, the module can show a More information link or button. This is useful for events that have extra editorial content, long explanations, downloads, or supporting documentation.

ElementShown In Top N Mode
Type heading Yes, linked to the Type Events page.
Type icon Yes, when configured.
Upcoming events Yes, limited by the Events per type option.
Event date/time Yes, shown next to each event title.
More information Optional, only when an event has an associated article.
View all events Yes, shown as a link to the full Type Events page.

Visibility And Access Rules

The module only counts and displays content that the current visitor is allowed to see. This is important because the same module can produce different results for guests, registered users, editors, or administrators.

ItemRule Applied
Types Only published event types with entity set to events are considered.
Type access The visitor must have access to the type.
Events Only published upcoming events are counted or listed.
Event access The visitor must have access to the event.
Category access The event must belong to a visible published category.
Venue access If the event has a venue, the venue must be published and accessible.
Language The module respects the active site language and type translations when configured.
Date range The module focuses on current and future events. Finished past events are not included.

Recommended Configurations

GoalConfiguration
Sidebar type navigation Display mode: Summary. Hide empty types: Yes. Show module when no types: No.
Homepage programme overview Display mode: Top N. Events per type: 2 or 3. Show More Information: Link or Button.
Complete public type catalogue Display mode: Summary. Hide empty types: No. Show event counts so visitors can see which types are active.
Editorial event highlights Display mode: Top N. Enable More Information and associated article titles when articles add meaningful context.
Compact mobile module Display mode: Summary. Hide empty types: Yes. Avoid long module titles and keep type names short.

Examples

ScenarioSuggested TypesSuggested Module Mode
Museum website Guided Tour, Talk, Workshop, Family Activity Top N on the homepage; Summary in a sidebar.
Music programme Concert, Festival, DJ Set, Rehearsal Summary with counts for quick navigation.
School or academy Exam, Homework, Workshop, Presentation Top N per type for a student dashboard-style page.
Business events Webinar, Training, Meeting, Conference Top N on landing pages, Summary on section pages.

More Information Links

The More Information option works with events that have an associated Joomla article. When enabled, the module can display a link or button pointing to that article.

OptionBehaviour
No No article link is shown, even if the event has an associated article.
Yes, link Shows More information as a normal text link.
Yes, button Shows More information styled as a button.
Show More Information Title When enabled, the associated article title is appended after the More information text.

Troubleshooting

SymptomLikely CauseWhat To Check
The module is not visible There are no visible types or no visible events, and Show module when no types is disabled. Check module assignment, published state, access level, and the Show module when no types option.
A type is missing The type is unpublished, not an event type, not accessible, filtered by language, or hidden because it has no upcoming events. Check type status, entity, access, language, and Hide empty types.
Event count is lower than expected Some events are past, unpublished, inaccessible, assigned to hidden categories, or assigned to inaccessible venues. Check event dates, status, access levels, category access, and venue access.
Top N mode shows “No upcoming events” The type exists, but no upcoming visible events match it. Create or publish upcoming events assigned to that type, or enable Hide empty types.
More Information is not shown The event does not have an associated Joomla article, or the option is disabled. Check the event article association and the Show More Information option.
Links do not go to the expected page No dedicated Type Events menu item exists, or Joomla routing uses a fallback route. Create a Type Events menu item for important types when you need predictable routing and module positions.

Related Frontend Views

ViewRelationship With This Module
Type Events The module links each event type to its full Type Events list.
Events List Shows a broader event list that may include many types together.
Search Can expose event type as a search/filter field depending on configuration.
Day Timeline Can visually display event type labels/icons when configured.
Events Map Can combine geographic discovery with event classification by category, country, and other filters.

Related Project Notes

IssueRelevance
#1603 Type of event Original feature request describing why JEM needed event types as a second classification layer beside categories.
#2131 Generate complete JEM frontend menu Relevant because type-based frontend navigation and testing depend on predictable menu routes.
#2154 Intro and footer text in frontend views Related to consistent frontend documentation and page text patterns used around type-based views.