Weekly Calendar

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

The Week Calendar view displays events in a weekly calendar grid. It is useful for weekly agendas, recurring activities, classrooms, club programmes, venue schedules, and category-based event calendars.

Purpose

The Week Calendar focuses on one or more consecutive weeks. It combines week navigation, day links, event blocks, category colours, legends, print support, and iCal/export actions where available.

Menu Item Type

Menu TypeInternal ViewLayoutMain Use
Week Calendar weekcal default Displays events in a weekly calendar grid, with optional multi-week output.

View Options

OptionDefaultDescription
Intro Text Empty Optional text displayed above the week calendar.
Show Intro Text Hide Controls whether the intro text is displayed.
Show Archived Events No Includes archived events in the weekly calendar.
Number of Weeks 1 Defines how many consecutive weeks are displayed.
Top Category 0 Limits the calendar to a selected top category and its child categories.
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 week.
Max events per day 10 Limits events shown per 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 used for event links.
Event background colour #FFFF00 Default background colour for event blocks.
Use category colour No Uses the event category colour as event background when exactly one category colour is available.
Current day colour #CCCC99 Highlights the current day number.
Event and more colour #FFFF00 Colour used for the “and more” link.
Use featured border No Adds a border to featured events.
Featured border colour #000080 Border colour for featured events.
Recurrence icon rendering Font Uses 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 selected week is controlled by yearID and weekID.
  • JEM uses ISO week numbering.
  • If Number of Weeks is greater than one, the calendar displays several consecutive weeks.
  • Previous and next navigation move by the configured number of visible weeks.
  • Day cells link to the Day View.
  • When a day has more events than the configured limit, JEM shows an “and more” link.
  • Multi-day events can be expanded across all days or shown only on the start day.
  • Category legend entries can be used to show or hide events by category.
  • Print and iCal actions keep the selected week context.

Recommended Configurations

ScenarioRecommended Settings
Weekly public agenda Number of Weeks: 1; Legend: Below; First weekday: Monday.
Two-week course programme Number of Weeks: 2; Show only start day: No.
High-volume calendar Max events per day: 5; Legend: Above; Use category colour: Yes.
Frontend-managed calendar Show Add Event Icon: Yes; Show Edit Event Icon: Yes; configure ACL carefully.

Template Overrides

  • templates/YOUR_TEMPLATE/html/com_jem/weekcal/default.php
  • templates/YOUR_TEMPLATE/html/com_jem/weekcal/responsive/default.php

Troubleshooting

SymptomCheck
No events appear. Check selected ISO week/year, event publication status, archive setting, access levels, and Top Category filter.
Multi-day events appear too often. Enable Show only start day.
Too many events fill a day cell. Lower Max events per day.
Colours do not appear. Check category colour values and Use category colour / Category colour marker settings.
Add/edit icons do not appear. Check both menu options and user permissions. Icons are not shown in print view.

Related Development Notes

#1982 - New options in calendar view menu Relevant to calendar menu parameters.
#1960 - iCal buttons not working correctly Relevant to calendar export actions.
#1715 - Pointing to today / next event Useful date-navigation context.
#1979 - Contact information in category calendar Relevant to richer calendar event blocks.
#2126 - Frontend event visibility Important access-control context.