Configuring the Calendar Widget
Use the Calendar widget configuration options to tailor the display and functionality of your calendar. From choosing the time format and default view to setting the week start day and time zone, users can configure various aspects to suit their preferences.
To configure the Calendar widget,
-
Start editing the page where the Calendar widget has been deployed.
-
Click Options (
) in the widget header → Configuration.NoteBefore Liferay DXP 2025.Q1, the Configuration option appeared in the widget’s top-right corner.
-
Select a tab under Setup: User Settings, Display Settings, or RSS.
To learn more about the Sharing tab, read Sharing Widgets with Other Sites.
-
Configure your widget and click Save.
User Settings
From the User Settings tab, customize the calendar’s default view and settings. Here are the available options:
Time Format: Choose Locale, AM/PM, or 24 Hour as the default time format.
Locale is a dynamic setting that chooses whether to display the time in AM/PM or a 24-hour format, based on the preferences set by the user’s locale. AM/PM displays times such as 8 AM or 11 PM. The 24-hour time format displays times such as 08:00 and 23:00.
Default Duration: Sets the event’s default duration.
When you add a new event to the calendar, the time you set here specifies how long events last by default.
Default View: Choose Day, Week, Month, or Agenda as the default view for the calendar.
This sets the default for when the calendar is first displayed, but the view can be changed by clicking the appropriate button at the top-right of the widget.
Week Starts On: Choose Sunday, Monday, or Saturday as the week’s start day.
Time Zone: Choose a time zone or check the Use Global Time Zone box.
If you check Use Global Time Zone, the time displayed depends on whether it’s being viewed by a logged-in user or a guest.
If a user is logged in, the calendar displays events using the time zone set for the user in the User Personal Menu → Account Settings → Preferences → Display Settings → Time Zone.
If the calendar is viewed by a guest or a user who is not logged in, the calendar displays events using the time zone set by the portal administrator in Control Panel → Configuration → Instance Settings → Platform → Localization → VIRTUAL INSTANCE SCOPE → Time Zone.
Display Settings
From the Display Settings tab, set how the Calendar widget appears. Here are the available options:
Display Scheduler Only: By default, the list of calendars and a mini-calendar view appear.
Check this to display only the scheduler (i.e., the large calendar view showing the calendar and scheduled events).
Display User Events: Turns off the display of the current, logged-in user’s calendar and events.
Display Scheduler’s Header: If disabled, it removes the ability to toggle through the calendar views and access to the Add Event button.
Enabled Views: If one of the available views is disabled it disappears from the scheduler’s header.
Maximum Days to Display: Set the maximum number of days to display in the agenda view.
Maximum Events to Display: Set the maximum number of events to display in the agenda view.
RSS
Use the RSS tab to enable/disable the RSS subscription and configure the RSS behavior.
Maximum Items to Display: Set the maximum number of items to display in the RSS feed. The value ranges from 1 to 100.
Display Style: Display the Abstract, Full Content, or Title of the event in the RSS feed.
Format: Use Atom 1.0, RSS 1.0, or RSS 2.0 as the default format.
Time Interval: Update the RSS feed every Week, Month, or Year.