Configuration
[TOC]
Overview
The OS Calendar Configuration page is accessible via Components → OS Calendar → Configuration or via the Configuration shortcut on the Dashboard. It is organised into six tabs.
Upgrade Tab
| Field |
Description |
| Download ID |
Enter the Download ID obtained from your account at joomdonation.com. Required for automatic updates via Joomla's built-in updater. |
Application Tab
Booking Settings
| Field |
Description |
| Enable Reservation |
Enable or disable the online booking feature globally. When disabled, the booking form is hidden from the front-end. |
| Enable Room |
Controls whether properties have multiple named rooms or are booked as a single unit. See below for details. |
| Only Registered Users Can Book |
When set to Yes, only logged-in Joomla users can submit a booking request. Guests will be asked to log in first. |
Understanding the Enable Room Setting
Enable Room = No (default)
Bookings are made directly against the OS Property property as a whole. You do not manage rooms in the OS Calendar back-end. However, OS Calendar still creates one representative room internally for each property in order to store pricing and availability data. This representative room is transparent to the customer — they simply book the property.
Enable Room = Yes
The property can have multiple distinct bookable rooms. You manage these rooms in Manage Rooms, setting a name, capacity, photo, and individual price and availability for each. On the front-end, the customer selects which room they want to book.
Cancellation Policy
| Field |
Description |
| Allow Cancel the Booking Request |
Allow customers to cancel their own confirmed bookings from the front-end (My Orders page). |
| Allow Cancel Before (days) |
The minimum number of days before the check-in date within which cancellation is permitted. E.g. set to 3 to allow cancellation only if the check-in is more than 3 days away. |
Notifications
| Field |
Description |
| Send Notification |
When enabled, OS Calendar sends automated email notifications to the customer and site administrator when a booking is submitted, confirmed, or cancelled. |
Special Notes
| Field |
Description |
| Special Notes |
Free-text notes or instructions shown on the booking confirmation page. Useful for house rules, check-in procedures, etc. |
Date & Time Formats
| Field |
Description |
| Date Format |
The date format used throughout the component (e.g. Y-m-d, d/m/Y). |
| Time Format |
The time format used throughout the component (e.g. H:i, h:i A). |
Payment Tab
| Field |
Description |
| Currency |
Default currency code displayed in the booking form and order details (e.g. USD, EUR). |
| Currency Format |
Currency symbol or code displayed next to prices (e.g. $, €). |
| Use SSL for Payment |
Force HTTPS for the payment confirmation page. Recommended when using real payment gateways. |
| Use CAPTCHA |
Enable CAPTCHA on the booking form to prevent spam submissions. |
Pricing Tab
| Field |
Description |
| Tax Rate (%) |
Default tax percentage applied to all booking orders. |
| Include Tax in Price |
When enabled, prices displayed to the customer already include tax. |
| Minimum Nights |
Minimum number of nights required for a booking. |
| Maximum Nights |
Maximum number of nights allowed for a single booking. |
Other Tab
| Field |
Description |
| Date Search in Property Types |
Restrict the availability date search to selected property types only. |
| Real Time Offset (hours) |
Time zone offset in hours relative to server time. Used for accurate current-date calculations. |
Invoice Tab
| Field |
Description |
| Invoice Prefix |
Prefix added to invoice numbers (e.g. INV-). |
| Show Invoice |
Show or hide the invoice download link on the order detail page. |
| Invoice Notes |
Custom notes printed at the bottom of the PDF invoice. |
| Company Name / Address / Phone / Email / Logo |
Company information printed on PDF invoices. |
After making changes, click Save (or Apply to save without closing) in the toolbar.