Skip to main content

CALENDAR PRO

Event Calendar for Joomla + YOOtheme Pro

Documentation

Changelog: v2.0.0 - November 6, 2026

Calendar Pro Changelog

Version 2.0.0

November 6, 2026
  • Addition FullCalendar 7.1.4: about 400 KB of JavaScript per page instead of 1.6 MB, with no jQuery or moment.js.
  • Addition Website Style theme (default for new calendars): the calendar takes its colors, buttons and title font from your YOOtheme style, also in dark sections (including styles without inverse colors) and with the dark color scheme, with white or black event text where the style's text color doesn't read on an Event Color.
  • Addition New themes UIkit 3, Monarch, Forma, Breezy and Pulse with color palettes, and a Light, Dark or Auto color scheme for each calendar.
  • Addition New views: Time Grid Week and Day, Multi-Month Year, Timeline Week and Month, Resource Time Grid Week, with toolbar buttons for them and for the Year view.
  • Addition Style tab: Title (YOOtheme headline style, decoration, font family, color, heading level), Toolbar Buttons (style, active style, size), Events, Calendar Grid and Categories.
  • Addition Hover: Zoom, Zoom with Shadow, Lift, Glow or Brighten, with Zoom Size and Speed, plus Focus (the other events fade) and a Tooltip with the time and full title.
  • Addition Title Icons next to event titles, with UIkit icons and ZOOlanders Essentials icon collections.
  • Addition Category Headers in the colors of their events (Timeline and Resource Time Grid views).
  • Addition Date Handling "Accurate": all-day events land on the entered day, times use the calendar's time zone, recurring events keep their weekday, length and end date.
  • Addition Excluded Dates for recurring events (with Date Handling Accurate).
  • Addition Toolbar layouts with a centered title, Day Button Opens and Clicked Date Opens.
  • Addition Events Per Day with a "+ more" popover, Week Numbers, Now Indicator, Business Hours, Initial Scroll Time and End Times.
  • Addition Dynamic Content for the calendar's settings too, not only its items: text, color and select settings can be mapped (not the on/off switches or the General options, nor the Style tab's Title style, decoration, font and color, Toolbar Buttons, Hover and Category Headers options).
  • Addition Labels you leave empty follow the calendar's language (81 FullCalendar translations, right-to-left languages included), and events and modals can be reached with the keyboard.
  • Change Installation and updates check for PHP 8.1+, Joomla 5+ and YOOtheme Pro 4+ and stop with a clear message; the plugin is enabled right after installing.
  • Change The Download ID entered in the plugin settings is now used for updates: Calendar Pro copies it to its Update Site. For the update from 1.x, upload the 2.0 zip or enter the Download ID on the Update Site first.
  • Change Calendars saved with 1.x keep their look and their Legacy date handling. Switch them to Accurate when you're ready.
  • Change Recurring events show their full length (start to end), also in calendars saved with 1.x.
  • Change Custom CSS from 1.x keeps matching the main FullCalendar classes (fc-event, fc-event-title, fc-button, fc-day-today). CSS that colored category headers by position (.fc-col-header-cell:nth-child) no longer matches: use the Event Colors option of Category Headers in the Style tab.
  • Change The search field shows in the toolbar right away (no Search button to click) and also matches the category and content. Date Navigation is now called Clickable Dates.
  • Change The URL of every Calendar Pro file carries a checksum, so browsers and CDNs load the new files after an update.
  • Change The Print button prints only its calendar, without the header, menus and everything else on the page, laid out for paper by FullCalendar: every event of the view (no + more link), also with a fixed Calendar Height.
  • Removed jQuery, moment.js, moment-timezone and the Bootstrap 5 stylesheet are no longer loaded. The Bootstrap 5, Flatly and Minty themes use Classic.
  • Fix The Week button showed six weeks when Fixed Weeks was on.
  • Fix An End Time at or before the Start Time (e.g. 12:00 AM) is on the next day.
  • Fix Modal content, "Open in a new window", Limit Start Date and the Modal width, height, full screen, padding and margin settings work again.
  • Fix Several calendars on one page no longer interfere with each other; email cloaking stays active on pages with a calendar.
  • Fix Titles and categories written with HTML character codes, such as the code of the registered trademark sign, show the character itself on the calendar, in modals and in the search.
  • Security Event titles, categories, links and Dynamic Content values are safely encoded.

Version 1.4.0

December 6, 2025
  • Addition Added Joomla 5.4+ / 6+ and PHP 8.1+ through 8.4+ support
  • Addition Added comprehensive input validation for all date and timezone fields
  • Addition Added fallback values for all calendar settings
  • Addition Added additional user-facing security and prevention methods
  • Removed Removed Joomla 3 support and legacy/deprecated code
  • Fix Fixed "Array to string conversion" error that prevented calendar from displaying
  • Fix Fixed JavaScript syntax errors caused by invalid timezone or date values
  • Fix Fixed PHP warnings on undefined properties in PHP 8.x
  • Fix Fixed calendar not rendering when timezone was set to "local"
  • Fix Fixed recurring events not displaying when end date was invalid

Version 1.3.0

October 31, 2025
  • Removed htmlspecialchars() removed from content filter so html is rendered correctly. Dynamic content shouldn't be affected by this change. Text editors or raw code can now be edited or updated without issues.
  • Removed Removed Ghosts 🎃Happy Halloween🎃
  • Fix Thanks to user Francis Valenzuela for helping update the print code for a better printing/user experience.
  • Fix Minor code revisions and updates.

Version 1.2.2

August 8, 2025
  • Addition Added a div and id "cal-email-cloak" to the Email Cloak tag so it may be manually manipulated via css if required. NOTE: This is only shown when the Joomla Email Cloak plugin is disabled.

Version 1.2.1

July 8, 2025
  • Fix Changed "Modal Title" to just the "Title" to show the correct title when opening a modal window/pop-up on each event.
  • Fix Updated FullCalendar Base JS Version to: 6.1.18

Version 1.2.0

January 6, 2025
  • Addition Recurring by specific days has been added in per event. NOTE: There is a larger known issue where your event may jump to a day before or a day after your desired day based on your time zone selection. Just choose a different day to offset it, or change the time on your event a few hours one way or another at this time.
  • Fix Changed some of the test date, time and time zone text in the modals.
  • Fix Refactored some code and cleaned up a minor time error if no time zone was selected.

Version 1.1.1

December 3, 2024
  • Fix Changed Text Color in each Calendar item to override the default main text color in settings. This only works when a background color is used, like a multi day event or timeline view.
  • Fix Moved "Event Text Color" in Main Calendar Pro element settings so you can set a default text color.

Version 1.1.0

December 1, 2024
  • Fix Added a "Show Past Events" option to force all events in the past dates to show.

Version 1.0.8

November 25, 2024
  • Addition Custom End Dates are still available with the optional checkbox that's now added to limit the end date.
  • Fix Changed "Limit End Date" to include preset time periods from today's date (i.e. 1 month, 1 year, etc.).

Version 1.0.7

November 5, 2024
  • Fix Minor custom changes and code cleanup to prevent a date bug.

Version 1.0.6

October 9, 2024
  • Addition Included the option to globally hide the date title

Version 1.0.5

October 9, 2024
  • Fix Fixed default "local" time zone to use the user's browser time to avoid errors.

Version 1.0.4

October 6, 2024
  • Fix Fixed date headers showing for future events if maz events were limited
  • Fix Minor code changes and clearup for dates, time zones and max events

Version 1.0.3

October 5, 2024
  • Addition If Modal is disabled, the event link can be used when the event is clicked on
  • Fix Reorganized options in the main element view for Display & Modal/Link options
  • Fix Event would disappear when modal options were disabled.

Version 1.0.2

October 4, 2024
  • Addition If loading is needed for more events, a loading icon will now show. This is rare in most setups.
  • Addition Lazy loading for when a lot of events are needing to load at once.
  • Addition "Hide Past Events From Today" as an option for the "Limit Start Date" of events that will always use "today's" date.
  • Removed Unnecessary code from beta testing
  • Fix Move some code around to work better with multiple events needing the date/time/timezone, etc.

Version 1.0.1

October 3, 2024
  • Fix Fixed update URL
  • Fix "Start Date" now works as expected
  • Fix Print fuction updated and print button only prints calendar now.
  • Fix Refactored some code and scripts for better loads
  • Fix Search Bar style fix & better reset reliability

Version 1.0.0

October 2, 2024
  • Addition Calendar Pro Element - First Release for YOOtheme Pro

1. Getting Started

What is Calendar Pro?

Calendar Pro is an event calendar for YOOtheme Pro on Joomla. You add the Calendar Pro element to a layout, add one item per event, and choose how the calendar looks and which views your visitors can use.

  • Month, week, day, year, time grid, list, timeline and resource views
  • One-time, all-day, multi-day and recurring events
  • Event modals you build with YOOtheme elements, or direct links
  • Themes, including Website Style, which follows your YOOtheme style, with light and dark color schemes
  • Search, printing, hover effects and tooltips
  • Time zones, 60+ languages and Dynamic Content

Calendar Pro is made by Modern Designs and powered by FullCalendar 7.1.4. All of its files are served from your own site: no CDN, no jQuery and no moment.js.

What is Calendar Pro?

What's New in 2.0

Calendars made with 1.x keep working and keep their look (see Upgrading from 1.x).

  • FullCalendar 7.1.4: about 400 KB of JavaScript per page instead of 1.6 MB, all served from your site.
  • New themes: Website Style (matches your YOOtheme style), UIkit 3, Monarch, Forma, Breezy and Pulse, with Light, Dark and Auto color schemes.
  • Style tab: title, toolbar buttons, event style, hover effects, focus, tooltips and category header colors.
  • New views: Multi-Month Year, Time Grid Week and Day, Timeline Week and Month, and Resource Time Grid Week. The Year view gets a toolbar button.
  • Title Icons next to the event titles.
  • Accurate date handling: all-day events land on the entered day, and recurring events keep their weekday, length and end date.
  • Excluded Dates for recurring events, such as holidays.
  • Search Field in the toolbar, which now also matches the category and content, not only the title.
  • More options: Events Per Day with a "+ more" link, Week Numbers, Now Indicator, Business Hours, Initial Scroll Time, End Times, Toolbar Layout, Day Button Opens, Clicked Date Opens and the Joomla Site Time Zone.
  • Languages: labels you leave empty follow the selected locale, including right-to-left languages.
  • Dynamic Content for the calendar's settings too, not only its items.
  • Easier setup and updates: the installer checks the requirements and enables the plugin, and your Download ID is copied to the Update Site.
  • Print Button: prints only the calendar, laid out for paper by FullCalendar, without the rest of the page.

System Requirements

  • Joomla: 5.0+ (Joomla 6 supported; tested on Joomla 5.4 and 6.2)
  • PHP: 8.1+
  • YOOtheme Pro: 4.0+ (YOOtheme Pro 5 supported)
  • Optional: ZOOlanders Essentials for more icon collections and sources such as Google Calendar (a paid add-on, not part of Calendar Pro)

The installer checks PHP, Joomla and YOOtheme Pro on every install and update. If one of them is too old, it stops with a clear message and nothing on your site is changed.

How It Works

Calendar Pro has two parts in the YOOtheme Pro page builder:

  • Calendar Pro: the calendar itself. Its tabs are Content, Settings, Style and Advanced.
  • Calendar Pro Item: one event, or one repeating series. Its tabs are Content, Modal, Settings and Advanced.

Views: the calendar opens in its Default View, or in its Mobile View on phones. View buttons in the toolbar let visitors switch, for example from Month to Week or Day.

Themes: Style > Theme sets the look. The default, Website Style, takes its colors, buttons and title font from your YOOtheme style.

Clicks: clicking an event opens its modal, which you build like any YOOtheme layout. With the modal turned off, it opens the event's link instead.

The calendar is drawn in the visitor's browser. In the YOOtheme customizer, the preview reloads after each change.

How It Works

Demo Pages

See Calendar Pro 2.0 in action:

  • Calendar Demo: a community center's month with search, print and a modal for every event, plus a list of this week's events.
  • Google Sync: events from a Google Calendar, through the Google Calendar source of ZOOlanders Essentials (see Dynamic Content).
  • Timeline Views: Resource Time Grid and Timeline views with one column or row per room.
  • Video Demo: a video demo of Calendar Pro.
  • Class Schedule: a weekly time grid from 7 AM to 10 PM in half-hour slots, with business hours and a line at the current time.
  • Themes: the same events in every theme, in light cards and dark sections.
  • Hover Effects: Zoom, Zoom with Shadow, Lift, Glow and Brighten, plus Focus and Tooltip.

2. Installation

Install Calendar Pro

Calendar Pro installs like any Joomla extension:

  • Download the plugin zip after your purchase. The file name is plg_system_md_calendar_pro_2.0.0.zip.
  • Log in to the Joomla administrator with a Super User account.
  • Go to System > Install > Extensions.
  • Open the Upload Package File tab.
  • Drag and drop the zip onto the upload area, or browse for it.
  • Wait for the installation message (see Installation Message).

To update from an older version, upload the new zip the same way, over the old one. You can also use Joomla's updater (see Download ID; for the update from 1.x, see Upgrading from 1.x).

Install Calendar Pro

Installation Message

After a successful install, Joomla shows "Installation of the plugin was successful." and the plugin's description: "Calendar Pro Element for YOOtheme Pro, powered by FullCalendar 7 (all files served locally). Requires PHP 8.1+, Joomla 5+ and YOOtheme Pro 4+."

The installer checks the requirements first. If PHP, Joomla or YOOtheme Pro is too old, or YOOtheme Pro is missing, it shows a message such as:

Calendar Pro requires YOOtheme Pro 4.0 or newer, but YOOtheme Pro is not installed on this site.
The installation was stopped and nothing was changed on this site.

Update what is too old, then install Calendar Pro again. The same check runs on every update.

Installation Message

Plugin Enabled Automatically

On a fresh install, the installer enables the plugin System - Calendar Pro Element for YOOtheme Pro for you.

To check it, go to System > Manage > Plugins and search for "Calendar Pro". A green check in the Status column means the plugin is enabled.

If Joomla warns that the plugin could not be enabled automatically, enable it in this list. Keep it enabled: the plugin adds the Calendar Pro element to YOOtheme Pro.

Then open YOOtheme Pro. You find Calendar Pro in the Modern Designs group of the element library.

Plugin Enabled Automatically

Download ID

Enter your Download ID once to receive updates and bug fixes through Joomla's updater.

  • Get your Download ID at moderndesigns.studio/account/api-keys.
  • Go to System > Manage > Plugins and open System - Calendar Pro Element for YOOtheme Pro.
  • Paste it into Download ID.
  • Click Save.

When you save, Calendar Pro copies the Download ID to the extension's Update Site. That is where Joomla reads it when it downloads an update. An update that was waiting for the key can be installed right away.

Upgrading from 1.x? 1.x doesn't pass its Download ID on to Joomla's updater: upload the 2.0 zip, or enter the ID on the Update Site first (see Download Key on the Update Site). Once 2.0 is installed, a Download ID you entered in 1.x is copied to the Update Site for the updates that follow.

Download ID

Update Site

Joomla lists the Calendar Pro Update Site under System > Update > Update Sites. Search for "Calendar" to find Calendar Pro Element for YOOtheme Pro.

If it shows The Download Key is missing, no Download ID has reached the Update Site yet. Save your Download ID in the plugin settings (Calendar Pro 2.0 and later), or enter it on the Update Site (see Download Key on the Update Site).

Update location:
https://moderndesigns.studio/updates/calendar-pro?format=xml

Update Site

Download Key on the Update Site

You can also enter or change the key on the Update Site itself:

  • Go to System > Update > Update Sites.
  • Click Calendar Pro Element for YOOtheme Pro.
  • Enter your Download ID in Download Key.
  • Click Save & Close.

A key you edit here is kept. Saving the plugin settings again doesn't replace it, unless you change the Download ID there.

Download Key on the Update Site

Installing Updates

With your Download ID in place, new versions appear in System > Update > Extensions like any other Joomla extension. Select Calendar Pro and click Update. You can also upload a new zip over the old one.

  • Your calendars stay as they are: an update changes the plugin's files, not your layouts.
  • Cached pages keep working: each update keeps the previous version's files for one more update.
  • No stale files: since 2.0, every CSS and JavaScript URL ends in the version and a checksum of the file, so browsers and CDNs (such as Cloudflare) load the changed files.
  • Page cache or CDN: if it caches whole HTML pages, purge it once after updating.

Upgrading from 1.x

Install 2.0 over 1.x with Upload Package File. To use Joomla's updater instead, the Update Site needs your key first: 1.x doesn't pass its Download ID on, so if System > Update > Extensions shows The Download Key is missing, enter your Download ID under System > Update > Update Sites (see Download Key on the Update Site).

Calendars saved with 1.x keep their look and behavior:

  • Date Handling stays Legacy (v1.4 compatible), so events show on the same days and times as before.
  • Recurring events now show their full length, from their start to their end time. 1.x showed every repeat one hour long (one day for all-day events).
  • The theme stays: Standard, Bootstrap 5, Flatly and Minty use Classic, and Dark Blue keeps its colors (Classic Dark Blue).
  • The Day button keeps opening the day grid, as in 1.x.
  • Your Download ID from the plugin settings is copied to the Update Site, for the updates after 2.0.

New calendars start with Accurate date handling and the Website Style theme.

Switch a 1.x calendar to Accurate when you are ready: Settings > Calendar > Date Handling > Accurate (Recommended). Then check its events, especially all-day and recurring events. Excluded Dates only work with Accurate.

Calendar Pro no longer loads jQuery, moment.js or the Bootstrap 5 stylesheet.

Custom CSS from 1.x

Custom CSS written for 1.x keeps matching the main FullCalendar class names, such as fc-event, fc-event-title, fc-toolbar-title, fc-button and fc-day-today.

One exception: CSS that colored the category headers by position, such as .fc-col-header-cell:nth-child(2), no longer matches. Use Style > Categories > Category Headers > Event Colors instead, or the classes .mdcp-resource-header and .fc-resource.

Some things that needed custom CSS in 1.x are now settings in the Style tab, such as the title, toolbar buttons, event colors and the outer border.

Uninstall Calendar Pro

  • Remove or replace the Calendar Pro elements in your layouts.
  • Go to System > Manage > Extensions.
  • Search for "Calendar Pro".
  • Select System - Calendar Pro Element for YOOtheme Pro.
  • Open Actions in the toolbar, click Uninstall and confirm.

Uninstalling removes the plugin, its settings (Download ID) and the Calendar Pro element. To stop using it for a while, disable the plugin in System > Manage > Plugins instead. Calendars are not shown while the plugin is disabled.


3. Building a Calendar

Add the Calendar Pro Element

Add the Calendar Pro Element

Open a page in YOOtheme Pro, add an element and pick Calendar Pro from the Modern Designs group. Its Content tab holds the events and decides what happens when visitors click them:

Calendar Items
One item per event. Click Add Item for a new one, or create items from a Dynamic Content source.
Display
Show the time on the events, Show the Category field in the items (used by the Timeline and Resource Time Grid views), and Show the date title in the toolbar, such as "November 2026".
Default: all on
Title Icon
Where each item's Title Icon appears on the calendar: Before Title, After Title or Hidden.
Default: Before Title
Title Icon Size
Icon width in pixels. Leave empty to match the title text size.
Default: Empty (auto)
Modal/Links
Show the modal (sublayout) opens a modal when an event is clicked. Show the link, Show the content and Show the modal image/icon choose what the modal shows.
Default: all on
Event link active
When the modal is off, clicking an event opens its link.
Default: On
Add Events

Add Events

Click an item to edit it. The first part of its Content tab sets the title and the dates:

Title
Your calendar event name.
Default: Title
Title Icon
An icon next to the title on the calendar. Click the pencil to pick one.
Default: None
All Day Event
An event without a time. Time grid views show it in the all-day row at the top.
Default: Off
Start Date & Time
When the event starts. Required: an item without a start date is not shown.
End Date & Time
When the event ends. For a recurring event, the end of its first occurrence (its length). For an all-day event the end date is exclusive: for a one-day event, leave it empty or use the next day.
Default: Empty
Recurring Event
Repeats the event. See Recurring Events below.
Default: Off

The screenshot shows the monthly Board Meeting: the first Tuesday of each month, 6:00 to 7:30 PM.

Colors, Content and Links

Colors, Content and Links

The rest of the item's Content tab:

Event Color
Used for the event's dot, border, background and line, and for its modal header. Empty: the calendar's Default Event Color, or the theme's color.
Default: Empty
Text Color
The title color on filled events and in the modal header.
Default: Empty
Content
Text, images and links for the modal (with Show the content on). The search field also finds words in it.
Category
Groups events into rows (Timeline) or columns (Resource Time Grid). Spell it the same way on every item of the category.
Default: Events
Modal Image / Modal Image Alt
An image shown only inside the modal, with its alternative text.
Modal Icon
An icon shown only inside the modal. For an icon next to the title on the calendar, use Title Icon.
Link
A page, an image or a video file. Shown as a button in the modal, or opened directly when the modal is off.
Open the link in a new window
Opens this item's link in a new window or tab.
Default: Off
Link Text
The button text. Leave empty to use Settings > Link > Text.
Default: Empty

Recurring Events

Turn on Recurring Event to repeat an item. Its Start Date & Time is the first occurrence, and its End Date & Time sets how long each occurrence lasts.

Recurring Frequency
Hourly, Daily, Weekly, Monthly or Yearly.
Default: Weekly
Recurring Interval
Repeat every N periods: 2 with Weekly is every other week, 2 with Hourly is every two hours.
Default: 1
Recurring on Day(s)
Check Enable Recurring By Weekday(s), then one or more days from Monday to Sunday. The event repeats on those days. With Date Handling Accurate, it stays on them in every time zone.
Default: Off
Additional Recurring Options
For a Monthly or Yearly series with weekdays: 1st, 2nd, 3rd, 4th or 5th Time of the Month, or Last Time of the Month. A Yearly series counts in the month of its Start Date.
Default: None
Recurring End Date & Time
The last day the event repeats, included with Date Handling Accurate. Leave it empty to repeat with no end.
Default: Empty
Excluded Dates
Occurrences to skip, such as holidays. One date per line, format YYYY-MM-DD. On an Hourly series, a date skips every time on that day. Requires Date Handling Accurate.
Default: Empty

Tip: put the end of the series in Recurring End Date & Time. An End Date & Time as long as the repeat interval or longer is ignored.

Recurring Examples

  • Every Tuesday and Thursday: Weekly, Interval 1, Recurring on Day(s) with Tuesday and Thursday checked.
  • Every other Monday: Weekly, Interval 2, with a Start Date on a Monday.
  • First Tuesday of each month: Monthly, Tuesday checked, Additional Recurring Options 1st Time of the Month. The Board Meeting above uses this rule.
  • Last Friday of each month: Monthly, Friday checked, Last Time of the Month.
  • Fourth Thursday of November: Yearly, Thursday checked, 4th Time of the Month, with a Start Date in November.
  • Every day for one week: Daily, Interval 1, with the Recurring End Date & Time on the last day.
  • Every two hours: Hourly, Interval 2. Add a Recurring End Date & Time to stop the series.
  • Once a year: Yearly, Interval 1, for an anniversary or an annual event.
  • Skip holidays: add 2026-12-25 and 2027-01-01 to Excluded Dates, one per line.

Pick a Start Date that falls on one of the checked weekdays, so the first occurrence is the one you entered.

All-Day and Multi-Day Events

Check All Day Event for events without a time, such as holidays, festivals or deadlines.

  • One day: set the Start Date and leave End Date & Time empty, or use the next day.
  • Several days: the end date is exclusive. For an event from Friday to Sunday, set the End Date to Monday.
  • Timed events over several days: set the start and the end on different days, with their times.
  • Day grids (Month, Week, Day and Year) show all-day and multi-day events as bars and timed events as dots (Style > Events > Event Style: Auto).
  • Time grids show all-day events in a row at the top (Settings > Time Grid & Timeline > All-Day Slot). With the All-Day Slot off, time grids don't show all-day events.

With Date Handling Accurate, all-day events land on the entered day for every visitor, in every time zone.

Categories

Each item has a Category (default "Events"). Categories matter in the following views:

  • Timeline views show one row per category.
  • Resource Time Grid views show one column per category.
  • Items with an empty Category go to the row or column named in Settings > Premium Views (Timeline & Resource Time Grid) > Uncategorized Row Title (default "Other").
  • Style > Categories > Category Headers > Event Colors gives each category's header the color of its events.

Spell a category the same way on every item, for example "Studio A", and give its items the same Event Color. The search field also finds categories while Content > Display > Show the Category field is on.

Modals and Links

With Content > Modal/Links > Show the modal (sublayout) on, clicking an event opens a modal window. From top to bottom it shows:

  • Header in the event's Event Color, with the title in its Text Color
  • Sublayout: the elements you add in the item's Modal tab
  • Content from the item's editor
  • Modal Icon and Modal Image
  • Link as a button, with the item's Link Text
  • Footer with a Close button, when the item's Modal tab turns it on (off by default)

Hide parts with Show the content, Show the modal image/icon and Show the link. The size, padding and full screen mode are in Settings > Modal, the button in Settings > Link.

Links instead of modals: turn off Show the modal (sublayout) and keep Event link active on. Clicking an event then opens its link, in a new window when the item's Open the link in a new window or Settings > Link > Target is checked. Links can also start an email (mailto:), a phone call (tel:) or a calendar or map app (webcal:, geo:).

Events that open a modal or a link show the hand cursor. Closing a modal returns the keyboard focus to the event.

Modals and Links
The Item's Modal Tab

The Item's Modal Tab

Each item has its own Modal tab. Its settings show while Show the modal (sublayout) is on; otherwise the tab only shows a note that modals are not enabled:

Sublayout
Build the modal's content with any YOOtheme elements: text, images, buttons, maps or grids. It appears above the item's Content.
Modal Header
Header adds a header bar in the Event Color, Header Title shows the event title in it, and Show Close Icon adds a close icon in the corner.
Default: all on
Modal Footer
Footer with Show Close Button adds a footer with a Close button. The footer only appears when both are checked.
Default: Footer on, Show Close Button off
ID or Alias
The modal's ID. Automatically generated if left blank. Don't use spaces or special characters.

The header also needs Settings > Modal > Header Text enabled, which it is by default. The Close button text comes from Settings > Text & Labels > Close Button Text.

Modal Icon and Item Settings

Modal Icon and Item Settings

The item's Settings tab styles its Modal Icon. The fields become active once a Modal Icon is picked:

Modal Icon Color
None, Muted, Emphasis, Primary, Secondary, Success, Warning or Danger, from your YOOtheme style.
Default: None
Modal Icon Width
Width of the icon in pixels.
Default: 90
Modal Icon Alignment
Left, Center or Right.
Default: Center

The item's Advanced tab has Item ID and Item Classes: an ID and classes for the modal body, for your own CSS.

Title Icons

Title Icons put a small icon next to each event's title on the calendar, for example a location pin for outdoor events.

  • Open an item and click the pencil in Title Icon.
  • Pick a UIkit icon. With ZOOlanders Essentials installed, its icon collections appear in the picker too.
  • Choose the position for the whole calendar in Content > Title Icon: Before Title (default), After Title or Hidden.
  • Set Content > Title Icon Size in pixels, or leave it empty to match the title text.

The icon uses the event's text color. When a long title wraps, the icon stays with its first (or last) word. Where the days of a Month, Week or Year grid are narrower than 105 pixels (a calendar under about 735 pixels wide, e.g. on phones and in half-width columns), the grid leaves the icons out to give the titles room. Day View and the other views keep them. Items without a Title Icon are unchanged.

The Modal Icon is a separate field: it only appears inside the modal.

Dynamic Content

Calendar Pro works with YOOtheme's Dynamic Content. Fields marked Dynamic can be mapped to a source: the items' text, date, color, icon, image, link and select fields, their All Day Event and Recurring Event switches, and the calendar's text, color and select settings. The other on/off switches (such as the Recurring on Day(s) weekdays, the modal's header and footer, and Open the link in a new window), the Style tab's Title style, decoration, font family and color (Heading Level can be mapped), Toolbar Buttons, Hover and Category Headers options, and YOOtheme's General options can't be mapped.

  • Open an item and its Advanced tab.
  • Choose a source under Dynamic Content, such as Joomla articles or custom fields. With a source of multiple entries, the item repeats for each entry.
  • Map the Title, Start Date & Time, End Date & Time and any other fields.
  • Open the filters of every date field and set the Date Format to c (ISO 8601).

Sources from other extensions work too, such as the Google Calendar source of ZOOlanders Essentials (a paid add-on, not part of Calendar Pro).

Dates in the site language or with a zone such as UTC, GMT or +01 are read too, but c is the safest format. Checkbox values such as "FALSE", "No", "off" or "0" count as off.


4. Calendar Settings

Calendar

Calendar

Settings > Calendar sets the language, time zone, views and starting date:

Locale
The language and date format. Labels you leave empty follow it, using FullCalendar's 80+ translations, right-to-left languages included.
Default: English (United States)
Time Zone
Local: each visitor sees the times in their own time zone. Joomla Site Time Zone, UTC or a named zone: everyone sees the times of that zone (best for venues).
Default: Local
Date Handling
Accurate (Recommended) or Legacy (v1.4 compatible). See Views, Dates and Time Zones.
Default: Accurate (new calendars)
Default View
The view the calendar opens with.
Default: Month View
Mobile View
The view used on screens narrower than the Mobile Breakpoint.
Default: List
Mobile Breakpoint
Screen width in pixels below which the Mobile View is used. Save and reload the page to see a change.
Default: 660
Calendar Height
auto, or a size such as 800px, 50em or 80vh.
Default: auto
Start Date
The date the calendar opens on. Leave empty to open on today.
Default: Empty
Ignore Past Dates
Show today's date if the Start Date has passed. Useful for a calendar set to a future event.
Default: Off
First Day of the Week
Sunday to Saturday.
Default: Sunday
Show Weekends
Show the Saturday and Sunday columns in all views.
Default: On
Week Numbers
Shown in Month view and in the corner of Time Grid views.
Default: Off
Clickable Dates
Day numbers, column headers and list day headings link to that day. Off: dates are plain text.
Default: On
Clicked Date Opens
The view a clicked date opens: List Day, Day Grid or Time Grid Day.
Default: List Day
“Today” Comes From
Server Time or Visitor's Browser. Use the browser clock if your pages are cached.
Default: Server Time
Debug Date/Time
Shows the server date and time Calendar Pro uses, only in the customizer and to administrators. Turn it off when you are done.
Default: Off

Events

Settings > Events sets how times and busy days show:

Event Time Format
12 Hour Time Format or 24 Hour Time Format.
Default: 12 Hour Time Format
End Times
Also show end times in month, week and day grids. Time grids, timelines and lists always show them.
Default: Off
Events Per Day
Limits the events per day in month and week grids. The others go behind a "+ more" link that opens a popover. Auto (fit the cell) shows as many as fit, or pick a number from 1 to 10.
Default: No Limit

The Events group is at the bottom of the Calendar screenshot above.

Date Range

Date Range

Settings > Date Range limits which dates visitors can browse:

Past Event Items
Always Show Past Events: visitors can go back to past events. Turned off, visitors can't browse back past the Limit Start Date. Without one, they stop at today (with Hide Past Events From Today) or at the Start Date (or today).
Default: On
Limit Start Date
The earliest date visitors can navigate to. Available while both past-event options are off.
Default: Empty
Hide Past Events From Today
Hides all events before today. Available while Always Show Past Events is off and Limit Start Date is empty.
Default: Off
Limit End Date
How far ahead of today the calendar goes: None, 1 Week, 2 Weeks, 1 Month, 3 Months, 6 Months, 1 Year or 2 Years.
Default: None
Custom End Date
Pick a fixed last date instead, in the Limit End Date field that appears. With Date Handling Accurate, that day is included.
Default: Off
Max Events To Show
The most events a list view shows (a total per view). Leave empty for no limit.
Default: 100

Visitors can't navigate past these limits, and days outside them show no events.

Header Toolbar

Header Toolbar

Settings > Header Toolbar sets the title and buttons above the calendar:

Toolbar Layout
Title Left, Buttons Right; Title Centered, Buttons Right; or Navigation Left, Title Center, Views Right. A centered title gets its own line when there is no room, and button rows that don't fit wrap.
Default: Title Left, Buttons Right
Navigation
Previous Year, Previous, Next, Next Year and Today buttons.
Default: Previous and Next on
View Buttons
One button per view: Month, Week, Day, Year, Multi-Month Year, Time Grid Week, Time Grid Day, List (Day), All Events (By Week), All Events (By Month), All Events (By Year), Timeline (Day), Timeline Week, Timeline Month, Resource Time Grid (Day) and Resource Time Grid Week. Rename them under Text & Labels.
Default: all off
Day Button Opens
The view the Day button shows: List Day, Day Grid (v1.x), Time Grid Day, Timeline Day or Resource Time Grid Day.
Default: List Day
Tools
Print Button prints only this calendar, laid out for paper. Search Field filters the events by title, category and content.
Default: both off

Without view buttons, the calendar stays in its Default View (or the Mobile View on phones). Clickable dates can still open a single day.

Month, Week, Day and Multi-Month Views

Month, Week, Day and Multi-Month Views

These groups appear when their view is used, as a view button, the Default View or the Mobile View:

Month Title Format
September, September 2024, Sep 1 - 30, 2024, 09/01/24 - 09/30/24 or 09/2024.
Default: September 2024
Fixed Weeks
Fixed Week Count (6 Rows): every month shows six weeks. Off: as many weeks as the month needs.
Default: On
Non Current Dates
Show days from the previous and next month. Off: those days stay empty and show no events.
Default: On
Week Title Format
The title of Week View.
Default: Sep 1 - 30, 2024
Day Title Format
The title of Day View, also used by the Day button.
Default: Thursday, September 19, 2024
Max Columns
Multi-Month Year View: how many months sit side by side, 1 to 4.
Default: 3

The formats show sample dates. Your calendar shows its own dates, in the language of the selected Locale.

Time Grid & Timeline

Time Grid & Timeline

Settings > Time Grid & Timeline sets the hours and slots of the time grid and timeline views:

Time Grid Title Format
The title of the Time Grid views.
Default: Thursday, September 19, 2024
Show Time
Show the time in time grids even when Content > Display > Show the time is off.
Default: Off
All-Day Slot
Show all-day events in a row at the top of Time Grid views. Off: time grids don't show all-day events.
Default: On
Timeline Title Format
The title of the Timeline views.
Default: Thursday, September 19, 2024
Show Time
The second Show Time, below Timeline Title Format: show the time in timelines even when Show the time is off.
Default: Off
Start Time
The first time shown, for example 7:00 AM.
Default: Empty (from midnight)
End Time
The last time shown. An end time at or before the Start Time, such as 12:00 AM, is on the next day.
Default: Empty (until midnight)
Time Slot Increments
The length of each time slot, from 5 minutes to 24 hours.
Default: 1 Hour
Initial Scroll Time
Time grid and timeline views scroll to this time on load.
Default: Empty
Now Indicator
Show a line at the current time.
Default: Off
Business Hours
Shade the hours outside business hours, Monday to Friday. Set the hours with Business Hours Start and Business Hours End.
Default: Off (9:00 AM to 5:00 PM when left empty)

List Views

Title formats of the list views. Each group appears when its view is used:

List Title Format
List (Day), one day's events. Also used when a clicked date opens List Day.
Default: Thursday, September 19, 2024
All Events (By Week) Title Format
The week's events as a list.
Default: Sep 1 - 30, 2024
All Events (By Month) Title Format
The month's events as a list.
Default: September 2024
All Events (By Year) Title Format
The year's events as a list.
Default: January – December 2024

Lists without events show the No Events text (Text & Labels). Settings > Date Range > Max Events To Show limits how many events a list shows.

Text & Labels

Text & Labels

Settings > Text & Labels renames the buttons and messages. Each button's label field appears once the button is turned on. Most labels can be left empty to use the locale's own word.

Today Label
The Today button.
Default: Today
Month, Week and Day Labels
The Month, Week and Day buttons.
Default: Month, Week, Day
Year and Multi-Month Year Labels
The Year and Multi-Month Year buttons.
Default: Year, Multi-Month
Time Grid Week and Time Grid Day Labels
The Time Grid buttons.
Default: Time Grid Week, Time Grid Day
List (Day) Label
The List (Day) button.
Default: List
All Events (By Week), (By Month) and (By Year) Labels
The All Events buttons.
Default: All Events This Week, All Events This Month, All Events This Year
Timeline (Day), Timeline Week and Timeline Month Labels
The Timeline buttons.
Default: Timeline, Timeline Week, Timeline Month
Resource Time Grid (Day) and Resource Time Grid Week Labels
The Resource Time Grid buttons.
Default: Time Grid, Resource Week
Print Label
The Print button.
Default: Print
Search Placeholder Text
The hint in the empty search field.
Default: Search...
No Events Text
Shown in list views when there are no events.
Default: No Events
All-Day Text
The all-day label in time grids and lists.
Default: Empty (the locale's word)
Close Button Text
The modal's Close button and close icon label.
Default: Close
Modal Window

Modal Window

Settings > Modal Window (Sublayout Component) and Settings > Modal set the size and spacing of every event modal of this calendar:

Modal
Show modal window settings shows the settings below. Modals open when Content > Show the modal (sublayout) is on.
Default: On
Margin Top
Space above the item's Content in the modal: Keep existing, Small, Default, Medium, Large, X-Large or None.
Default: Keep existing
Header Text
Enable the modal headers. Each item's Modal Header must be on too.
Default: On
Width/Height
The width of the modal and the height of its content, for example 800 (pixels), 800px, 80vw or 60vh. Leave empty for auto.
Default: Empty (auto)
Full Screen
Opens the modals over the whole screen.
Default: Off
Padding
Space around the modal content: Small, Default, Large or None.
Default: Default

Link

Settings > Link styles the link button in the modals and sets where links open:

Target
Open in a new window: every event link opens in a new window or tab.
Default: Off
Text
The link text of items without their own Link Text.
Default: Learn More
Style
Button Default, Button Primary, Button Secondary, Button Danger, Button Text, Link, Link Muted or Link Text.
Default: Button Default
Button Size
Small, Default or Large, for the Default, Primary, Secondary and Danger buttons.
Default: Default
Full width button
The button fills the width of the modal.
Default: Off
Margin Top
Space above the link: Small, Default, Medium, Large, X-Large or None.
Default: Default

The General group that follows has YOOtheme's standard position, margin, max width, alignment, animation and visibility options.


5. Style

Theme and Color Scheme

Style > Theme sets the calendar's look. Each calendar on a page can use its own theme.

Calendar Theme
Website Style takes its colors, buttons and title font from your YOOtheme style, including inverse (dark) sections. UIkit 3 uses UIkit's default look. Classic is the 1.x look, and Classic Dark Blue the 1.x Dark Blue. Monarch (Material Design), Forma (Fluent UI), Breezy (Tailwind) and Pulse (Minimal) bring their own look and color palettes. Bootstrap 5, Flatly and Minty are kept for 1.x calendars and use Classic.
Default: Website Style
Color Palette
Monarch: Purple, Blue, Green, Red or Yellow. Forma: Blue, Green, Purple or Red. Breezy: Indigo, Amber, Emerald or Rose. Pulse: Blue, Green, Purple or Red.
Default: Purple (Monarch), Blue (Forma), Indigo (Breezy), Blue (Pulse)
Color Scheme
Light, Dark, or Auto (Visitor Setting), which follows each visitor's system setting. With Website Style, Dark uses your style's inverse colors.
Default: Light

Website Style keeps text readable on your site's colors. For example, events with a dark Event Color get white text when your style's buttons use dark text, and muted text, grid lines and disabled buttons stay visible in dark sections.

Theme and Color Scheme
Title

Title

Style > Title styles the date title in the toolbar. Style, Decoration, Font Family and Color are available with Website Style and UIkit 3. Heading Level works with every theme.

Style
The headline styles of your YOOtheme style: Heading 3X-Large to Heading Small, Heading H1 to H6, Text Meta, Text Lead, Text Small or Text Large. None keeps the theme's title.
Default: None
Decoration
None, Divider or Bullet.
Default: None
Font Family
None, Default, Primary, Secondary or Tertiary. Not every style has different font families.
Default: None
Color
None, Muted, Emphasis, Primary, Secondary, Success, Warning or Danger.
Default: None
Heading Level
The heading level of the title for screen readers: H1 to H6.
Default: H2

Toolbar Buttons

Style > Toolbar Buttons uses your style's button styles. It is available with Website Style and UIkit 3.

Style
Default, Primary, Secondary, Danger or Text.
Default: Default
Active Style
The button of the view shown: Primary, Default, Secondary, Danger or Text. With Color Scheme Dark, or in a dark section, Primary and Secondary look alike: pick Default or Danger for one of them.
Default: Primary
Size
Small, Medium or Large.
Default: Small
Events

Events

Style > Events sets how the events look:

Event Style
How events are drawn in day grid views. Auto: a dot for timed events, a bar for all-day and multi-day events. Dot: every event as a dot (a multi-day event only on its first day). Block (Filled): every event as a filled bar.
Default: Auto
Event Line
A colored line above the title instead of a dot, in Month and Week views.
Default: Off
Long Titles
Wrap long titles (off: cut them short). See Long Titles below.
Default: On
Default Event Color
Used for events that don't set their own Event Color.
Default: Empty (the theme's color)
Event Text Color
Text color of filled (block) events. Dot events use the theme's text color.
Default: Empty

Long Titles

Style > Events > Long Titles decides what happens to titles that don't fit. It is on by default:

  • Month, Week, Day and Year grids: the time and the title flow like a sentence, and the title wraps onto more lines. Text never runs into the next day: a word too long for its day breaks onto the next line, or is cut at the event's edge where the days are narrow (e.g. on phones and in half-width columns) and where a Title Icon is joined to it.
  • Time Grid and Resource Time Grid views: the event keeps its layout and the title wraps inside it. A short event shows the lines that fit.
  • Timeline views: the title wraps to two lines at most.
  • Multi-Month Year: titles stay on one line.
  • List views: titles are always shown whole.

Turned off, titles stay on one line and are cut short at the edge of the event. Turn on Style > Hover > Tooltip to show the full title when visitors point at an event.

A Title Icon stays with the first (or last) word of a wrapped title.

Hover Effects

Style > Hover adds an effect when the mouse is over an event. Keyboard focus shows the same effect. The event comes to the front of the others; list views stay still.

Effect
None, Zoom, Zoom with Shadow, Lift, Glow (a ring in the event's color) or Brighten.
Default: None
Zoom Size
Small (5%), Medium (10%) or Large (15%), for the two Zoom effects. An event with no room to grow that much, for example one as wide as the calendar, grows less.
Default: Medium (10%)
Speed
Fast, Normal or Slow.
Default: Normal

A zoomed event grows away from the column headers and the scrolling edges, so it isn't cut off. Lift only rises where there is room above.

Hover Effects

Focus

Style > Hover > Focus (Dim the other events while one is pointed at) fades the other events, so the event under the mouse stands out. Every piece of a multi-day event stays bright.

Focus works with or without an Effect. The screenshot shows Lift with Focus and the Tooltip on a class schedule.

Default: Off

Focus

Tooltip

Style > Hover > Tooltip (Show the time and full title) shows both in your site's UIkit tooltip when visitors point at an event, also when the title is cut short.

  • Not in list views, which show the titles whole.
  • Not on touch screens, where a tap opens the event.
  • Works in right-to-left languages too.

Default: Off

Tooltip
Calendar Grid

Calendar Grid

Style > Calendar Grid:

Today Color
Background color of today's date. Leave empty for no highlight. Website Style and UIkit 3 use a light tint of the primary color, and Monarch, Forma, Breezy and Pulse their own today style, unless you pick another color here.
Default: #ffdc2826 (light yellow)
Border
Remove the outer border of the calendar.
Default: Off

Categories

Style > Categories appears when a Timeline or Resource Time Grid view is used.

Category Headers
Default, or Event Colors: each category's header takes the Event Color and Text Color of its first item that has an Event Color (else the calendar's Default Event Color), with readable text.
Default: Default

Give the items of a category the same Event Color, so its header matches its events. The screenshot shows a Resource Time Grid with one column per room.

Categories

Custom CSS

Add your own CSS in the element's Advanced > CSS field. Start selectors with .el-element: YOOtheme prefixes it for this element automatically.

  • Calendar Pro classes start with mdcp-, for example .mdcp-resource-header for the category headers.
  • FullCalendar class names from 1.x still work: fc-event, fc-event-title, fc-toolbar-title, fc-button, fc-day-today and more.
  • Modal bodies: each item's Advanced > Item ID and Item Classes add an ID and classes to its modal body.

Example: .el-element .fc-event-title { font-weight: bold; }

Try the Style tab first: titles, buttons, colors and hover effects no longer need CSS.


6. Views, Dates and Time Zones

Month, Week, Day and Year Views

Day grids show the days as boxes with the events inside:

  • Month View: the classic month calendar.
  • Week View: one week as seven day boxes.
  • Day View: one day as a day grid. The Day button can open it, or another day view (Day Button Opens).
  • Year View: the whole year as one grid of weeks.
  • Multi-Month Year View: the twelve months as small calendars, up to four side by side (Max Columns).

Timed events show as dots with their time, all-day and multi-day events as bars (Style > Events > Event Style). Use Events Per Day to keep busy days tidy.

Month, Week, Day and Year Views

Time Grid Views

Time Grid Week and Time Grid Day show the hours down the side, and each event as a block as long as the event. They suit class schedules and bookings.

  • Set the hours with Start Time and End Time, and the rows with Time Slot Increments (Settings > Time Grid & Timeline).
  • All-day events sit in a row at the top (All-Day Slot).
  • Business Hours shades the hours outside your opening times, Monday to Friday.
  • Now Indicator draws a line at the current time.
  • Week Numbers show in the corner.

The screenshot shows a class schedule from 7 AM to 10 PM in 30-minute slots, with business hours and a week number.

Time Grid Views
List Views

List Views

List views show the events under day headings, with their full titles. They work well on phones.

  • List (Day): one day's events
  • All Events (By Week): the week's events
  • All Events (By Month): the month's events
  • All Events (By Year): the year's events

A list without events shows the No Events text. Settings > Date Range > Max Events To Show limits how many events a list shows (100 by default).

Timeline and Resource Time Grid

These views show each Category as its own row or column, for rooms, staff, courts or equipment:

  • Timeline Day, Week and Month: one row per category, with the time running from left to right. Timeline Month shows one column per day.
  • Resource Time Grid Day and Week: one column per category, with the hours down the side.

Events without a Category go to the Uncategorized Row Title row ("Other"). Style > Categories > Category Headers > Event Colors colors each header.

Timeline and Resource Time Grid
Mobile View

Mobile View

Phones get their own view. Below the Mobile Breakpoint (660 pixels by default), the calendar opens in the Mobile View instead of the Default View. Both are in Settings > Calendar.

  • The default Mobile View is List: one day's events, easy to read on a small screen. Pick All Events (By Week) to show a week at a time, as in the screenshot.
  • The view is chosen when the page loads. Save and reload the page to see a change.
  • Toolbar buttons that don't fit wrap onto more rows.
Events Per Day

Events Per Day

Settings > Events > Events Per Day keeps busy days tidy in month and week grids. Days with more events show a "+ more" link, such as "+1 more". Clicking it opens a popover with all of that day's events.

  • No Limit (default): every event shows and the day grows.
  • Auto (fit the cell): as many events as fit.
  • 1 to 10: a fixed number per day.

The popover keeps the calendar's theme and colors, and the hover effects work in it too.

Search and Print

Turn on the tools in Settings > Header Toolbar > Tools:

  • Search Field: a search box in the toolbar. As visitors type, the calendar only shows the events whose title, category or content match. It only searches text the calendar can show: the category while Show the Category field is on, and the content while the modal shows it.
  • Print Button: prints only this calendar, in its current view. The rest of the page is left out: the header, menus, other sections, and the headings, text and columns beside the calendar. FullCalendar lays the calendar out for paper, a portrait page wide: every event of the view is printed (no "+ more" link), also with a fixed Calendar Height.

On a page with one calendar, the browser's own print command (Ctrl+P or Cmd+P) prints just the calendar too. Change the placeholder and the button text under Text & Labels.

Search and Print

Date Handling

Settings > Calendar > Date Handling decides how Calendar Pro reads your dates:

Accurate (Recommended)
All-day events land on the entered day. Times without an offset are read in the calendar's time zone (in Joomla's Website Time Zone when Time Zone is Local). Recurring events keep their weekday, length and end date. Excluded Dates only work in this mode.
Default for new calendars
Legacy (v1.4 compatible)
Keeps the dates and times of calendars saved with 1.x: times without an offset are read as UTC. Recurring events now show their full length.
Kept by calendars saved with 1.x

The Recurring End Date and a Custom End Date are only included with Accurate. Switching a calendar to Accurate can move some events, so check its all-day and recurring events afterward.

Time Zone

Settings > Calendar > Time Zone decides whose clock the calendar shows:

Local (Default)
Each visitor sees the times in their own time zone. Good for online events: a 7:00 PM webinar in Chicago shows as 8:00 PM in New York.
Joomla Site Time Zone
Everyone sees the times of Joomla's Website Time Zone (System > Setup > Global Configuration > Server).
A named zone, such as America/Chicago
Everyone sees the times of that zone. Best for venues and in-person events: a 7:00 PM class shows as 7:00 PM for every visitor.
UTC
Everyone sees UTC times.

Times you enter without an offset are read in the calendar's time zone, or in Joomla's Website Time Zone when Time Zone is Local. With Date Handling Accurate, recurring events keep their clock time in that zone across daylight saving changes.

“Today” Comes From

Settings > Calendar > “Today” Comes From decides which clock sets today's date. It is used for the today highlight, Ignore Past Dates, Hide Past Events From Today and a relative Limit End Date (such as 3 Months).

Server Time (Default)
Your server's clock, as in 1.x. Right for pages that are built fresh for every visit.
Visitor's Browser
The visitor's own clock. Use it when your pages are cached by a page cache or a CDN: a cached page would otherwise keep the day it was cached.

With Time Zone Local, today is the visitor's own day.

Dates from YOOtheme's Date Picker

YOOtheme's date picker saves each date and time in UTC, converted by your browser. Calendar Pro reads them back like this:

  • In Joomla's Website Time Zone (System > Setup > Global Configuration > Server).
  • While that is left at UTC (Joomla's default), in the time zone each date was picked in. Calendar Pro records it when you save the layout.

So all-day items, Recurring End Dates and Excluded Dates land on the days you entered, for every visitor, and weekly times stay put across daylight saving changes.

Tip: set Joomla's Website Time Zone to the zone you enter your events in. Dates from Dynamic Content are not affected: they keep their own offset, or are read in the calendar's time zone (Joomla's Website Time Zone when Time Zone is Local).

Debug Date/Time

Turn on Settings > Calendar > Debug Date/Time (Show Server Time) to see the dates Calendar Pro works with. A box above the calendar shows:

  • Server Time, Joomla Time and Browser Time
  • Calendar Time Zone, and the zone where dates without an offset are read
  • Date Handling: Accurate or Legacy

With modals on, each event's modal also shows its saved start and end and how they were read. With Date Handling Accurate and Joomla's Website Time Zone left at UTC, it also shows the zone the dates were picked in.

Visitors never see it: the box only shows in the YOOtheme customizer and to signed-in administrators. Turn it off when you are done.


7. Troubleshooting / FAQs

The calendar doesn't show

Checklist:

  • The plugin is enabled: System > Manage > Plugins > System - Calendar Pro Element for YOOtheme Pro.
  • YOOtheme Pro is version 4.0 or newer.
  • The element isn't disabled or hidden: check its Status in the Advanced tab and Visibility in Settings > General.
  • Clear Joomla's cache (System > Maintenance > Clear Cache) and any page cache or CDN.
  • Open the browser console (F12) and look for messages that start with [Calendar Pro].

Page elements with the ID "exports" or "Temporal", AMD loaders and other extensions that load an older FullCalendar no longer break the calendar in 2.0.

The calendar shows, but events are missing? Each item needs a Start Date & Time. Also check Settings > Date Range: days outside its limits show no events.

Changes don't show after an update

Cause: an old copy of Calendar Pro's CSS or JavaScript is still cached by the browser, a CDN (such as Cloudflare) or a page cache. New settings then seem to do nothing, for example Long Titles or the hover effects.

Solution:

  • Purge your page cache and CDN once.
  • Clear Joomla's cache: System > Maintenance > Clear Cache.
  • Reload the page without the browser cache: Ctrl+Shift+R, or Cmd+Shift+R on a Mac.

Since 2.0, every CSS and JavaScript URL ends in the version and a checksum of the file, so later updates load the new files on their own. Only a cache that stores whole HTML pages still needs a purge after an update.

Event times are off by some hours

Checklist:

  • Settings > Calendar > Time Zone: Local shows each visitor their own time. For a venue, pick its zone (for example America/Chicago) so everyone sees the same times.
  • Settings > Calendar > Date Handling: use Accurate. Legacy reads times without an offset as UTC.
  • Joomla's Website Time Zone (System > Setup > Global Configuration > Server): set it to the zone you enter your events in.
  • Dynamic Content: set the Date Format filter of each date to c, so the date keeps its offset.
  • Turn on Debug Date/Time to see the server time, the calendar's zone and how each event's dates were read.

An all-day event ends a day early

Cause: for all-day events, the End Date is exclusive: the event ends when that day begins.

Solution: set the End Date to the day after the last day. A Friday-to-Sunday event ends on Monday. For a one-day event, leave End Date & Time empty.

With Date Handling Accurate, all-day events land on the entered day for every visitor. Legacy date handling (calendars from 1.x) doesn't always do that: switch the calendar to Accurate.

Events of other months are missing in Month view

Cause: Settings > Month View > Non Current Dates is off. The days of the previous and next month are then left empty and show no events.

Solution: check Show days from the previous and next month. Turn on Fixed Weeks as well if every month should show six weeks.

Also check Settings > Date Range: days before the Limit Start Date or after the Limit End Date show no events.

Event titles are cut short

Solution: turn on Style > Events > Long Titles (Wrap long titles). It is on by default.

  • Titles wrap in Month, Week, Day and Year grids, in time grids, and in timelines (two lines at most).
  • Multi-Month Year keeps titles on one line. List views always show them whole.
  • A short event in a time grid only has room for its first lines. A smaller Time Slot Increment gives it more room, and Style > Hover > Tooltip shows the full title.
  • No change after an update? An old cached stylesheet may still be in use: see "Changes don't show after an update".

Updates are not offered

Checklist:

  • Enter your Download ID in System > Manage > Plugins > System - Calendar Pro Element for YOOtheme Pro and click Save (Calendar Pro 2.0 and later).
  • Open System > Update > Update Sites. If Calendar Pro Element for YOOtheme Pro shows The Download Key is missing, open it and enter the key in Download Key.
  • Check that this Update Site is enabled.
  • Go to System > Update > Extensions and click Check For Updates.

Get your Download ID at moderndesigns.studio/account/api-keys. You can always install a new version by uploading its zip over the old one.

A 1.x calendar looks different

Calendars saved with 1.x keep their theme, Legacy date handling and their Day button. If one looks different after the update:

  • Bootstrap 5, Flatly or Minty theme: these now use Classic. They looked like the standard theme before.
  • Category header CSS: selectors such as .fc-col-header-cell:nth-child(2) no longer match. Use Style > Categories > Category Headers > Event Colors, or .mdcp-resource-header and .fc-resource.
  • Recurring events look longer: they now show their full length, from start to end. 1.x showed every repeat one hour long (one day for all-day events).
  • jQuery or Bootstrap CSS: Calendar Pro no longer loads them. If other parts of your page relied on that, load them another way.
  • A fresh look: pick Style > Theme > Calendar Theme > Website Style to match your YOOtheme style, and switch Date Handling to Accurate (then check the events).

Dates from Dynamic Content are wrong

Checklist:

  • Open the filters of each mapped date (Start Date & Time, End Date & Time, Recurring End Date & Time) and set the Date Format to c (ISO 8601). This keeps the time and its offset.
  • Every entry needs a start date: items without one are skipped.
  • For all-day events, map the All Day Event checkbox too. Values such as "FALSE", "No", "off" or "0" count as off.
  • Times look shifted? See "Event times are off by some hours" and turn on Debug Date/Time.

A recurring event repeats on the wrong days

Checklist:

  • Weekdays ignored: check Enable Recurring By Weekday(s) under Recurring on Day(s), then the days.
  • 1st to 5th or Last Time of the Month ignored: these only work for Monthly or Yearly series with weekdays checked.
  • Excluded Dates ignored: they need Date Handling Accurate, and one date per line as YYYY-MM-DD.
  • The last day is missing: the Recurring End Date is only included with Date Handling Accurate.
  • Each occurrence has the wrong length: End Date & Time is the end of the first occurrence and sets the length of every occurrence. A length as long as the repeat interval or longer is ignored: put the end of the series in Recurring End Date & Time.

How do I print the calendar?

Turn on Settings > Header Toolbar > Tools > Print Button. It prints only this calendar, in its current view.

  • The rest of the page is left out: the header, menus, other sections, and the headings, text and columns beside the calendar.
  • FullCalendar lays the calendar out for paper, a portrait page wide: every event of the view is printed (no "+ more" link), also with a fixed Calendar Height.
  • On a page with one calendar, the browser's print command (Ctrl+P or Cmd+P) prints just the calendar too.
  • Hover effects are switched off on paper.
  • Rename the button with Settings > Text & Labels > Print Label.

Tip: open the view you want on paper first, for example All Events (By Month) for a printable list.


Josh Gilson

Need Help?

Something not working or quick question?
Email me: This email address is being protected from spambots. You need JavaScript enabled to view it.

Join our community for quick help on our
Discord Server