DOCUMENTATION

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

  1. Go to WordPress Admin โ†’ Plugins โ†’ Add New
  2. Search for CalenDeus
  3. Click Install Now, then Activate

Manual Upload

  1. Download the .zip file from your purchase email
  2. Go to Plugins โ†’ Add New โ†’ Upload Plugin
  3. Select the zip file and click Install Now
  4. Activate the plugin after installation completes
โ„น๏ธAfter activation, a new CalenDeus menu item will appear in your WordPress admin sidebar.

Quick Start

Get accepting bookings in 3 steps:

1

Configure your time slots

Go to CalenDeus โ†’ Time Slots. Set your available days and hours for each day of the week.

2

Add the shortcode to a page

Create or edit any page, and add the shortcode [calendeus_booking_form]. Publish the page.

3

Test a booking

Visit your page as a visitor. Select a date, pick a time slot, fill in your details, and submit.

๐Ÿ’กUse the Dashboard section under CalenDeus to see a live count of pending, confirmed, and completed appointments.

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.

โ„น๏ธChanges to time slots take effect immediately. Existing confirmed bookings are not affected.

Booking Form

The booking form is embedded via a shortcode. Place it anywhere on your site โ€” pages, posts, or widget areas.

[calendeus_booking_form]

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.

โ„น๏ธThe timezone is pulled from WordPress โ†’ Settings โ†’ General โ†’ Timezone. Adjust it there if needed.

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.

โš ๏ธResetting removes all custom fields from the configuration. Existing booking data already saved is not affected.

Service Management

Navigate to CalenDeus โ†’ Form Settings โ†’ Service Management to create the services customers can book.

Creating a Service

  1. Click Add New Service
  2. Enter a name, optional description, and price
  3. Choose the currency from the dropdown (24 currencies supported)
  4. Toggle Active to make it available for booking
  5. 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.

๐Ÿ’กYou can hide the service dropdown from customers and pre-select a default service under Service Dropdown settings at the bottom of the Form Settings page.

Holidays

Block individual dates or entire date ranges to prevent bookings on days you're unavailable.

Adding a Holiday

  1. Go to CalenDeus โ†’ Holidays
  2. Click Add Holiday
  3. Enter a name, select the date or date range
  4. Optionally mark it as recurring annually
  5. 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.

โ„น๏ธBlocked dates appear greyed out in the customer-facing calendar and cannot be selected.

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

TemplateTriggerRecipient
New Booking (Customer)Form submittedCustomer
New Booking (Admin)Form submittedAdmin(s)
Booking ConfirmedStatus โ†’ ConfirmedCustomer
Booking CancelledStatus โ†’ CancelledCustomer
Booking CompletedStatus โ†’ CompletedCustomer
Booking Reminder24h before appointmentCustomer
Admin Reminder24h before appointmentAdmin(s)
Pending ReviewAwaiting confirmationAdmin(s)

Dynamic Variables

Use these placeholders in subject lines and body text:

VariableDescription
{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

  1. Go to Google Cloud Console and create a new project (or select an existing one).
  2. Enable the Google Calendar API under APIs & Services โ†’ Library.
  3. Go to Credentials โ†’ Create Credentials โ†’ OAuth 2.0 Client ID. Select Web application.
  4. Add your WordPress site URL as an Authorised JavaScript origin and the OAuth redirect URI shown in CalenDeus settings as an Authorised redirect URI.
  5. Copy the Client ID and Client Secret into CalenDeus โ†’ Calendar Sync โ†’ Google Calendar.
  6. Click Connect Google Calendar and authorise access.
๐Ÿ’กThe entire Google Cloud setup takes approximately 8โ€“10 minutes if you haven't done it before. The CalenDeus settings page displays the exact redirect URI you need to paste into Google Cloud.

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

  1. Go to CalenDeus โ†’ Calendar Sync โ†’ CalDAV
  2. Enter your CalDAV server URL, username, and password (or app-specific password)
  3. Click Test Connection to verify
  4. Save settings โ€” sync begins on the next scheduled run

Service-Specific URLs

ServiceCalDAV URL Pattern
iCloudhttps://caldav.icloud.com
Outlook / Office 365https://outlook.office365.com/owa/calendar/โ€ฆ
Nextcloudhttps://your-domain.com/remote.php/dav
โ„น๏ธFor iCloud, generate an app-specific password at appleid.apple.com โ€” your main Apple ID password will not work for CalDAV.

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.

๐Ÿ’กUse the date range filter before exporting to get a clean monthly or quarterly report.

Shortcodes Reference

ShortcodeDescription
[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 โ†’