Booking Form

[TOC]

Overview

The Booking Form is the front-end interface that customers use to submit a booking request for a property or room. It is presented after the customer selects check-in and check-out dates on the availability calendar.

Booking Flow

The booking process follows these steps:

  1. Select dates — The customer selects a check-in date and a check-out date on the availability calendar displayed on the property detail page.
  2. Choose a room (if rooms are enabled) — The customer selects an available room from the drop-down list.
  3. Fill in the booking form — The customer enters personal details and any extra field information.
  4. Confirm and pay — The customer reviews the booking summary and selects a payment method.
  5. Payment gateway — The customer is redirected to the selected payment gateway (e.g. PayPal) to complete payment.
  6. Confirmation — After payment, the customer is redirected back to a confirmation page showing the order details and status.

Booking Form Fields

The standard booking form includes the following fields:

Field Description
Property Name Read-only display of the booked property.
Room Name Read-only display of the selected room (if rooms are enabled).
Check-in Date Read-only display of the selected check-in date.
Check-out Date Read-only display of the selected check-out date.
Number of Nights Automatically calculated from the date selection.
First Name Customer's first name (required).
Last Name Customer's last name (required).
Email Customer's email address (required). Used for order confirmation emails.
Phone Customer's phone number.
Address Customer's address.
Number of Adults Number of adult guests.
Number of Children Number of child guests.
Notes Free-text area for special requests or additional information.
CAPTCHA Optional CAPTCHA field (enabled via Configuration).
Extra Fields Any additional custom fields defined in the Extra Fields manager.

Booking Summary

Below the form, a Price Summary section shows:

Item Description
Subtotal Number of nights × nightly rate
Tax Calculated at the tax rate from Configuration
Total Grand total including tax

Payment Method Selection

Published payment plugins are displayed as selectable options (radio buttons or cards). The customer selects one payment method before submitting the form.

Order Confirmation Page

After successful submission and payment, the customer sees an order detail page showing:

  • Order ID and status badge
  • Property and room details
  • Check-in / check-out dates
  • Guest information
  • Price breakdown (subtotal, tax, total)
  • Payment method
  • Print button

Cancellation from the Front-end

If the Allow Cancel the Booking Request option is enabled in Configuration and the check-in date is still within the cancellation window, the customer will see a Cancel button on the order detail page. Clicking it will cancel the booking and trigger a cancellation notification email.

Registered Users vs. Guests

  • If Only Registered Users Can Book is set to Yes in Configuration, only logged-in Joomla users can submit the booking form. Guests see a login prompt instead.
  • If set to No, any visitor can submit a booking form.

Tip: Pre-populate the first name, last name, and email fields for logged-in users by configuring the user profile mapping in OS Calendar. This reduces friction and improves the booking conversion rate.