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 seven 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, customers cannot make reservations. |
| Operation Mode |
Standalone (default): manage your property directly in OS Calendar; OS Property is not needed. Linked: synchronise properties with OS Property. See Operating Modes. |
| Only Registered Users Can Book |
When set to Yes, only logged-in Joomla users can submit a booking request. Guests will be prompted to log in or register before proceeding. |
Cancellation Policy
| Field |
Description |
| Allow Cancel the Booking Request |
Allow customers to cancel their own bookings from the front-end (My Orders / My Bookings page). The refund amount follows the Cancellation Policy of the rate plan (see Cancellation Policies). |
| 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 form (step 1) and 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 Symbol Position |
Show the currency symbol before or after the amount, or hide it. |
| Money Format |
Number format applied to every amount shown on the front-end, in emails and in invoices: 1 000 000.00, 1 000 000,00, 1.000.000,00 or 1,000,000.00. |
| 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 |
Only relevant when OS Property is installed. Restricts the availability date search to selected OS Property property types. |
| 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. |
Custom CSS Tab
| Field |
Description |
| Custom CSS |
Your own CSS rules. When you save, they are written to media/com_oscalendar/assets/css/custom.css. If that file is not empty, it is loaded automatically on every OS Calendar front-end layout after the default stylesheet, so your rules override it. |
The former Enable Card Types and Use HTTPS options were removed: payment gateways now support all card types, and HTTPS is determined by your site URL.
After making changes, click Save (or Apply to save without closing) in the toolbar.