Events List

Events List displays JEM events in a structured list. It is the most general frontend event listing view and is usually the best starting point when the site needs a searchable, sortable and paginated list of upcoming events.

This view can show regular event data such as date, title, venue, city, state/county and category. It can also be configured to show only featured events, archived events, open-date events, selected categories or events within a relative date range.

When To Use This View

Scenario	Recommended use	Why
Main public event list	Show upcoming events ordered by date.	Clear and predictable for visitors.
Featured programme	Enable “Featured only”.	Useful for curated or highlighted events.
Past events archive	Enable archived events or use archive task links.	Separates historical content from active programme.
Category-specific list	Limit the view to selected categories.	Useful for dedicated pages such as concerts, workshops or museum events.
Short-term agenda	Use event-from and event-until range options.	Good for “next 7 days”, “this month” or “coming season” lists.

Access And Visibility

Events List respects JEM event access rules, category access rules and Joomla view access levels. Visitors only see events they are authorised to view.

Element	Effect
Event access level	Controls whether the visitor can see the event.
Category access level	Can hide events assigned to restricted categories.
Published state	Only published events are normally shown unless archive mode is used.
Featured flag	Can be used to show only highlighted events.
Frontend add permissions	Users with add permissions may see event or venue submission icons, depending on global settings.

Menu Options

Option	Default	Purpose
Show only archived events	No	Displays archived/past events instead of the normal active list.
Featured only	No	Limits the list to events marked as featured.
Show event introtext	No	Displays each event’s intro text in the list when supported by the layout.
Show icons in order	Yes	Shows icons in the ordering/header area where applicable.
Show icons in event title	Yes	Shows event-related icons beside the event title.
Show icons in event data	Yes	Shows icons beside event metadata such as venue or category.
Table order by	Date	Initial ordering field: date, title, venue, city, state/county or category.
Table direction order	Ascending	Initial sort direction.
Filter event from	Empty	Relative day offset for the start of the list range.
Filter event until	Empty	Relative day offset for the end of the list range.
Display month row	No	Adds a month separator row to make longer lists easier to scan.
Show more button	No	Allows progressive loading where supported by the layout.
Category filter	Empty	Limits or excludes events by category IDs, depending on the category switch configuration.
Include subcategories	No	Includes events from child categories when the view is filtered by category.
Show open-date events	No	Can include events without a fixed date or show only open-date events.
Introtext / Footer text	Hidden by default	Adds page-level text above and below the list.

Search And Frontend Filters

The visible frontend search filter depends on global JEM settings. When enabled, users can search by the fields configured for the list.

Filter type	Searches in	Use case
Title	Event title	Find a known event by name.
Venue	Venue name	Find events at a specific location.
City	Venue city	Useful for regional event directories.
Category	Event category	Useful when category names are meaningful to visitors.
State / County	Venue state or county	Useful for large territories or multi-region sites.

Ordering Combinations

Order by	Best for	Recommended direction
Date	Normal agenda or upcoming events page.	Ascending for upcoming events, descending for archive pages.
Title	Alphabetical directories.	Ascending.
Venue	Venue-oriented event lists.	Ascending.
City	Regional directories.	Ascending.
State / County	Large geographic directories.	Ascending.
Category	Programmes grouped by topic.	Ascending.

Date Range Examples

jem eventlist date filter logic

The “Filter event from” and “Filter event until” options use relative day values. They are useful when a menu item should always show a moving time window.

Goal	Filter from	Filter until	Result
Show today and future events	0	Empty	Starts from today without a fixed end date.
Show next 7 days	0	7	Rolling one-week agenda.
Show next 30 days	0	30	Rolling monthly programme.
Show recent past and upcoming events	-7	14	Shows one week back and two weeks ahead.

Category Filtering

Events List can be limited to selected categories. If subcategories are enabled, events from child categories are also included.

Configuration	Behaviour
No category filter	Shows all accessible events.
Selected categories only	Shows events assigned to those categories.
Selected categories with subcategories	Shows events from the selected categories and their descendants.
Open-date events included	Events without a fixed date can be mixed into the list.
Open-date events only	The view becomes a list of events without scheduled dates.

Page Text

Events List supports page intro and footer text. This is useful for explaining the purpose of the list, the date range, submission rules or editorial criteria.

Text area	Position	Example use
Introtext	Below the page heading and above the filters/list.	“This page shows the next 30 days of public events.”
Footer text	Below the list.	“Event information is maintained by the organisers. Please check details before attending.”

Feed And Export Behaviour

Events List can expose feed links for RSS and Atom, allowing visitors or external tools to follow the event stream. Depending on global settings, calendar export links such as iCal may also be available in JEM output.

Recommended Configurations

Page type	Recommended options	Reason
Main Events page	Order by date, ascending; featured only: No; show open-date events: optional.	Visitors expect the next events first.
Featured Events page	Featured only: Yes; order by date.	Creates a curated programme page.
Archive page	Show archived events: Yes; order by date descending.	Most recent past events appear first.
Category programme	Category filter plus include subcategories when needed.	Useful for topic-specific menus.
Short agenda	Filter from 0, filter until 7 or 30.	Keeps the list focused and automatically updated.

Related Project Notes

#2121 covers date range options for the simple event list.
#2014 clarifies supported layouts for the “Load More” button.
#2126 relates to frontend access visibility for public events.
#2131 relates to creating a complete JEM frontend menu.
#2154 standardises intro and footer text options across JEM views.