Plugin Documentation

Complete user guide covering all features, settings, payment gateways, and add-ons of Appointment Booking Calendar.

No matching documentation sections found

Try searching for a different keyword, check our FAQ page, or contact support.

How It Works

From the WordPress administrator perspective, setting up a booking calendar takes three simple steps:

  1. Customize the fields on your booking form.
  2. Configure your calendar's available time slots, capacity, pricing, email notifications, and optional payment gateway settings.
  3. Publish the booking calendar on any page, post, or sidebar widget.

From the visitor / customer perspective, the booking flow works as follows:

1. The visitor views the calendar on your page and clicks an available date. A panel displays the available time slots for that date so the visitor can select one or more slots.

2. After choosing the date and time slot(s), the visitor fills in the form fields (such as name, email, phone number, and comments) and clicks the submit button.

3. If online payments (e.g., PayPal, Stripe, Square, Mollie) are enabled: The customer completes the payment to confirm the booking. Once paid, the booking is automatically confirmed, the time-slot capacity is updated (and hidden if full), a notification email is sent to the administrator, and a confirmation email is sent to the customer.

4. If online payments are disabled: The customer is immediately redirected to your designated "Thank You" / confirmation page, and both notification and confirmation emails are sent right away.

5. You can review and manage all bookings from the WordPress administration area (Settings >> Appointment Booking Calendar) by clicking on booked dates in the calendar or opening the Bookings List, which includes one-click exports to CSV/Excel and iCal formats.

Installation

To install the Appointment Booking Calendar plugin in WordPress, follow these steps:

  1. Download the plugin .zip package to your computer.
  2. Log in to your WordPress admin dashboard and go to the Plugins menu.
  3. If you have an older or free version of the plugin already installed, deactivate it and click "Delete". (Your existing calendars, bookings, and settings are safely preserved in the database.)
  4. Click the "Add New" button at the top of the Plugins page.
  5. Click "Upload Plugin" and select the .zip file you downloaded in Step 1.
  6. Click "Install Now" and then "Activate Plugin".

Inserting a Form on a Page

  1. Configure your calendar settings under Settings >> Appointment Booking Calendar.
  2. To insert a booking calendar into a page or post, use the Appointment Booking Calendar block/icon in the WordPress editor:

    Insert Form

  3. Alternatively, paste the shortcode [CPABC_APPOINTMENT_CALENDAR calendar="1"] directly into any page, post, or builder block (replace 1 with your calendar's ID). When viewed on the frontend, the shortcode renders the interactive booking calendar and form:

    Published Booking Form

Managing Calendars

Navigate to Settings >> Appointment Booking Calendar in your WordPress admin menu to view and manage your list of calendars:

Calendars List

Each calendar row provides the following controls and information:

  • ID: Unique identification number for the calendar, used when publishing a specific calendar via shortcode.
  • Calendar Name: Internal name used to identify the calendar.
  • Owner: WordPress user assigned to manage the calendar. Non-admin users will only see and manage calendars assigned to their own account.
  • Published: Indicates whether the calendar is active for public bookings.
  • iCal Link: Direct feed URL in iCal (.ics) format for exporting bookings to external calendars such as Google Calendar, Outlook, or Apple Calendar.
  • Update: Saves changes made to the Calendar Name, Owner, or Published status.
  • Manage Settings: Opens the full configuration, schedule, and Form Builder screen for that calendar.
  • Bookings List: Opens a searchable, printable list of all submitted bookings for that calendar.
  • Clone: Creates a duplicate copy of the calendar and all its settings.
  • Delete: Permanently removes the calendar, its settings, and its bookings.
  • Shortcode: Ready-to-copy shortcode for embedding the calendar on any page or post.
Defining Available Time Slots

To configure your schedule and available time slots, go to Settings >> Appointment Booking Calendar >> Manage Settings. At the top of the settings page, you will see the interactive schedule configuration area:

Booking Calendar Time Slots

  1. Select working days: Uncheck any non-working days of the week (for example, Saturday and Sunday).
  2. Add time slots for each weekday: Click each weekday tab and add the available time slots for that day, along with the capacity (maximum number of bookings accepted per slot). You can also generate multiple time slots at once in a single step.
  3. Restricted Dates & Special Dates: Use the "Restricted Dates" tab to block out entire days (such as holidays), and use the "Special Dates" tab to define custom time slots for specific dates that differ from your regular weekly schedule.
  4. Manual bookings & edits: Click any date directly on the admin calendar to view existing appointments or manually add a booking. Time slots with bookings appear struck through; click a slot to view, edit, or delete its bookings (click "Clear" and then "Submit" to remove an appointment).
Checking Submissions

Bookings List Screen

Click the "Bookings List" (or "Bookings / Contacts") button next to your calendar. The bookings screen displays all submitted appointments along with filter controls to search by calendar, date range, or keyword.

From this screen, you can delete individual or grouped bookings, toggle payment status between Paid / Unpaid, print the list, or export bookings to a CSV file.

Exporting Submissions to a CSV File

Exporting Submissions to CSV

To export your bookings to a CSV / Excel file, open the "Bookings List" for your calendar, apply any desired date or keyword filters, and click the "Export to CSV" button. The first row of the exported CSV file contains the column headers based on your form field labels.

Blocking / Unblocking a Specific Date

  • Block an individual time slot: In the calendar's Manage Settings area, click the desired date on the calendar, select the time slot, and enter a block note/reason.
  • Block an entire day: Click the "Restricted Dates" tab on the calendar and click the dates you want to disable completely.
  • Override time slots for a specific date: Click the "Special Dates" tab to define custom time slots and capacities for a particular date.

The Form Builder

When the visual Form Builder is enabled (configured in the Troubleshoot Area & General Settings below the calendars list), each calendar's settings page includes a drag-and-drop visual form editor.

The Form Builder allows you to add, edit, reorder, and remove form fields, create multi-page forms, define conditional logic, and set validation rules (such as required fields, email verification, and file upload restrictions).

Visual Form Builder

Form Title and Predefined Designs

Click the "Form Settings" tab inside the Form Builder to customize your form's title, header description, label alignment (top, left, or right), and visual template. The Platinum edition includes multiple predefined CSS templates ready to apply with one click.

Form Settings Tab

Available Form Field Types
  • Single Line Text: Standard single-line text input.
  • Number: Numeric input field with validation for digits or decimal numbers.
  • Slider: Interactive slider handle for selecting a numeric value.
  • Currency: Formatted currency input supporting thousand separators and currency symbols.
  • Hidden: Hidden input field for passing fixed or dynamic values.
  • Email: Email address field with automatic format validation.
  • Date/Time: Interactive date-picker (with optional month/year dropdowns and time selection).
  • Checkboxes: Checkbox group allowing users to select one or multiple choices.
  • Multiple Choice: Radio button group allowing users to select one choice from a list.
  • Dropdown: Standard drop-down select menu.
  • Upload File: File upload field supporting custom file extensions and size limits.
  • Password: Masked password input (supports equal-field confirmation validation).
  • Phone Field: Phone number input supporting configurable national and international formats (e.g., ###-###-####).
  • Comment Area: Multi-line textarea for user comments, notes, or messages.
  • Summary: Live summary block displaying the values entered across selected form fields.
  • Section Break: Visual divider line and heading for separating sections of a form.
  • Page Break: Splits the form into multiple step-by-step pages with "Next" and "Previous" buttons.
  • Instruct. Text: Informational text block for displaying instructions or links to users.
  • HTML Content: General-purpose block for embedding custom HTML, scripts, or custom styles inside the form.
  • Media: Embeds images, audio, or video files into the form.
  • Button: Custom button control for triggering custom JavaScript actions (such as printing the form).
Container Fields

Container controls let you group multiple fields together for multi-column layouts or collective conditional logic:

  • Fieldset Container: Wraps grouped fields inside a bordered HTML <fieldset> with a title legend.
  • Div Container: Groups related controls inside a clean <div> wrapper without adding visible borders.
Datasource (DS) Fields

Included in the Platinum Edition (and legacy Developer licenses), Datasource controls dynamically populate their values or choices from external sources:

  • Line Text DS: Text input populated from the Database, Posts, Taxonomies, or Users data.
  • Number DS: Numeric input populated from the Database, Posts, Taxonomies, or Users data.
  • Email DS: Email input populated from the Database or Users data.
  • Text Area DS: Multi-line text area populated from the Database or Posts data.
  • Checkboxes DS: Checkboxes populated from the Database, CSV files, Posts, Taxonomies, or Users data.
  • Radio Btns DS: Radio buttons populated from the Database, CSV files, Posts, Taxonomies, or Users data.
  • Drop-down DS: Drop-down select menu populated from the Database, CSV files, Posts, Taxonomies, or Users data.
  • Hidden DS: Hidden input field populated from the Database, Posts, Taxonomies, or Users data.
Editing Field Settings in the Form Builder

Field Settings

Click any field inside the Form Builder canvas to edit its properties in the left panel:

  • Field Label: The label displayed on the public form and in notification emails.
  • Field tag for the message: Read-only tag (e.g., <%fieldname1%>) that you can copy and paste into email templates or confirmation pages to display that specific field's value.
  • Field-specific settings: Options tailored to the selected control type (such as phone format, date format, or choices).
  • Validation rules: Set whether the field is required, digits-only, a valid email/number, or matches another field.
  • Predefined value: Optional default value pre-filled in the field.
  • Instructions for user: Helper text displayed beneath the field.
  • Add CSS layout keywords: Assign one or more CSS class names (such as column2, column3, hide, or your own custom class) to customize the field's layout and styling.
Additional Form Builder Features
  • Equal fields validation: Confirm that two fields match (for example, "Confirm Email" or "Confirm Password"). Supported on Single Line Text, Password, and Email fields.
  • Dependent fields: Dynamically show or hide any field or container based on the user's selection in a Radio Button, Checkbox, or Dropdown field.
Configuring Datasource (DS) Controls

Follow these steps to configure a Datasource control (fields ending with DS):

  1. Insert the desired DS control into your form.
  2. Click the control to open its settings and scroll to the "Define Datasource" section. Choose from the available sources:
    • Database: Loads records from a WordPress or external MySQL database table.
    • CSV: Loads options from an uploaded CSV file (available on Drop-down DS, Checkboxes DS, and Radio Btns DS).
    • Post Type: Loads data from WordPress posts, pages, or custom post types (e.g., WooCommerce products).
    • Taxonomy: Loads terms from categories, tags, or custom taxonomies.
    • User Data: Loads data from registered WordPress users.
  3. Connecting to a Database: Select Database. If querying an external database (different from your WordPress site's database), enter the Host, Username, Password, and Database Name, and click the button to test the connection. Leave those fields blank to query the current WordPress database.
  4. Defining the Database Query:
    • Column for values: The table column that stores the option values.
    • Column for texts: The table column that stores the option labels displayed to the user.
    • Table name: The database table to query (e.g., wp_posts).
    • Condition (optional): A SQL WHERE condition to filter results (for example, post_status='publish').
    • Order by (optional): Sort order for the returned rows (for example, display_name ASC).
    • Limit (optional): Maximum number of rows to retrieve.

For advanced queries, select "Custom Query" and enter a complete SQL query using AS value and AS text aliases:

SELECT column1 AS value, column2 AS text FROM tablename WHERE column3 > 5 ORDER BY column2 ASC LIMIT 5

You can also filter database queries dynamically using the value of another field on the form or a JavaScript variable inside the Condition field with the syntax <%varname%>—for example: ID=<%fieldname3%>.

Using CSV Files as a Datasource

For multi-choice DS fields (Drop-down DS, Radio Btns DS, Checkboxes DS), select "CSV" as the datasource and configure:

  • Select CSV file: Choose the CSV file from your computer.
  • Use headline: Check this box if the first row of your CSV file contains column headers.
  • Delimiter: Specify the character separating columns (such as a comma , or semicolon ;).

Click "Import CSV" to load the file, then choose which columns to use in "Select column for texts" and "Select column for values".

Creating Conditional Dependencies Between Fields

Choice fields (Multiple Choice / Radio Buttons, Checkboxes, and Dropdown) can conditionally show or hide other fields depending on the option selected by the user.

For example, if your booking form has a radio button asking for the service type (In-Person Consultation vs. Home Visit), you can automatically display an "Address" field only when Home Visit is selected:

  1. Click the choice field (Radio, Checkbox, or Dropdown) in the Form Builder.
  2. Click the "Show dependencies" link in the choices settings area.
  3. Next to each choice, select the target field (or container) to display when that choice is selected. Click the + button to link multiple dependent fields to the same choice.

Calendar & Form Settings Area

Each calendar includes a comprehensive configuration panel below the schedule editor:

Full Calendar Settings
* Click image to view full screenshot.

  • Public Calendar Settings
    • Calendar language: Language used for month and weekday names on the calendar (includes auto-detection and support for English, Spanish, German, French, Italian, Dutch, Portuguese, Russian, Japanese, Czech, Slovak, Swedish, Turkish, and more).
    • Calendar visual theme: Pre-built visual style for the interactive calendar.
    • Date format: Choose between mm/dd/yyyy and dd/mm/yyyy, among other formats.
    • Calendar pages: Number of consecutive calendar months displayed simultaneously.
    • Military time: Choose between 12-hour (AM/PM) and 24-hour (military) time display.
    • Start weekday: First day of the week shown on the calendar (e.g., Sunday or Monday).
    • Minimum available date: Earliest date visitors can book, specified either as a fixed date (e.g., 2026-10-25) or a relative expression (e.g., today or today + 3 days).
    • Maximum available date: Latest date visitors can book (fixed date or relative expression such as today + 60 days).
    • Open calendar in this initial month/year: Displays a specific starting month/year when the calendar first loads.
    • Minimum slots to be selected: Minimum number of time slots a customer must select per booking.
    • Maximum slots to be selected: Maximum number of time slots a customer can select in a single booking.
    • Close floating panel after selecting a time slot?: Set to "Yes" by default. Set to "No" if customers frequently select multiple time slots on the same date.
  • Form Builder & Validation Texts
    • Form Builder: Interactive visual form editor for customizing fields and layout.
    • Validation Texts: Customize all front-end validation messages and prompts (such as "This field is required" or "Please select at least X time slots").
  • Price & PayPal Payment Configuration
    • Enable PayPal Payments: Enable or disable PayPal integration (or allow optional PayPal / Pay Later / Stripe checkout).
    • PayPal email: The PayPal merchant email address that will receive booking payments.
    • Request cost: The price charged for the booking (can be set per number of selected slots).
    • PayPal product name: Item description displayed to the customer on the PayPal checkout screen.
    • Currency: Three-letter currency code (e.g., EUR, USD, GBP, CAD).
    • URL to return after successful payment: The "Thank You" / confirmation page URL where customers are redirected after completing their booking. (Important: Always specify a valid URL here, as customers are redirected to this page after submitting the form even when online payments are disabled.)
    • URL to return after an incomplete or cancelled payment: Page URL where customers are returned if they cancel on the payment gateway screen.
    • PayPal language: Two-letter language code for the PayPal checkout interface.
    • Discount Codes: Create promotional coupon codes with percentage or fixed discounts and expiration dates. (A 100% discount bypasses the payment gateway automatically.)
  • Notification Settings to Administrators
    • Notification "from" email: Sender email address used in outgoing notifications (we recommend using an email address belonging to your website's domain).
    • Send notification to email: One or more administrator email addresses (comma-separated) that will receive new booking alerts.
    • Email subject notification to admin: Subject line of the admin notification email.
    • Email format: Choose between Plain Text and HTML email formatting.
    • Email notification to admin: Body template for the administrator notification email. Keep the %INFORMATION% tag (or use individual field tags) to include the booking details.
  • Email Copy to User / Auto-Reply
    • Email subject confirmation to user: Subject line of the confirmation email sent to the customer.
    • Email format: Choose between Plain Text and HTML formatting.
    • Email confirmation to user: Body template of the confirmation email sent to the customer after booking (or after payment completion).
  • Captcha Verification & Reminder Settings
    • Use Captcha Verification?: Enable or disable the built-in anti-spam security code image, and customize its dimensions, colors, and font styling.
    • Reminder Settings: Enable automated email reminders, customize the reminder subject and message, and specify how many hours before the appointment the reminder should be sent.
  • Custom Settings (Optional Services / Multi-Price Field)
    • Options: Enter a list of services or items with individual prices to generate an optional drop-down menu on your form (when the classic form mode is used; with the visual Form Builder enabled, you can add unlimited custom price fields directly in the builder).

Special Tags Allowed in Notification Emails & Confirmation Pages

You can personalize your notification emails, confirmation emails, SMS notifications, and summary pages using the following dynamic tags:

  • %INFORMATION%: Outputs all submitted form fields and booking details.
  • %ITEMNUMBER%: Unique booking / request ID.
  • %CALENDAR%: Name of the calendar associated with the appointment.
  • %DATE%: Selected appointment date.
  • %TIME%: Selected appointment time.
  • %ALLDATES%: All selected dates and times (when multiple time slots are booked in one submission).
  • %COUPONCODE%: Coupon code entered by the customer, if any.
  • %payment_type%: Selected payment method (e.g., PayPal or Pay Later).
  • %txnid%: Payment gateway transaction ID.
  • %SERVICES%: Selected option from the optional Services field.
  • %PRICE%: Total price/cost of the booking.
  • %CANCEL%: Customer self-service cancellation link (Platinum Edition).
  • %ALL_CANCEL_LINKS%: Separate cancellation links for each booked time slot (Platinum Edition).
  • %VALIDATION%: Double opt-in email verification link (when Double Opt-In is enabled).
  • %QUANTITY%, %ADULTS%, %JUNIORS%: Selected capacity/quantity values when quantity fields are enabled.
  • %EMAIL%, %PHONE%, %COMMENTS%, %NAME%: Field values when the visual Form Builder is disabled.
  • %email%, %subject%, %message%, %fieldname1%, %fieldname2%, ...: Individual field values when the visual Form Builder is enabled.

Payment Integrations

To enable a specific payment gateway, activate its corresponding add-on in the Add-ons area at the bottom of the main calendars list page (PayPal Standard and Stripe are built directly into the Platinum version and do not require activating a separate add-on).

The sections below explain how to configure each payment gateway available in the plugin.

PayPal Standard Payments Integration

PayPal Standard is built directly into the plugin. For complete details on configuring PayPal Standard, see the PayPal Payment Configuration section above.

Stripe Payments

The Stripe Payments integration allows you to accept all major credit and debit cards from customers worldwide directly on your website. An active SSL (HTTPS) certificate is required on your website to process transactions securely.

Stripe is built directly into the Platinum edition of the plugin. To activate it, select "Optional PayPal or Stripe.com" (or Stripe) in the "Enable PayPal Payments?" setting within your calendar configuration.

You will need the following credentials from your Stripe account:

When enabled, clicking the booking form submit button opens a secure Stripe checkout dialog where the customer enters their card details without leaving your website.

Skrill Payments

The Skrill Payments add-on provides a secure hosted checkout interface supporting credit/debit cards, over 20 local payment methods, and more than 80 direct bank transfer connections. For more information, visit https://www.skrill.com/en/merchants/.

To activate the add-on, go to Settings >> Appointment Booking Calendar, check the "Skrill Payment Integration" box in the Add-ons list, and click "Activate/Deactivate Addons".

Then configure the following settings in your calendar:

  • Enable Skrill Payments?: Select "Yes" to enable Skrill Payments for the form.
  • Skrill Email: The email address linked to your Skrill merchant account.
  • Receipt URL: The page URL where the user returns after a successful payment.
  • Cancel URL: The page URL where the user returns if payment is cancelled or fails.
  • Currency: Three-letter currency code (e.g., USD, EUR, GBP, CAD).

When enabled, the customer is redirected to the Skrill hosted payment page after submitting the booking form, similar to PayPal Standard.

Authorize.Net Server Integration Method (SIM) Add-on

The Authorize.Net Server Integration Method (SIM) is a hosted payment processing solution that handles all steps of a transaction, including:

  • Collecting customer payment information through a secure, hosted form
  • Generating a receipt for the customer
  • Securely transmitting transaction details to the payment processing network for settlement
  • Funding proceeds to the merchant's bank account
  • Securely storing cardholder information

Because card details are collected on Authorize.Net's secure servers, Authorize.Net SIM simplifies PCI DSS compliance. For more information, visit www.authorize.net.

To activate the add-on, go to Settings >> Appointment Booking Calendar, check "Authorize.net Server Integration Method", and click "Activate/Deactivate Addons".

Configure the following fields in your calendar settings:

  • Enable Authorize.net SIM?: Select "Yes" to enable Authorize.Net SIM payments.
  • Mode: Select "test" for sandbox testing or "production" for live payments.
  • API Login ID / Username: Enter the API Login ID provided by Authorize.Net.
  • Transaction Key / API Key: Enter the Transaction Key provided by Authorize.Net.
  • Receipt URL: The URL where users return after a successful payment. Important: You must also configure the receipt link URL inside your Authorize.Net Merchant Interface.
  • Cancel URL: The URL where users return if payment fails or is cancelled.

You can also optionally map form field IDs (such as fieldname1, fieldname2) to pre-fill customer details (name, address, phone, email) on the Authorize.Net payment form.

TargetPay (iDEAL) Add-on

The TargetPay add-on provides integration with iDEAL, the most popular Dutch online banking payment method, via TargetPay (targetpay.com).

The iDEAL platform connects the online banking systems of the largest Dutch banks (ABN AMRO, ASN Bank, bunq, ING, Knab, Rabobank, RegioBank, SNS Bank, Triodos Bank, and Van Lanschot) into a single, trusted payment method.

To activate the add-on, go to Settings >> Appointment Booking Calendar, check "iDeal TargetPay", and click "Activate/Deactivate Addons".

Then configure the following fields in your calendar settings:

  • Enable iDeal-TargetPay?: Select "Yes" to enable TargetPay iDEAL payments for the form.
  • RTLO Subaccount ID: Enter your RTLO Subaccount ID from TargetPay.
  • If payment fails return to this page: Return URL if the payment fails or is cancelled.
  • Payments Mode: Choose between "test" for testing and "production" for live transactions.

When enabled, the customer selects their bank and is redirected to the iDEAL-TargetPay payment environment upon submitting the booking form.

Mollie (iDEAL) Add-on

The Mollie add-on integrates your booking forms with iDEAL via Mollie, allowing customers to pay directly through the trusted online banking environment of major Dutch banks.

Mollie iDEAL Add-on Settings

In the calendar settings area, provide the following details to link your Mollie account:

  • Enable iDeal-Mollie?: Select "Yes" to enable the Mollie iDEAL add-on (this automatically overrides PayPal Standard for that form).
  • Mollie API Key: Enter your Mollie test or live API Key.
  • If payment fails return to this page: The page URL where customers are redirected if payment is cancelled or fails.

When enabled, customers are redirected to the Mollie iDEAL checkout screen after submitting the booking form.

RedSys TPV (Servired / Sermepa — Spanish Banks)

The RedSys / Servired / Sermepa add-on provides a secure virtual POS (TPV) integration for accepting credit and debit card payments through major banks in Spain (Banco Sabadell, BBVA, Santander, CaixaBank, Bankinter, etc.). Learn more at www.redsys.es.

RedSys Add-on Settings

In the calendar settings area, enter the following details provided by RedSys or your bank:

  • Enable TPV: Select "Yes" to enable RedSys TPV payments.
  • CÓDIGO COMERCIO: Your Merchant Code (FUC) provided by RedSys/your bank.
  • CLAVE SECRETA: Your SHA-256 Secret Key provided by RedSys/your bank.
  • Mode: Select "Sandbox" for testing or "Production" for live payments.

When enabled, customers are redirected to the bank's RedSys TPV payment page upon submitting the booking form.

SagePay (Opayo) Add-on

The SagePay add-on provides a secure interface for accepting online payments through SagePay (opayo.co.uk).

To activate the add-on, go to Settings >> Appointment Booking Calendar, check "SagePay", and click "Activate/Deactivate Addons".

Configure the following fields in your calendar settings:

  • Enable SagePay?: Select "Yes" to enable the SagePay payment gateway.
  • Vendor ID: Enter the Vendor ID provided by SagePay.
  • SagePay Encrypt Password: Enter the Encryption Password provided by SagePay.
  • Mode: Select "Sandbox" for testing or "Production" for live transactions.

When enabled, the customer is redirected to the SagePay payment form after submitting their booking.

Sage Payment Solutions Add-on

The SagePayments add-on provides a secure SSL checkout integration for bankcard and virtual check transactions via Sage Payment Solutions >> Shopping Cart ExpressPay.

To activate the add-on, go to Settings >> Appointment Booking Calendar, check "SagePayments Payment Gateway", and click "Activate/Deactivate Addons".

Configure the following required settings in your calendar:

  • Enable SagePayments?: Select "Yes" to enable the gateway.
  • Merchant ID (M_id): Enter the M_id provided by Sage Payment Solutions.

You can also optionally map form field IDs (e.g., fieldname1, fieldname2) to pass customer name, address, phone, email, tax, and shipping details to the checkout form.

Square (squareup.com) Payments Add-on

The Square Payments add-on lets you accept all major credit and debit cards directly on your website via Square. An active SSL (HTTPS) certificate is required on your site.

To activate the add-on, go to Settings >> Appointment Booking Calendar, check "Square", and click "Activate/Deactivate Addons".

In your calendar settings, enter your Square credentials from your Square Developer Dashboard:

  • Enable Square?: Select "Yes" to enable Square Payments.
  • Squareup.com Application ID: Your Square Application ID.
  • Squareup.com Access Token: Your Square Access Token.
  • Squareup.com Application Secret: Your Square Application Secret.
  • Squareup.com Location ID: Your Square Location ID.
  • Currency: Three-letter currency code (e.g., USD, EUR, GBP).
  • Mode: Select "production" or "sandbox/test".

Add-ons & Integrations

All included add-ons are listed in the "Add-ons area" at the bottom of the main Settings >> Appointment Booking Calendar page. To enable any add-on, simply check its box and click "Activate/Deactivate Addons".

Add-ons List

iCal Export

The built-in iCal Export feature allows you to automatically export your bookings to external calendar applications that support the iCal (.ics) format, including Google Calendar, Microsoft Outlook, and Apple iCloud Calendar.

No add-on activation is needed for exporting: simply go to Settings >> Appointment Booking Calendar, right-click the "iCal" link next to your calendar, and copy the link address.

For step-by-step instructions on subscribing to your iCal feed in Google Calendar, see this FAQ entry.

iCal Automatic Import Add-on (Two-Way Sync)

The iCal Automatic Import add-on automatically imports busy times and events from external iCal-compatible calendars (Google Calendar, Outlook, Apple Calendar, Airbnb/Booking feeds, etc.) into your Appointment Booking Calendar.

To activate the add-on, go to Settings >> Appointment Booking Calendar, check "iCal Automatic Import", and click "Activate/Deactivate Addons".

Then configure the following options in your calendar settings:

  • Enable iCal import for this calendar?: Select "Yes" to enable automatic iCal import.
  • iCal URL: Enter the full http:// or https:// URL of the remote .ics feed to import.

The remote iCal feed is automatically imported every hour as well as whenever your calendar settings are saved.

Signature Add-on

Signature Add-on

The Signature Add-on converts selected form fields into interactive digital signature pads, allowing customers to sign using a mouse, trackpad, or touchscreen.

To activate the add-on, go to Settings >> Appointment Booking Calendar, check "Signature", and click "Activate/Deactivate Addons".

Signature Add-on Settings

In the calendar's settings, choose which form fields to convert into signature pads and configure their appearance:

  • Color: Hex color code for the signature ink (e.g., #000000).
  • Line thickness: Integer value defining the stroke width of the signature.
  • Show guideline: Checkbox to display or hide a horizontal signing line inside the signature box.
  • Guideline color: Hex color code for the signing guideline (e.g., #000000).

Mailchimp Add-on

Mailchimp Logo

The Mailchimp Add-on automatically adds customers who submit your booking form as subscribers to your Mailchimp audience lists.

Mailchimp Subscribers

To activate the add-on, go to Settings >> Appointment Booking Calendar, check "MailChimp", and click "Activate/Deactivate Addons".

Once activated, open your calendar settings to map your booking form fields to your Mailchimp list:

Mailchimp Settings

  1. Enter your Mailchimp API Key.
  2. Click "Get Lists" to load all audience lists from your Mailchimp account.
  3. Select your target list and click "Get Fields and Groups" to map your booking form fields and interest groups to your Mailchimp signup fields.

Twilio SMS Add-on

The Twilio SMS Add-on integrates with Twilio so booking confirmations and appointment reminders can be sent via SMS text message to both administrators and customers.

Configure the following details in your calendar settings:

  • Enable TwilioSMS: Select "Yes" to enable SMS notifications for the booking form.
  • Twilio AccountSid: The Account SID from your Twilio console.
  • Twilio AuthToken: The Auth Token from your Twilio console.
  • ID of the field that contains the phone number: The Form Builder field ID where the customer enters their mobile number (e.g., fieldname1—enter only the field ID without percent signs or brackets).
  • Phone number used as "from": Your valid Twilio sender phone number (including country code).

Note: Standard single SMS messages are limited to 160 characters.

Clickatell SMS Add-on

The Clickatell Add-on enables sending instant SMS notifications and appointment reminders to mobile phones worldwide.

Clickatell SMS

To activate the add-on, go to Settings >> Appointment Booking Calendar, check "Clickatell", and click "Activate/Deactivate Addons".

Clickatell Add-on Settings

Configure the following settings in your calendar:

  • Clickatell enabled: Enable or disable Clickatell SMS notifications for this calendar.
  • Account API Key: Enter the API Key from your Clickatell account.
  • To Phone Number (Admin): Enter one or more recipient phone numbers (comma-separated, including country code) for admin SMS alerts.
  • Message: Enter the SMS text content (supports the same special tags used in notification emails).
  • To Phone fields (Customer): To send an SMS to the customer's phone number entered in the form, specify the phone field ID(s) (e.g., fieldname1, comma-separated) and customize the customer SMS message template.

WooCommerce Add-on

Included in the Platinum edition, the WooCommerce Add-on integrates your Appointment Booking Calendar forms directly with WooCommerce products so customers can book time slots, calculate dynamic prices, and check out through the WooCommerce cart and payment gateways.

Once activated, the add-on adds an Appointment Booking Calendar metabox to the WooCommerce product editor with the following settings:

  • Enter the ID of the form: Select the calendar/form ID to display on that product page.
  • Calculate the product price through the form: Use the price calculated by the booking calendar form as the product's cart price.
  • Minimum price allowed: Optional minimum price floor for the product.
  • Activate the summary: Display a custom summary of the selected appointment details on the WooCommerce cart and checkout pages.
  • Summary title & Summary content: Define the heading and content of the cart summary using any of the special tags supported in notification emails.

Important: Make sure your WooCommerce product has a numeric value entered in its "Regular price" field (e.g., 0 or your base price); otherwise, WooCommerce hides the "Add to cart" button.

WooCommerce Add-on

Salesforce Add-on

The Salesforce Add-on automatically creates new Leads in your Salesforce CRM account from submitted booking forms.

Ensure that Web-to-Lead is enabled in your Salesforce account, then configure the following in your calendar settings:

  • Enter the OID (Organization ID): Your Salesforce Organization ID.
  • Enabling debug: Check this option and provide a debug email address while testing lead creation; uncheck it for live production use.
  • Add attribute: Map Salesforce Lead attributes (predefined or custom) to fixed text or dynamic form fields (fieldname#).

Salesforce Add-on

WebHook Add-on

The WebHook Add-on posts submitted booking data to one or more external Webhook URLs via HTTP POST. Using WebHooks with integration platforms like Zapier, Make (Integromat), or Pabbly Connect lets you connect your booking forms to hundreds of web services—including Google Sheets, Google Drive, Dropbox, Zoho CRM, HubSpot, Slack, and document merge tools.

To use the add-on, simply paste your destination Webhook URL into the WebHook section of your calendar settings. Click "Add new URL" to trigger multiple webhooks from the same form.

Tip for Zapier: Select "Webhooks by Zapier" as the Trigger app and "Catch Hook" as the trigger event.

WebHook Add-on

Google reCAPTCHA Add-on

The reCAPTCHA Add-on protects your booking forms using Google reCAPTCHA in place of the traditional image captcha. With a single click, visitors confirm they are human without typing distorted characters.

To enable Google reCAPTCHA, go to Settings >> Appointment Booking Calendar, check "reCAPTCHA" in the Add-ons list, and click "Activate/Deactivate Addons". Then enter your Google reCAPTCHA Site Key and Secret Key in the settings section that appears.

reCAPTCHA Add-on

Zoom Meetings Integration Add-on

The Zoom Meetings Integration Add-on connects your booking calendar with Zoom to automatically generate a Zoom video meeting for the booked time slot and include the meeting invitation link in your confirmation and notification emails.

  1. Go to Settings >> Appointment Booking Calendar, check "Zoom Meetings Integration" in the Add-ons area, and click "Activate/Deactivate Addons".
  2. Open your calendar's Manage Settings page, scroll to the Zoom section near the bottom, and set "Enable Zoom integration for this booking form" to "Yes".
  3. Enter your Zoom API credentials from the Zoom App Marketplace.

You can then insert the following Zoom tags into your customer confirmation and admin notification emails:

  • %zoom%: The join invitation link for the generated Zoom meeting.
  • %zoom_id%: The Zoom meeting ID.
  • %zoom_password%: The Zoom meeting passcode.

Appointment Limits Add-on — Limit Bookings per User

The Appointment Limits Add-on (included in the Platinum edition) lets you restrict the maximum number of appointments a single user can book per day, per week, and/or per month (for example: max 1 appointment per day, max 2 per week, and max 5 per month).

Limits can be enforced either by the customer's email address or by their logged-in WordPress user account:

  1. Go to Settings >> Appointment Booking Calendar, check "Limit the number of appointments per user" in the Add-ons area, and click "Activate/Deactivate Addons".
  2. Open your calendar's Manage Settings page, scroll to the bottom, set "Enable appointments limits for this calendar" to "Yes", and configure your desired daily, weekly, and monthly limits.

Summary Display Add-on — Booking Summary on the "Thank You" Page

The Summary Display Add-on (included in the Platinum edition) provides a shortcode to display a customized summary of the customer's submitted booking directly on your confirmation / "Thank You" page:

  1. Activate the "Summary Display" add-on at the bottom of the main calendars list page.
  2. In your calendar's Manage Settings page, scroll to the Summary Display section and customize the summary template using any of the special email tags.
  3. Place the following shortcode on the "Thank You" page where customers are redirected after booking:
    [CPABC_DISPLAY_SUMMARY calendar="1"]

Troubleshoot Area & General Settings

Troubleshoot Area

Located at the bottom of the main calendars list page, the "Troubleshoot Area & General Settings" section helps resolve script or encoding conflicts with third-party themes/plugins and configures global options:

  • Form rendering: Choose between the classic HTML form and the visual Form Builder.
  • Script load method: Switch from "Classic" to "Direct" if the calendar does not appear on your public page due to theme or caching conflicts.
  • Character encoding: Update the database table character set (e.g., to UTF-8) if special or non-Latin characters are not displaying properly.
  • iCal time-zone difference vs server time: Adjust the hour offset relative to your server time if needed for exported iCal feeds.
  • iCal time-slot size in minutes: Define the default appointment duration (in minutes) recorded in exported iCal events.

Double Opt-In Email Validation

The Platinum Edition supports double opt-in email validation in two steps:

  1. Step 1: A customer completes and submits your online booking form.
  2. Step 2: The customer receives an automated email containing a verification link. Clicking that link confirms their email address and changes the booking status to "Confirmed".

Double opt-in validation helps prevent spam bookings and supports compliance with the European General Data Protection Regulation (GDPR). It can be enabled under the Troubleshoot Area & General Settings at the bottom of the main calendars list page:

Double Opt-In Email Validation

  • Enable Double-Opt-In E-mail Validation?: Enable or disable the verification requirement.
  • Return address for a successful validation link: The page URL where the customer is redirected after clicking a valid confirmation link.
  • Return address for an expired validation link: The page URL where the customer is redirected if the validation link has expired or is invalid.
  • Link Expiration: Number of hours before the appointment date that an unused validation link expires.

IMPORTANT: When Double Opt-In is enabled, you must include the tag %VALIDATION% inside the customer confirmation email content so the verification link is inserted into the email.

When enabled, a "Verified?" column appears in the Bookings List indicating whether each booking has been confirmed via the validation link.

To add a "Print" button that prints only the booking form (without the rest of the web page), follow these two steps in the visual Form Builder:

  1. Insert an "HTML Content" field into your form and paste the following script into its content box:
    <script>
    function printForm() {
    	var w = window.open(null, 'Print_Page', 'scrollbars=yes');
    	jQuery('#fbuilder input').each(function () {
    		var e = jQuery(this);
    		e.text(e.val()).attr('value', e.val());
    		if (e.hasClass('large'))
    			e.css('width', '100%');
    		if (typeof e.prop('checked') != 'undefined')
    			e.attr('CHECKED', e.prop('checked'));
    	});
    	var html = jQuery('#fbuilder').html();
    	jQuery('#fbuilder TEXTAREA').each(function () {
    		var e = jQuery(this).parent().html();
    		html = html.replace(e, jQuery(this).val());
    	});
    	jQuery('#fbuilder SELECT').each(function () {
    		var e = jQuery(this).parent().html();
    		html = html.replace(e, jQuery(this).find('option:selected')[0].text);
    	});
    	w.document.write(html);
    	w.document.close();
    	w.print();
    }
    </script>
  2. Insert a "Button" field into your form and enter the following function call in its onclick event setting:
    printForm();