Installation
Installing JT | GCalendar is simple. From your Joomla! backend, navigate to System -> Install -> Extensions. Then, drag and drop the downloaded package file, or use the "Upload Package File" option.
Configuration
To set up the module, go to Content -> Site Modules and click the "New" button. Select "JT | GCalendar" from the list to create a new module instance.
Basic Settings
This tab contains the core settings for fetching and displaying events.
- Total number of events: The maximum total number of upcoming events to retrieve from all calendars combined. Make sure this value is higher than the "Initial number of events" to allow the "Load More" button to function.
- Initial number of events: How many events to display when the module first loads on the page.
- Events to load per click: The number of additional events to show each time the "Load More" button is clicked.
- Caching: Controls the caching behavior.
- Use Global: Follows the main Joomla caching configuration.
- Force Yes: Enables caching for this module, even if global caching is off. Useful for optimizing performance on high-traffic pages.
- No Caching: Never caches the event data. Recommended only during development.
- Cache Time: The duration in minutes for which the event data should be cached.
- Debug Mode: If enabled, the module will display useful debugging information on the frontend, such as caching status and execution times.
Calendar Sources
This is where you add the iCalendar (.ics) feeds you want to display events from.
- ICS Calendar URLs: Use this repeatable field to add one or more calendar sources.
- ICS Calendar URL: The public iCalendar (.ics) link from your calendar service (e.g., Google Calendar, Outlook).
- Calendar Color: Assign a unique color to each calendar. This color will be used to style the events from that source, making them easy to identify.
Need help finding your ICS URL?
How to Get Your iCalendar (ICS) URL
To display events, JT | GCalendar needs a public iCalendar (ICS) link. Here’s how to find it in the most popular calendar services.
Follow these steps to get the public ICS link from your Google Calendar:
- Open Google Calendar on your computer.
- On the left panel, find the calendar you want to share. Click the three-dot menu icon (⋮) next to it and select Settings and sharing.
-
Important: Your calendar must be public for this to work. In the "Access permissions for events" section, check the box for Make available to public.
- Scroll down to the "Integrate calendar" section.
- Find the field labeled Public address in iCal format. This is your ICS link.
- Click the copy icon next to the URL. It should look something like this:
https://calendar.google.com/calendar/ical/your-email%40gmail.com/public/basic.ics - Paste this URL into the "ICS Calendar URL" field in the JT | GCalendar module settings.
Follow these steps to get the public ICS link from your Outlook Calendar:
- Open Outlook Calendar on the web.
- In the top-right corner, click the gear icon (⚙️) to open Settings.
- In the settings panel, select Calendar, and then choose Shared calendars.
-
Important: You must publish the calendar to get a public link. Under the "Publish a calendar" section, select the calendar you want to share.
- Under "Select permissions," choose Can view all details.
- Click the Publish button.
- Two links will appear. You need the ICS link. Click on it, and then click the Copy link option.
- Paste this URL into the "ICS Calendar URL" field in the JT | GCalendar module settings.
Display Settings
Customize the visual appearance and layout of the event list.
- Theme Style: Choose from several professional designs to best match your website's look and feel.
- Classic: A traditional layout with the date on the left and event details on the right.
- Modern: A responsive grid of event cards.
- Minimalist: A clean, typography-focused list.
- Linear: (Describe your fourth theme here).
- Show description: If enabled, the full event description will be available in the popup modal.
- Date Format: Select the desired date and time format for display within the event details modal.
Standard Joomla Options
The Module, Menu Assignment, and Advanced tabs contain standard Joomla! options for module display, positioning, and permissions.
Hey! This package is FREE!
Write a review in the JED
and make us happy
