WordPress appointment booking

ServiCal
Installation & User Guide

A practical guide to setting up services, staff schedules, online bookings, payments, customer emails, and appointment management in WordPress.

Version 1.0.0WordPress pluginWooCommerce not requiredBeginner friendly

Welcome

Introduction

ServiCal is an appointment booking and scheduling plugin for WordPress. It lets service businesses publish bookable services, assign staff, set business hours, accept customer reservations, and manage appointments from the WordPress admin area.

The plugin includes a guided booking form, an availability calendar, customer appointment pages, configurable email notifications, optional Stripe and PayPal payments, a Google Calendar connection for the administrator, and booking reports.

Standalone WordPress plugin. WooCommerce is not required. You can allow customers to pay at the appointment, enable Stripe or PayPal, or offer an online deposit when partial payments are configured.

This guide describes the plugin options and shortcodes. Labels may vary slightly if you customize the form or update the plugin.

Before you begin

Requirements

  • WordPress: version 6.5 or newer, as declared in the plugin header.
  • PHP: version 7.4 or newer, as declared in the plugin header.
  • PDF export: PHP DOM and mbstring extensions are required by the bundled Dompdf renderer.
  • WooCommerce: not required.
  • Online payments: Stripe or PayPal merchant credentials are optional. Use HTTPS on production sites and test provider credentials before accepting live payments.
  • Scheduled tasks: WordPress Cron is used for scheduled reminders and calendar sync. Sites with low traffic may benefit from a server cron that triggers WP-Cron.
Version note: Check the plugin readme and release notes for the versions verified for the exact package you install. This guide does not claim an additional WordPress or PHP version was tested.

Install the plugin

Installation

  1. Sign in to WordPress with an account allowed to install plugins.
  2. Open Plugins → Add New Plugin → Upload Plugin.
  3. Select the ServiCal ZIP package and choose Install Now. Alternatively, upload the extracted servical-booking-scheduling folder to /wp-content/plugins/.
  4. Choose Activate Plugin.
  5. Open the new ServiCal menu in the WordPress admin and start with services, staff, business hours, and payment settings.
  6. Open ServiCal → Settings → Help & Support to review the generated pages and shortcodes. Edit the pages to match your site's navigation and design.

Activation sets up the plugin's booking data structures and default customer-facing pages where needed. It does not require WooCommerce.

ServiCal settings showing generated customer pages and their shortcodes
Pages and shortcodes. Review the pages ServiCal created and open each page to confirm it is published and linked in your site navigation.

First-time setup

Quick setup checklist

  1. Add service categories if you need them. Open ServiCal → Categories. Categories are optional; the booking form can show one flat service list.
  2. Create services. Add a clear title, description, price, duration, and optional image. Choose a category if you use categories.
  3. Add staff. Enter staff details, select the services they provide, and configure their working availability.
  4. Set business hours. Configure opening and closing times, working days, breaks, booking intervals, buffers, and advance notice.
  5. Choose payment methods. Enable pay at service, Stripe, or PayPal. If online payments are enabled, add valid provider credentials and perform a test transaction.
  6. Set customer and admin emails. Check the sender name/address, notification recipient, and the email templates.
  7. Test a complete booking. Use the public booking page, check the confirmation email, then update or cancel the test booking from the admin.

Admin settings

Configuration guide

Open ServiCal → Settings. Settings are grouped into tabs. Save changes after updating each tab.

General

Set booking labels and references, service categories, account or email verification requirements, CAPTCHA options, and data retention on uninstall.

Business Hours

Set opening and closing hours, working days, break periods, blocked dates, slot duration, booking buffers, and the minimum booking notice.

Payments & Currency

Choose a currency, enable pay at service, configure deposits as a fixed amount or percentage, and connect Stripe or PayPal. Provider currency availability depends on the provider account and country.

Connected Services

Connect the administrator's Google Calendar using a Google Cloud OAuth web application. The integration writes booking events to the authorized administrator calendar.

Email Settings

Set admin notifications, customer email sender details, and the content for booking confirmations, cancellations, reminders, reschedules, and promotional offers.

Calendar Settings

Adjust calendar appearance, date and time presentation, and the information displayed with scheduled appointments.

Booking Form Settings

Customize form text, colors, button appearance, customer account labels, field labels, placeholders, and field layout.

Help & Support

Find the generated pages and shortcodes, including the review form and approved-review display.

ServiCal settings tabs and general configuration screen
Settings overview. Use the tabs to configure booking behavior and the customer-facing form.

Services, categories, and staff

Use ServiCal → All Services to create or edit services. Use ServiCal → All Staffs to manage staff profiles and assigned services. If you enable service categories and assign services to them, customers can browse the groups in the booking form. If categories are not enabled, the form shows the service list without category accordions.

ServiCal service list in WordPress admin
Service list. Review and maintain the bookable services.
ServiCal service editor
Service editor. Configure service details, price, duration, and optional image.
ServiCal staff list in WordPress admin
Staff list. Add the people who provide the services.
ServiCal staff profile and availability editor
Staff profile. Set staff availability and service assignments.
ServiCal service category management
Service categories. Group related services for easier browsing.

Booking rules and availability

Set regular business hours and each staff member's schedule. A time is offered only when the selected service duration fits the schedule and the assigned staff member is available. Existing bookings occupy the selected staff member's time; another available staff member may still be bookable for the same time.

Slot duration controls the start-time interval. It is separate from a service's duration: for example, a 60-minute service can have start times offered at 30-minute intervals when configured that way. Buffer time and advance notice further affect available slots.

Booking reference prefix, slot duration, booking buffer and notice settings
Booking rules. Set the reference prefix, slot duration, booking buffer, and notice period.
Weekly business hours settings
Business hours. Set regular opening times and working days.
Schedule break and closed-date settings
Breaks and closed dates. Prevent bookings during breaks and unavailable dates.
Calendar display and appearance settings
Calendar display. Customize how availability is presented to visitors.

Payment settings

Enable the methods you want customers to see. Pay at service records a booking without collecting an online payment. Stripe and PayPal are optional online gateways. When partial payments are enabled, customers paying online can choose the configured deposit or pay the full total. The booking summary displays the amount due now and remaining balance.

Use Stripe test keys and PayPal Sandbox while configuring checkout. Switch to live credentials only after test bookings, payment confirmation, and refunds have been reviewed. Stripe webhook configuration is required for payment confirmation events.

Currency, pay at service and deposit settings
Currency and deposits. Configure payment choices and the partial-payment amount.
PayPal credentials and environment settings
PayPal setup. Add credentials and select Sandbox or Live mode.

Security, privacy, and account options

Use the General tab to choose whether account registration or sign-in is required, and whether email verification or Google reCAPTCHA is enabled. Follow data protection rules that apply to your business. The uninstall data option controls whether ServiCal records and settings are retained or removed when the plugin is uninstalled.

Email verification, reCAPTCHA and uninstall data settings
Security and privacy options. Configure verification, spam protection, and uninstall behavior.
Customer account form labels and appearance settings
Customer account form. Customize sign-in and registration labels.

Customer and admin workflow

Using ServiCal

Customer booking flow

  1. Choose one or more services. Service prices and durations are combined in the booking summary.
  2. Choose a staff member, or select the no-preference option if enabled. Pick a date and an available time.
  3. Enter customer contact details. If account access is required, sign in or register first. If verification is enabled, complete the server-validated email step.
  4. Choose an available payment option. Pay at service records the reservation; Stripe or PayPal collects online payment. If deposits are enabled, select the deposit or full payment offered by the form.
  5. Submit the booking and review the on-page or separate confirmation summary, depending on the thank-you page setting.
Customer booking form selecting services
Step 1: services. Customers choose one or more bookable services.
Customer booking form choosing staff and a date
Step 2: staff and date. The available choices reflect service and staff schedules.
Customer booking form with available appointment times
Step 2: time selection. Available appointment starts are selectable.
Customer booking form with selected appointment time
Step 2: selected time. Confirm the chosen slot before continuing.
Customer details step of the booking form
Step 3: customer details. Collect the contact details needed for the reservation.
Customer payment step showing enabled payment methods
Step 4: payment options. The form displays payment methods enabled by the administrator.
Customer choice between paying a deposit and paying in full
Deposit or full payment. Customers can choose between the configured deposit and full amount when partial payment is active.
Stripe inline payment form in the booking flow
Stripe inline checkout. Payment details are collected by Stripe's hosted components.
Live booking form preview in ServiCal settings
Form preview. Preview the customer form while adjusting its settings.

Manage bookings in WordPress

Open ServiCal → Bookings to search and filter reservations by customer, email, date, or status. Use View to inspect a booking, Update to change its booking or payment status, and the available action to request a refund for eligible online payments. Keep payment provider records in view when reconciling refunds.

Bookings list with customer, appointment and payment information
Bookings list. Review booking status, payment, service, staff, date, and time.
Booking status and payment status update dialog
Update a booking. Change booking and payment status in the admin.
Booking details screen in WordPress admin
Booking details. Review the saved appointment and customer information.
ServiCal customer list
Customer management. Review customer records and their appointment history.

Daily call list and exports

Open ServiCal → Daily Bookings, set a start and end date, and filter the list. Download the PDF call list to print appointment date and time, customer name, phone, and assigned staff. The report includes pending and confirmed appointments. The Bookings and Customers screens also provide CSV export options.

Daily bookings date-range filter and appointment list
Filter the daily list. Select a date range to prepare a call list.
Printable daily bookings report with customer phone and staff
Print-ready PDF. Download the filtered call list for staff use.

Customer accounts and cancellations

Add [servical_user_dashboard] to the My Appointment page. Customers who sign in can review appointments and use the available reschedule or cancellation actions. If account registration is not required, the site setting and customer booking flow determine how the customer accesses their records. Review your cancellation and refund policy and explain it to customers before taking bookings.

Reviews

When an administrator changes a booking from another status to Completed, ServiCal immediately attempts to send a one-time review invitation email to the customer's saved email address. The invitation is not delayed until the appointment date. A valid customer email and working WordPress email delivery are required. Existing invitation records prevent another invitation for the same booking; the token expires after 30 days. Submitted reviews are held for approval under ServiCal → Reviews, then may be displayed with [servical_reviews].

Review moderation list with approve and unapprove actions
Review moderation. Approve reviews before publishing them on a page.

Add ServiCal to pages

Shortcodes

Paste a shortcode into a WordPress Shortcode block, a page editor that supports shortcodes, or the appropriate widget. Keep the brackets when copying.

ShortcodeWhat it displaysExample
[servical_booking_form]Multi-step customer booking form.[servical_booking_form]
[servical_booking_popup]A button that opens the booking form in a popup.[servical_booking_popup btn_text="Book now"]
[servical_booking_form]Booking form rendered as a popup via its attribute.[servical_booking_form popup="true" btn_text="Book now"]
[servical_booking_calendar]Monthly availability calendar.[servical_booking_calendar]
[servical_event_calendar]Alias for the booking calendar.[servical_event_calendar]
[servical_user_dashboard]Customer appointment account area.[servical_user_dashboard]
[servical_customer_dashboard]Alias for the customer appointment account area.[servical_customer_dashboard]
[servical_booking_confirmation]Booking confirmation summary for a separate thank-you page. Usually managed by the plugin's page setting.[servical_booking_confirmation]
[servical_review_form]Secure review form opened from a valid one-time invitation link.[servical_review_form]
[servical_reviews]Approved public customer reviews.[servical_reviews limit="6"]

The limit attribute on [servical_reviews] is optional and capped at 50. Popup shortcode options include button text, class, style, and icon where supported by the current plugin version. Check Settings → Help & Support for the installed version's usage table.

Popup booking shortcode examples in ServiCal settings
Popup shortcode reference. Find the available shortcode options in the plugin settings.

Optional services

Integrations

Stripe

  1. Create or use a Stripe account and retrieve the publishable and secret keys from its developer dashboard.
  2. In ServiCal → Settings → Payments & Currency, enable Stripe, paste the keys, and select inline Payment Element or hosted Stripe Checkout.
  3. For hosted Checkout, configure the required checkout.session.completed webhook event. For inline payment, configure payment_intent.succeeded. Use the webhook URL and secret shown by the plugin's setup guidance.
  4. Test a booking in Stripe test mode, then verify the booking status and payment amount in WordPress before switching to live credentials.

Card numbers and security codes are collected by Stripe's components and are not stored in ServiCal. Stripe receives the payment amount and the booking details needed to create and reconcile the transaction. Review Stripe's privacy policy and service agreement.

PayPal

  1. Create a REST application in the PayPal Developer Dashboard and copy its Client ID and Secret.
  2. Enable PayPal in the Payments settings, choose Sandbox first, and enter the credentials for that environment.
  3. Complete a test booking using a Sandbox buyer account. Confirm the booking and payment in both WordPress and PayPal.
  4. When ready, select Live and replace the sandbox credentials with the Live credentials.

The PayPal Secret is stored server-side. PayPal's JavaScript SDK displays the customer checkout controls, and the server verifies and captures the approved order. See PayPal developer documentation, privacy, and user agreement.

Google Calendar for the administrator

  1. In Google Cloud Console, create a project and enable the Google Calendar API.
  2. Configure the OAuth consent screen for the intended account audience.
  3. Create an OAuth client with application type Web application.
  4. Copy the exact Authorized Redirect URI shown under ServiCal → Settings → Connected Services into the OAuth client. An authorized JavaScript origin is not the same as the redirect URI.
  5. Enter the OAuth Client ID and Client Secret in ServiCal, save, then select Connect administrator calendar and authorize the calendar owner.

This connects the administrator's authorized primary calendar; it does not connect customer calendars or invite customers. Google OAuth apps left in Testing may have short-lived refresh tokens. For production, configure the consent screen and verification requirements that apply to your Google project. Review Google's OAuth web-server guide and Calendar API guide.

Google Calendar OAuth settings and administrator connection controls
Google Calendar setup. Use the exact redirect URI displayed by ServiCal.

Google reCAPTCHA

reCAPTCHA is optional. Add the site and secret keys for the configured reCAPTCHA integration in the plugin settings. When enabled, Google receives the response token and may process visitor information such as the IP address and browser context. Review Google's privacy policy and terms.

Customer communication

Email notifications

Open ServiCal → Settings → Email Notifications to configure the sender name and address, administrator alerts, and customer email templates. Edit the subject and message content using the visual or code editor. Click a placeholder tag to insert booking information supported by that template.

  • Booking confirmation: sent after the booking reaches the successful booking flow.
  • Cancellation: sent when a booking is cancelled.
  • Reminder: scheduled before the appointment when enabled; WordPress Cron must run the scheduled event.
  • Reschedule: sent when the appointment date or time is changed through the supported workflow.
  • Promotional email: optional email for configured discounts and selected services.
  • Review invitation: triggered immediately when an admin changes a booking into Completed. There is no separate review-email enable setting. One invitation is created per booking; the link expires after 30 days.

ServiCal sends mail through WordPress wp_mail(). For reliable delivery, configure an SMTP or transactional mail service through your WordPress hosting or a trusted mail plugin. Test messages to more than one email provider and check spam folders.

No SMS gateway is included. The plugin's built-in customer notifications are email-based. Do not advertise SMS delivery unless a separately configured integration provides it.
Administrator notifications and customer email sender settings
Sender and admin notifications. Set the outgoing customer sender and admin recipient.
Booking confirmation email editor
Confirmation template. Edit customer-facing booking confirmation content.
Booking cancellation email editor
Cancellation template. Customize the message sent when a booking is cancelled.
Booking reminder email editor and timing setting
Reminder template. Configure the reminder message and lead time.
Reschedule notification email editor
Reschedule template. Tell customers about a changed appointment time.
Customer booking confirmation email preview
Customer email preview. Check the final message and booking details.

Common questions

Troubleshooting

No available times appear

Confirm the service is published and has a duration; the selected day is a working day; the selected staff member is assigned to the service and has working hours; the date is not blocked; and the requested time meets the notice and buffer rules. Check the WordPress timezone under Settings → General. Existing appointments block overlapping time for that staff member, not every staff member.

Customers do not receive email

Check that the customer email is valid, the relevant email type is enabled, and the sender settings are correct. Test wp_mail() delivery through your mail host or SMTP provider, then inspect spam and delivery logs. Review invitation emails are only triggered when the status changes into Completed; the appointment date does not delay the invitation.

Online payment fails

Check that the selected gateway is enabled, credentials match Sandbox/Test or Live mode, and the currency is supported by the merchant account. For Stripe, check webhook configuration and delivery. For PayPal, use a Sandbox buyer and business account for test transactions. Confirm that the required payment method is enabled in the booking settings.

Google Calendar does not update

Check the client ID, client secret, authorized redirect URI, Calendar API enablement, and account authorization. Reconnect after changing OAuth credentials. WP-Cron must run to process queued calendar updates; review the WordPress Cron status or configure a server cron.

PDF export is unavailable or fails

Ask your host to enable the PHP DOM and mbstring extensions. Select a valid start and end date and confirm the date range contains pending or confirmed bookings.

A shortcode displays as plain text

Use a WordPress Shortcode block or a page area that executes shortcodes. Check the spelling and brackets, then confirm that ServiCal is active.

A booking link says it expired

For confirmation links, return to the confirmation page from the booking flow rather than reusing an old temporary link. Review links expire after 30 days and are one-time invitations. Customer dashboard access may require signing in with the account linked to the booking.

Frequently asked questions

FAQ

Does ServiCal require WooCommerce?

No. ServiCal stores and manages appointments in WordPress. WooCommerce is not required.

Can customers book more than one service at a time?

Yes. Multiple selected service prices and durations are combined for the booking.

Can several staff members offer the same time?

Yes. Availability is checked against the selected staff member's schedule and existing bookings, so a free staff member can remain bookable even if another staff member is occupied.

Can customers pay a deposit or pay the full amount?

When partial payment is enabled, online customers can choose the configured deposit or full payment. Pay at service is controlled separately in payment settings.

Does completing a future booking send a review email immediately?

Yes. The review invitation is triggered by the admin status change to Completed; it does not wait for the appointment date.

Can I change the booking reference prefix?

Yes. Set the prefix in the General or booking rules settings, then save. New booking references use the configured prefix.

Can I import services or demo content?

This guide covers the controls available in the plugin. Check the installed package's Help & Support tab and release notes for any import tools included in your version.

Interface reference

Admin and customer screenshots

These images illustrate the ServiCal settings and workflows represented in this guide. Select an image to open it at full size. Review screenshots before distributing this guide to make sure any visible demonstration records and account details are approved for publication.

General booking form appearance settings
Booking form appearance settings.
Booking form field labels, placeholders, and layout settings
Booking form labels, placeholders, and layout.
Special discount and coupon settings
Discount and coupon settings.
Customer booking email preview
Customer booking email preview.

Notices and licenses

Third-Party Libraries and Credits

ServiCal includes the third-party components listed below. Keep their license notices with the plugin when copying or redistributing it. Paths in the final column are relative to the plugin folder.

Library / componentVersionAuthor / projectOfficial sourceLicenseLicense file in plugin
Flatpickr4.6.13Flatpickr projectGitHub projectMITpublic/js/FLATPICKR-LICENSE.md
Dompdf3.1.6Dompdf CommunityGitHub projectLGPL-2.1includes/vendor/dompdf/LICENSE.LGPL
PHP Font Lib1.0.2Dompdf projectGitHub projectLGPL-2.1-or-laterincludes/vendor/dompdf/vendor/dompdf/php-font-lib/LICENSE
PHP SVG Lib1.0.2Dompdf projectGitHub projectLGPL-3.0-or-laterincludes/vendor/dompdf/vendor/dompdf/php-svg-lib/LICENSE
HTML5-PHP2.10.1MastermindsGitHub projectMITincludes/vendor/dompdf/vendor/masterminds/html5/LICENSE.txt
PHP CSS Parser8.9.0Sabberworm / MyIntervalsGitHub projectMITincludes/vendor/dompdf/vendor/sabberworm/php-css-parser/LICENSE
Composer generated autoloaderGenerated for bundled dependenciesComposer projectComposerMITincludes/vendor/dompdf/vendor/composer/LICENSE
DejaVu font files and metadataBundled by Dompdf; exact font build not independently verifiedDejaVu Fonts projectGitHub projectSee upstream DejaVu / Bitstream Vera / Arev license termsincludes/vendor/dompdf/vendor/dompdf/dompdf/lib/fonts/DejaVu-LICENSE.txt
Adobe Core 14 AFM filesBundled with DompdfAdobe font metric files distributed by DompdfDompdf projectAccompanying upstream notice appliesincludes/vendor/dompdf/vendor/dompdf/dompdf/lib/fonts/mustRead.html
Dompdf sRGB ICC profilesRGB2014 profile in Dompdf releaseInternational Color Consortium profileICCICC profile termsincludes/vendor/dompdf/vendor/dompdf/dompdf/lib/res/sRGB2014.icc.LICENSE

Provider-hosted SDKs and APIs

These are loaded from their providers only when the matching optional feature is used. Their SDK source files are not bundled in the plugin, so there is no third-party SDK license file inside the plugin ZIP. Provider terms and privacy policies apply.

Service / SDKVersionProvider / official sourceLicense or termsLocal license file
Stripe.jsv3 endpoint; provider-served versionStripeStripe service terms; see Stripe agreementNot bundled
PayPal JavaScript SDKProvider-served; loaded from the SDK URLPayPal DeveloperPayPal service terms; see PayPal user agreementNot bundled
Google Calendar API and OAuth 2.0Calendar API v3; provider APIGoogle DevelopersGoogle API terms and privacy policyNo Google client library bundled
Google reCAPTCHAProvider-served endpointGoogle DevelopersGoogle reCAPTCHA terms and privacy policyNot bundled

For the plugin's component inventory and bundled notices, see THIRD-PARTY-NOTICES.txt at the plugin root. ServiCal's own code is licensed under GPL-2.0-or-later; see the plugin header and LICENSE.txt.

Image and screenshot credits: the screenshots in this guide are captures of the ServiCal interface provided for this documentation. Any third-party photos used elsewhere on the demo site must keep their own source and license credit alongside the relevant asset.

Release history

Changelog

Version 1.0.0

  • Initial ServiCal release.
  • Service, category, staff, schedule, customer, and booking management.
  • Customer booking form, availability calendar, and account dashboard.
  • Optional Stripe, PayPal, and administrator Google Calendar integrations.
  • Configurable customer email notifications, reminders, discounts, review invitations, and moderation.
  • Booking and customer CSV export and date-filtered daily booking PDF export.

Back to the top ↑