Venue Calendar

Applies to: JEM 4.5 beta 5 and JEM 5.0 beta 3, depending on the Joomla version used by the site.

The Venue Calendar view displays a monthly calendar filtered to one selected JEM venue.

Purpose

This view is useful for theatres, clubs, classrooms, conference rooms, museums, sport facilities, meeting spaces, or any location that needs its own event calendar.

Menu Item Type

Menu TypeInternal ViewLayoutRequired Selection
Venue Calendar venue calendar A JEM venue ID.

Required Option

OptionDefaultDescription
Select Venue None Required. Defines which JEM venue is used as the calendar filter. Only events assigned to this venue are listed.

View Options

OptionDefaultDescription
Intro Text Empty Optional text displayed above the calendar.
Show Intro Text Hide Controls whether the intro text is displayed.
Show Archived Events No Includes archived events for the selected venue.
Display Legend Below Shows the category legend above, below, or hides it.
Show only start day No If enabled, multi-day events appear only on their first day.
First weekday Monday Sets Sunday or Monday as the first day of the calendar week.
Max events per day 10 Limits the number of events shown in each day cell before an “and more” link appears.
Show Add Event Icon No Shows an add-event action when the user has permission to create events.
Show Edit Event Icon No Shows event edit actions when enabled and permitted.
Show Copy Event Icon No Shows event copy actions when enabled and permitted.
Event link colour #000000 Text colour for event links.
Event background colour #c8deb1 Default event block background colour for the venue calendar.
Use category colour No Uses the event category colour as background when possible.
Current day colour #344280 Highlights the current day number.
Event and more colour #FFFF00 Colour for the “and more” link block.
Use featured border No Adds a special border to featured events.
Featured border colour #000080 Border colour used for featured events.
Recurrence icon rendering Font Uses either icon fonts or image icons for multi-day indicators.
Category colour marker Marker block Displays category colours as blocks or as a top bar.

Frontend Behaviour

  • The calendar is restricted to the selected venue.
  • The selected month is controlled by yearID and monthID.
  • Day links open the Day View with the venue context using locid.
  • The “and more” link opens the Day View for that date and venue.
  • Venue access is checked before the calendar is displayed.
  • Guests without access are redirected to login; authorised users without access receive a 403 response.
  • Print, archive, and iCal actions keep the selected venue and month context.

Archive Behaviour

The Venue Calendar supports archive context. When archive mode is active, print and archive links preserve the venue route and selected calendar context.

Permissions

PermissionEffect
Create event Required for the Add Event icon to be displayed.
Create venue Used by JEM button actions where venue creation is available.
Edit event Required for event edit actions.
Venue access Required to load the venue calendar.
Event/category access Controls whether individual events inside the venue calendar are visible.

Recommended Configurations

ScenarioRecommended Settings
Theatre or venue programme Legend: Below; Show archived: No; Max events per day: 8.
Classroom or room calendar First weekday: Monday; Show only start day: No; Use category colour: Yes.
Public visitor calendar Add/Edit/Copy icons: No; Max events per day: 5.
Frontend-managed venue Add Event Icon: Yes, with ACL configured for trusted users.

Template Overrides

  • templates/YOUR_TEMPLATE/html/com_jem/venue/calendar.php
  • templates/YOUR_TEMPLATE/html/com_jem/venue/responsive/calendar.php

Troubleshooting

SymptomCheck
Venue calendar does not load. Check that a valid venue is selected in the menu item.
User cannot access the view. Check venue access level and user groups.
No events appear. Check event publication status, archive setting, date range, and venue assignment.
Day drill-down does not keep the venue. Check that the generated Day View link includes locid.
Colours do not appear. Check category colours and the Use category colour / Category colour marker settings.

Related Development Notes

#1986 - Add Color Field to Venue Useful venue-colour context for venue-related calendar and programme views.
#2035 - Add venue filter to Calendar view Relevant to venue filtering and venue-aware calendar output.
#1982 - New options in calendar view menu Useful context for configurable calendar options.
#1960 - iCal buttons not working correctly Relevant to calendar export actions.
#2126 - Frontend event visibility Important access-control context for frontend calendars.