Category Calendar

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

The Category Calendar view displays a monthly calendar filtered to one selected JEM category.

Purpose

This view is useful when a site needs a calendar dedicated to one category, such as concerts, courses, meetings, sports, workshops, or any other event group.

Menu Item Type

Menu TypeInternal ViewLayoutRequired Selection
Category Calendar category calendar A JEM category ID.

Required Option

OptionDefaultDescription
Select Category None Required. Defines which JEM category is used as the calendar filter. Only events assigned to this category 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 category.
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 in the category.
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 #FFFF00 Default event block background colour.
Use category colour No Uses the event category colour as background when possible.
Current day colour #CCCC99 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 category.
  • The selected month is controlled by yearID and monthID.
  • Day links open the Day View with the category context using catid.
  • The “and more” link opens the Day View for that date and category.
  • Category access is checked before the calendar is displayed.
  • Guests without access are redirected to login; authorised users without access receive a 403 response.
  • Print and iCal actions keep the selected month context.

Recommended Configurations

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

Template Overrides

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

Troubleshooting

SymptomCheck
Category calendar does not load. Check that a valid category is selected in the menu item.
User cannot access the view. Check category access level and user groups.
No events appear. Check event publication status, archive setting, date range, and category assignment.
“And more” appears too early. Increase Max events per day.
Colours do not appear. Check category colour values and Use category colour / Category colour marker options.

Related Development Notes

#1979 - Show contact information in category calendar Relevant to richer event information in category calendar tooltips.
#1982 - New options in calendar view menu Useful context for calendar menu options.
#1875 - Warning in category-calendar after archive fix Related to category calendar and archive handling.
#1960 - iCal buttons not working correctly Relevant to calendar export buttons.
#2126 - Frontend event visibility Important access-control context for frontend calendars.