This is just a list as I hit them of things you need to check and adjust during your migration.
The first day of the week now starts at 0 for Sunday through 6 for Saturday. You will need to check your vis options for first week day.
For most locations a startDay should be 0. There are some locales where this is different, such as Germany where the calendar normally starts on Monday. In these cases set the startDay to 1 for sunday. We have not tested other start days extensively so if you run into problems let us know.
The new FC replaces the moment library with Luxon. As a result you will need to change the FC Time Format on your vis options page to the Luxon format. See here: https://moment.github.io/luxon/#/formatting?id=table-of-tokens Also, if you have any javascript for the calendar that uses the moment library you will need to revise them to use the Luxon library. It is not all that difficult but the format and function calls for getting/setting and math have change. Please review this: https://moment.github.io/luxon/#/moment for details of required changes.
A couple of other notes about Luxon and FullCalendar.
The week view start and end time formats have changed. They are now in the format of HH:MM:SS starting at 00:00:00 to 23:59:59
While we are on the topic of Dates and Times. Full Calendar operates based on the TimeZone of the Joomla system that is running it. This means that if the J! system has a timezone of Europe/Zurich, all the times shown to the user anywhere in the world are in Zurich time, not the local time of the user displaying the calendar. This may be confusing to some so ensure you understand this and place a notice somewhere so you users understand this. A good place would be the visualization introduction.
Many FullCalendar options have changed from V3. These are the option you might include in the Full Calendar Options on the Options tab. You can review this: https://fullcalendar.io/docs/v4/upgrading-from-v3 for any that you are using and need to adjust.
You must open and save your full calendar visualization in the admin as some options have changed and there are some new options.
We have adjusted the event colors, the original color option is now the background color of the event, and a new title color option defines what color the event text will be. This will be very important if you choose a very dark background as you will need a light text color.
The first day of the week now starts at 0 for Sunday through 6 for Saturday. You will need to check your vis options for first week day.
For most locations a startDay should be 0. There are some locales where this is different, such as Germany where the calendar normally starts on Monday. In these cases set the startDay to 1 for sunday. We have not tested other start days extensively so if you run into problems let us know.
The new FC replaces the moment library with Luxon. As a result you will need to change the FC Time Format on your vis options page to the Luxon format. See here: https://moment.github.io/luxon/#/formatting?id=table-of-tokens Also, if you have any javascript for the calendar that uses the moment library you will need to revise them to use the Luxon library. It is not all that difficult but the format and function calls for getting/setting and math have change. Please review this: https://moment.github.io/luxon/#/moment for details of required changes.
A couple of other notes about Luxon and FullCalendar.
- They have different numbering for the days of the weeks. As stated above, for FC, the numbering is 0-6 with 0 for Sunday. With Luxon the is 1-7 with 1 for Sunday. Keep that in mind for your custom code.
- FC internally uses Javascript DateTime objects. You can easily convert these to luxon DateTime using the fromJSDate function.
The week view start and end time formats have changed. They are now in the format of HH:MM:SS starting at 00:00:00 to 23:59:59
While we are on the topic of Dates and Times. Full Calendar operates based on the TimeZone of the Joomla system that is running it. This means that if the J! system has a timezone of Europe/Zurich, all the times shown to the user anywhere in the world are in Zurich time, not the local time of the user displaying the calendar. This may be confusing to some so ensure you understand this and place a notice somewhere so you users understand this. A good place would be the visualization introduction.
Many FullCalendar options have changed from V3. These are the option you might include in the Full Calendar Options on the Options tab. You can review this: https://fullcalendar.io/docs/v4/upgrading-from-v3 for any that you are using and need to adjust.
You must open and save your full calendar visualization in the admin as some options have changed and there are some new options.
We have adjusted the event colors, the original color option is now the background color of the event, and a new title color option defines what color the event text will be. This will be very important if you choose a very dark background as you will need a light text color.
Last edited: