Calendly Scheduler

Calendly Scheduler is a Joomla system plugin that shows a live Calendly booking calendar inside an article or a contact page. Visitors choose a meeting type, a day and a time and enter their details.

You choose how the booking is made: in your page through the Calendly Scheduling API, or through a single-use Calendly link where the visitor finishes on Calendly. The plugin connects with a Personal Access Token, does not need J2Commerce and includes translations for 22 languages.

Requirements

• Joomla 6.x.
• A Calendly account and a Personal Access Token.
• A paid Calendly plan (Standard or above) for booking inside your page. Plans without the Scheduling API can use Single-Use Link mode instead.

Installation

1. In Joomla, open System -> Install -> Extensions and upload the plugin package.
2. Open System -> Plugins and search for System - Calendly Scheduler.
3. Make sure the plugin is enabled, then open it.

Connecting Calendly

1. In Calendly, open Integrations and Apps -> API and Webhooks -> Personal Access Tokens and create a token.
2. Copy the whole token. Do not cut it short.
3. In the plugin, open the Connection tab and paste it into Personal Access Token.
4. Click Save.
5. Click Test Connection. Connection Status shows Connected, your Account, the Time Zone, the Booking Method and the number of Bookable Event Types.

Adding the Calendar

Put the {calendlyscheduler} tag where the calendar should appear. It works in the text of an article and in the Miscellaneous Information field of a contact. Anywhere else the tag is removed and nothing shows.

{calendlyscheduler}
{calendlyscheduler event=ABC123 days=21 title="Book a Call" intro="Pick a time that suits you."}

Put a value that contains spaces in double quotes. Other attributes are ignored.

Settings

Connection

Booking Defaults

Display

Troubleshooting

How Visitors Book

1. If there is more than one event type, the visitor picks one under Choose a Meeting Type.
2. The visitor picks a day under Choose a Day and a time under Choose a Time.
3. The visitor enters their details under Your Details and clicks Book This Time.

A note above the fields reads All fields are required unless marked optional. The phone field is marked Phone (Optional) unless Require Phone Number is Yes.

A confirmation, You Are Booked, replaces the form. Calendly emails the details.

A visitor can make 3 bookings in 10 minutes. After that the form asks them to wait and try again.

Temporary Errors

If Calendly is briefly unavailable while a visitor loads times, the calendar shows a message and keeps the meeting type picker on screen. The visitor can choose again without reloading the page. When the page offers only one meeting type, the picker is hidden and the visitor sees the error instead.

Keyboard and Screen Readers

• The whole calendar works from the keyboard.
• After an error, or when a day has no times, focus moves to the status message so a screen reader reads it.
• An invalid field, such as a badly formed email address, shows an error linked to the field.
• The days and the previous and next buttons have names a screen reader can read.

Link Mode

Set Booking Method to Single-Use Calendly Link if your Calendly plan cannot use the Scheduling API.

The visitor picks an event type, a day and a time as usual. One More Step then shows a Continue to Calendly (Opens in a New Tab) link. The visitor finishes the booking there, with name and email filled in. Each link works once.

Captcha

Enable a captcha plugin under System -> Plugins first. Then choose it in Captcha. Visitors must pass it before booking.

Template Override

To change the markup of the calendar, copy the layout into your template:

plugins/system/calendlyscheduler/layouts/calendlyscheduler/calendar.php
templates/YOUR_TEMPLATE/html/layouts/calendlyscheduler/calendar.php

Your copy wins over the plugin's own file. If you use a captcha, keep the captcha block from the plugin's layout in your copy. Set Load Default Styles to No if your template supplies the styling.

Languages

The plugin includes translations for 22 languages: Arabic, Chinese (Traditional), Danish, Dutch, English (UK), English (US), Finnish, French, German, Greek, Hebrew, Italian, Japanese, Norwegian Bokmål, Persian, Polish, Portuguese (Brazil), Portuguese (Portugal), Russian, Spanish, Swedish and Turkish. The calendar and the plugin settings use the translation that matches the language Joomla is showing.

Troubleshooting

Page Cache

The calendar works with Joomla page caching or a cache plugin on. After changing the plugin settings, clear the Joomla cache and any server or CDN cache so the page shows the new settings.

Debug Log

1. Set Debug Log to Yes and save.
2. Repeat the action that fails.
3. Open administrator/logs/calendlyscheduler-debug.log.php. Each request to Calendly and its reply is listed with the status code.
4. Set Debug Log back to No.

The token, names, email addresses, phone numbers and answers are masked, including email addresses inside error details. Replies longer than 2 KB are cut. Errors are also written to administrator/logs/calendlyscheduler.log.php, with the same masking.

Uninstalling

Open System -> Manage -> Extensions, search for System - Calendly Scheduler and click Uninstall. Remove any {calendlyscheduler} tags from your content first. Without the plugin the tag shows as plain text.