WordPress + WooCommerce Plugin

Appointment WooCommerce Plugin Documentation

This documentation explains how to install, configure and use the Appointment WooCommerce Plugin to sell appointment-based services directly through WooCommerce.

Checkout Booking

Customers can select an available date and time directly during WooCommerce checkout.

Smart Availability

Define working days, working hours, breaks and unavailable periods from the admin panel.

Auto Confirmation

The plugin waits for payment confirmation before permanently confirming the booking.

1. Overview

The Appointment WooCommerce Plugin allows store owners to sell services that require date and time scheduling. It integrates directly with WooCommerce, so customers can book an appointment while completing their order.

The plugin can be used for:

Online sessions
Consultations
Therapy appointments
Spiritual services
Coaching calls
Any service that requires scheduled availability

2. Main Features

Calendar and time selection in WooCommerce checkout
Enable appointment booking per product
Manage weekly availability
Add breaks for each day
Prevent double bookings
Temporary reservation system
Automatic booking confirmation based on order status
Automatic cancellation if payment is not completed
Admin bookings page
Custom checkout texts
Custom button and slot styles

3. Installation

Upload the plugin folder to your WordPress plugins directory.
Go to WordPress Admin → Plugins.
Activate Appointment WooCommerce.
Go to Appointments → Settings.

/wp-content/plugins/appointment-woocommerce/

4. Enable Booking on a Product

To show the booking calendar at checkout, the product must be marked as an appointment product.

Go to Products.
Edit the product.
Enable the appointment option.
Update the product.

The plugin uses the product meta key:

_aw_enable = 1

The booking calendar will only appear at checkout when the cart contains at least one appointment-enabled product.

5. General Settings

Go to:

Appointments → Settings → General

In this section you can configure:

Slot duration
Calendar position on checkout

Slot Duration

Defines the length of each available appointment slot. Example: if the working time is from 09:00 to 12:00 and the slot duration is 60 minutes, the available times will be 09:00, 10:00 and 11:00.

Checkout Position

You can display the calendar in different checkout areas:

Before billing fields
After billing fields
After customer details
Before payment

6. Schedule Settings

Go to:

Appointments → Settings → Schedule

Here you can configure availability for each day of the week.

Mark a day as closed
Set start time
Set end time

Closed days will not be available in the calendar.

7. Breaks

Go to:

Appointments → Settings → Breaks

Breaks allow you to block periods inside a working day.

Example:

Working Hours	Break	Available Slots
09:00 - 17:00	12:00 - 13:00	All slots except 12:00 - 13:00

8. Text Customization

Go to:

Appointments → Settings → Texts

You can customize the text shown to customers during checkout.

Appointment title
Subtitle
Available times title
Select date text
Select time text
Loading text
No times available text
Apply button text
Selected appointment text

This makes the plugin easy to translate and adapt to different languages.

9. Style Settings

Go to:

Appointments → Settings → Styles

You can customize the visual appearance of the booking area.

Button background color
Button text color
Time slot background color
Time slot text color
Selected time slot background
Selected time slot text color
Border radius

These settings allow the booking calendar to match the design of your website.

10. How the Booking Flow Works

Customer adds an appointment product to the cart.
Customer goes to checkout.
The booking calendar appears.
Customer selects a date and time.
Customer places the order.
The booking is saved as pending.
The plugin waits for payment/order confirmation.
If the order is paid, the booking is confirmed.
If the order fails or is cancelled, the booking is released.

11. Booking Status System

The plugin uses a dedicated booking status to control availability.

aw_booking_status

Status	Meaning
`pending`	The time slot is temporarily reserved.
`confirmed`	The payment/order was confirmed and the booking is active.
`cancelled`	The booking was cancelled and the time slot is available again.

12. Payment Waiting System

When an order is created, the appointment is not immediately confirmed. The plugin first saves it as:

pending

Then the plugin schedules an automatic check using WordPress Cron.

aw_check_pending_booking

After approximately 2 hours, the plugin checks the WooCommerce order status.

WooCommerce Order Status	Booking Result
Processing	Booking confirmed
Completed	Booking confirmed
Pending payment	Booking cancelled
Failed	Booking cancelled
Cancelled	Booking cancelled
Refunded	Booking cancelled

Cancelled bookings release the time slot, allowing another customer to book it.

13. Bookings Admin Page

Go to:

Appointments → Bookings

The bookings page displays:

Order number
Appointment date
Appointment time
Booking status
Customer name
Customer email
Customer phone
WooCommerce order status

14. Developer Information

Order Meta Keys

aw_date
aw_time
aw_booking_status

Product Meta Key

_aw_enable

Custom Slots Endpoint

/?aw_get_slots=1

Main WooCommerce Hooks

woocommerce_checkout_process
woocommerce_checkout_create_order
woocommerce_checkout_order_processed

WordPress Cron Hook

aw_check_pending_booking

15. Troubleshooting

The calendar does not appear

Make sure WooCommerce is active.
Make sure the product has appointment booking enabled.
Make sure the product is in the cart.
Make sure you are on the checkout page.

No time slots are available

Check the schedule settings.
Make sure the selected day is not closed.
Check if breaks are blocking the selected time.
Check if the slots are already booked.

Booking is not confirmed immediately

This is expected behavior. The plugin waits for the order/payment status before confirming the appointment.

Automatic cancellation did not run

The plugin uses WordPress Cron. WordPress Cron depends on website visits. On low-traffic websites, scheduled tasks may run later than expected.

16. Future Improvements

Email notifications for admin and customer
WhatsApp notifications
SMS notifications
Google Calendar integration
Multiple staff members
Timezone support
Advanced booking filters
Manual booking confirmation

17. Support

For support, installation help or custom development, please contact the plugin developer.

Developer: Hedomi
Plugin: Appointment WooCommerce Plugin