CalenDeus Documentation
Everything you need to install, configure, and get the most out of your appointment scheduling plugin.
Installation
Installing CalenDeus takes less than 2 minutes.
From the WordPress Plugin Directory
- Go to WordPress Admin โ Plugins โ Add New
- Search for CalenDeus
- Click Install Now, then Activate
Manual Upload
- Download the
.zipfile from your purchase email - Go to Plugins โ Add New โ Upload Plugin
- Select the zip file and click Install Now
- Activate the plugin after installation completes
Quick Start
Get accepting bookings in 3 steps:
Configure your time slots
Go to CalenDeus โ Time Slots. Set your available days and hours for each day of the week.
Add the shortcode to a page
Create or edit any page, and add the shortcode [calendeus_booking_form]. Publish the page.
Test a booking
Visit your page as a visitor. Select a date, pick a time slot, fill in your details, and submit.
Time Slots
Time slots define when customers can book appointments. Navigate to CalenDeus โ Time Slots to configure your schedule.
Day Configuration
Each day of the week can be independently enabled or disabled. For enabled days, set:
- Start Time โ when your first slot begins
- End Time โ when your last slot ends
- Appointment Duration โ length of each session (15 min to 8 hours)
- Break Time โ gap added between consecutive bookings
- Buffer Before/After โ additional padding around each appointment
Multiple Session Blocks
You can define two separate availability windows per day (e.g. 9:00โ12:00 and 14:00โ17:00) to accommodate lunch breaks or split schedules.
Booking Form
The booking form is embedded via a shortcode. Place it anywhere on your site โ pages, posts, or widget areas.
Default Form Fields
Out of the box, the form collects:
- First Name & Last Name
- Email Address
- Gender (optional, can be disabled)
- Service selection
- Notes / Additional information
- GDPR Consent checkbox
Timezone Notice
The booking form automatically displays the site's configured timezone below the time slot picker so customers always know which timezone the slots are shown in.
Dynamic Form Builder
Navigate to CalenDeus โ Form Settings to manage your booking form fields without writing any code.
Managing Fields
The fields table lets you, for each field:
- Edit the label shown to customers
- Toggle Enabled โ hide the field from the form entirely
- Toggle Required โ force customers to fill it in
- Set a Placeholder (for text fields) or Options (for dropdowns, separated by
|)
Adding Custom Fields
Use the Add Custom Field form below the fields table to create extra fields. Supported types:
- Text, Textarea, Email, Number, Phone, Date
- Dropdown (with pipe-separated options)
- Checkbox
Custom field values are saved with every booking and visible in the booking detail drawer in the admin panel.
Resetting to Defaults
Click โฉ Reset to Defaults to restore the original seven core fields and remove any custom fields.
Service Management
Navigate to CalenDeus โ Form Settings โ Service Management to create the services customers can book.
Creating a Service
- Click Add New Service
- Enter a name, optional description, and price
- Choose the currency from the dropdown (24 currencies supported)
- Toggle Active to make it available for booking
- Click Save Service
Currency
The currency selector in the service modal sets the display currency globally for all services. Supported currencies include USD, EUR, GBP, CAD, AUD, JPY, INR, BRL, and 16 more.
Free Plan Limit
Free plan users can create up to 4 services. The heading shows a live counter (e.g. 2/4 free). Once the limit is reached, upgrade to Pro for unlimited services.
Holidays
Block individual dates or entire date ranges to prevent bookings on days you're unavailable.
Adding a Holiday
- Go to CalenDeus โ Holidays
- Click Add Holiday
- Enter a name, select the date or date range
- Optionally mark it as recurring annually
- Save โ the date(s) are immediately blocked in the calendar
Recurring Holidays
When Recurring Annually is enabled, the holiday repeats every year on the same date. Set it once for national holidays, business closures, or personal time off โ no annual maintenance required.
Email Notifications
CalenDeus Pro sends automated emails to both customers and admins at every stage of the booking lifecycle. Navigate to CalenDeus โ Email Settings to configure templates.
Available Templates
| Template | Trigger | Recipient |
|---|---|---|
| New Booking (Customer) | Form submitted | Customer |
| New Booking (Admin) | Form submitted | Admin(s) |
| Booking Confirmed | Status โ Confirmed | Customer |
| Booking Cancelled | Status โ Cancelled | Customer |
| Booking Completed | Status โ Completed | Customer |
| Booking Reminder | 24h before appointment | Customer |
| Admin Reminder | 24h before appointment | Admin(s) |
| Pending Review | Awaiting confirmation | Admin(s) |
Dynamic Variables
Use these placeholders in subject lines and body text:
| Variable | Description |
|---|---|
{customer_name} | Full name of the customer |
{customer_email} | Customer's email address |
{booking_date} | Appointment date (formatted) |
{time_slot} | Appointment time |
{booking_id} | Unique booking reference |
{service_name} | Name of the booked service |
{admin_name} | Business / admin name |
Multiple Admin Emails
You can add multiple admin email addresses under Email Settings โ Admin Notification Emails. All listed addresses receive admin notifications.
Calendar Sync ๐ Pro
Connect your Google Calendar for bidirectional sync. New bookings appear in your calendar automatically. Events in Google Calendar block those time slots in CalenDeus.
Setup Steps
- Go to Google Cloud Console and create a new project (or select an existing one).
- Enable the Google Calendar API under APIs & Services โ Library.
- Go to Credentials โ Create Credentials โ OAuth 2.0 Client ID. Select Web application.
- Add your WordPress site URL as an Authorised JavaScript origin and the OAuth redirect URI shown in CalenDeus settings as an Authorised redirect URI.
- Copy the Client ID and Client Secret into CalenDeus โ Calendar Sync โ Google Calendar.
- Click Connect Google Calendar and authorise access.
Sync Interval
Under Calendar Sync Settings, configure how often CalenDeus pulls external events (5 minutes to 24 hours). More frequent sync means more accurate blocking but slightly more API calls.
CalDAV / Outlook / iCloud
Any CalDAV-compatible calendar service works with CalenDeus Pro, including Microsoft Outlook, Apple iCloud Calendar, and Nextcloud Calendar.
Setup
- Go to CalenDeus โ Calendar Sync โ CalDAV
- Enter your CalDAV server URL, username, and password (or app-specific password)
- Click Test Connection to verify
- Save settings โ sync begins on the next scheduled run
Service-Specific URLs
| Service | CalDAV URL Pattern |
|---|---|
| iCloud | https://caldav.icloud.com |
| Outlook / Office 365 | https://outlook.office365.com/owa/calendar/โฆ |
| Nextcloud | https://your-domain.com/remote.php/dav |
Theme & Colors
Navigate to CalenDeus โ Theme Colors to customise the booking widget to match your brand.
Color Settings
- Primary Color โ main accent (buttons, highlights)
- Calendar Background โ calendar widget background
- Available Slot Color โ colour for open time slots
- Booked Slot Color โ colour for taken time slots
- Holiday Color โ colour for blocked/holiday dates
- Button Text Color โ text colour on primary buttons
Custom CSS
For advanced customisation, paste custom CSS into the Custom CSS text area at the bottom of the Theme Colors page. Styles are scoped to the booking widget container to avoid affecting the rest of your theme.
Leads & CSV Export
Every booking form submission โ including incomplete ones โ is stored as a lead under CalenDeus โ Leads.
Viewing Leads
Filter and sort leads by:
- Date range
- Booking status (Pending, Confirmed, Cancelled, Completed)
- Customer name or email
Exporting to CSV
Click the Export CSV button to download all filtered leads as a comma-separated file. The export is compatible with Excel, Google Sheets, and any major CRM.
Shortcodes Reference
| Shortcode | Description |
|---|---|
[calendeus_booking_form] | Embeds the full booking widget (calendar + time slots + form) |
Place the shortcode in the WordPress block editor using a Shortcode block, or paste it directly into any Classic Editor text area.
FAQ
My time slots aren't showing. What's wrong?
Check that at least one day is enabled under CalenDeus โ Time Slots and that a valid start/end time is set. Also ensure no holidays are blocking the selected date. Note: time slots less than 30 minutes from the current time are automatically hidden for same-day bookings.
Sunday time slots aren't appearing.
Make sure Sunday is enabled in CalenDeus โ Time Slots. Sunday is fully supported alongside all other days of the week.
Calendar sync isn't working.
Verify your Client ID and Client Secret are correct. Ensure the redirect URI in Google Cloud Console exactly matches the one shown in CalenDeus settings (including trailing slashes). Re-connect the account if needed.
Emails aren't being sent.
WordPress uses PHP mail() by default, which many hosts block. Install and configure an SMTP plugin (e.g. WP Mail SMTP) and ensure your 'From' address matches an authorised sender for your domain.
How do I add custom fields to the booking form?
Go to CalenDeus โ Form Settings โ Add Custom Field. Choose a field type (text, dropdown, checkbox, etc.), enter a label, and click Add Field. Custom field values are saved with every booking and visible in the booking detail panel.
I accidentally deleted my form fields. How do I restore them?
Click the โฉ Reset to Defaults button at the bottom of the Form Settings fields table. This restores all original core fields immediately.
Can I accept multiple bookings in the same time slot?
The current version supports single-booking slots (one customer per time slot). Multi-capacity slots are on the roadmap.
How do I move from free to pro?
Purchase a Pro licence through the upgrade page. Pro features unlock immediately โ no data migration required.
Still stuck? Contact support โ