=== Modern Hotel Booking — AI Concierge & Direct Bookings ===
Contributors: leslierad
Donate link: https://startmysuccess.com/
Tags: hotel booking, vacation rental, ical, booking calendar, accommodation
Requires at least: 6.6
Tested up to: 7.0.1
Stable tag: 2.4.5
Requires PHP: 8.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Free hotel booking system for vacation rentals & B&Bs. Includes iCal sync for Airbnb, a booking calendar, and an AI Concierge virtual receptionist.

== Description ==

**Modern Hotel Booking** is a professional **hotel booking** and **vacation rental** system for WordPress. It is designed specifically for guesthouses, B&Bs, and boutique hotels looking for a commission-free **accommodation** reservation engine.

This plugin provides a complete **booking calendar** with real-time availability. Stop paying 15-25% to OTAs and take direct bookings on your own website. With built-in **iCal** support, you can synchronize your property across Airbnb, Booking.com, and VRBO seamlessly.

### 🤖 Free AI Concierge — Your 24/7 Virtual Receptionist
The first **hotel booking** plugin to offer a built-in **AI Concierge**. Your virtual receptionist answers guest questions about amenities, pricing, and house rules using your property data, guiding guests through the entire **vacation rental** reservation process.

### 💰 Direct Bookings — Keep 100% of Your Revenue
*   **Hotel Booking Logic**: Optimized for per-night stays and guesthouse management.
*   **Booking Calendar**: A colour-coded, AJAX-powered calendar block for real-time availability.
*   **iCal Sync**: Automatic synchronization with external OTA platforms (Pro).
*   **Stripe & PayPal**: Professional checkout for secure guest payments (Pro).

### 💰 Modern Hotel Booking vs Airbnb / Booking.com

* **Commission per booking:** 0% vs 15–25%
* **Guest data ownership:** ✅ Yours forever vs ❌ Theirs
* **AI Concierge Receptionist:** ✅ Free vs ❌ Not available
* **Professional Invoicing:** ✅ Pro vs ❌ Not available
* **Setup fees:** None 

### 📋 Complete Free Feature Set

**Property & Room Management**
* Unlimited Room Types — setup categories for rooms, units, or apartments
* Individual Room Management — assign units to types with custom availability
* Min/Max Night Stay Rules — set stay requirements globally or per room
* Same-Day Turnover — automated logic for check-in/check-out times

**Booking Engine & Calendar**
* **Availability Calendar**: Responsive Gutenberg block with real-time room status
* AJAX Booking Form: Live price calculation as guests select dates
* Automated Notifications: Custom email templates for confirmations

**8 Native Gutenberg Blocks & Shortcodes**
* Hotel: Booking Form — Price calculator & reservation flow
* Hotel: Room Calendar — Per-room availability view
* Hotel: Company Profile — Your property identity
* Specialized Blocks: WhatsApp Chat, Bank Transfer Details, and Revolut Pay
* Full Shortcode Support: `[mhbo_booking_form]`, `[mhbo_room_calendar]`, and more

**Privacy & Performance**
* Zero-Trace Architecture — no tracking, no data sent to our servers
* Multilingual: WPML, Polylang & qTranslate-X compatible (15 languages)
* Mobile-First: Fully responsive **booking calendar** and form

### 🏆 Modern Hotel Booking Pro

**Online Payments & OTA Sync**
*   **Stripe & PayPal**: Credit cards, Apple/Google Pay with 3D Secure support
*   **Two-Way iCal Sync**: Automatic sync for Airbnb, Booking.com, and VRBO
*   **Coupon System**: (New in 2.3.8) Create fixed or percentage discounts for guests

**Advanced Pricing & Rules**
*   **Seasonal Rates**: Custom pricing for any date range or holiday
*   **Weekend Multipliers**: Automated Friday/Saturday price modifiers
*   **Stay Limits**: Global property-wide minimum and maximum night constraints
*   **Calendar Override**: Bulk-set prices across room types and dates

**Analytics & Compliance**
*   **Business Intelligence**: ADR, RevPAR, and Occupancy Rate KPIs
*   **Tax Engine**: VAT Inclusive and Sales Tax Exclusive modes
*   **GDPR Suite**: Consent checkboxes and automated PII erasure tools
*   **AI Logs**: Review anonymised conversation transcripts and sentiment analysis

[View Pro Features & Pricing](https://startmysuccess.com/) | [Privacy Policy](https://startmysuccess.com/privacy-policy/) | [GitHub](https://github.com/)

### 🏡 Built for Independent Properties

* **Guesthouses** — per-night booking logic, WhatsApp, and professional invoicing
* **Bed & Breakfasts (B&Bs)** — min-stay rules, email automation, AI guest support
* **Vacation Rentals** — standalone property management with zero OTA dependency
* **Cabins & Cottages** — seasonal pricing, deposits, and **iCal** sync
* **Boutique Hotels** — multi-room availability engine with real-time calendar

== Installation ==

1. Go to Plugins > Add New in your WordPress admin.
2. Search for "Modern Hotel Booking".
3. Click Install Now and then Activate.

== Quick Start in 5 Steps ==

1. Hotel Booking > Room Types — Create your room or unit categories with base price and capacity
2. Hotel Booking > Rooms — Add individual rooms or units and assign each to a Room Type
3. Hotel Booking > Settings > General — Select your Booking Page from the dropdown
4. Edit any page — Add the Hotel: Booking Form Gutenberg block, or use the shortcode [mhbo_booking_form]
5. (Optional) Hotel Booking > Settings > AI — Paste your free Google Gemini API key to activate your AI Concierge instantly

== Frequently Asked Questions ==

= Is this plugin completely free? =
Yes. The entire core system — AI Concierge, unlimited room management, real-time availability calendar, email notifications and all 8 Gutenberg blocks — are 100% free. No limits on bookings, rooms or guests. No hidden transaction fees.

= How does the AI Concierge work? =
The AI reads the data you enter in your Room Types and Settings and uses it to answer guest questions in real time. You connect your own free Google Gemini or OpenAI API key. No coding required.

= Can I take direct bookings without Airbnb or Booking.com? =
Yes. Modern Hotel Booking is built specifically for the direct booking model. Guests book on your WordPress site and you keep 100% of the revenue. The Pro version adds optional two-way iCal sync.

= Does it prevent double-bookings with Airbnb? =
The free version supports manual date blocking. The Pro version adds automatic two-way iCal sync with Airbnb, Booking.com, VRBO, and Google Calendar.

= Where do I get the Pro version? =

Visit [StartMySuccess.com](https://startmysuccess.com/) for all Pro features, pricing, and licensing. All plans include updates and priority support.

== Screenshots ==

1. Hotel Booking Form — Responsive, mobile-friendly design with real-time availability and live price calculation.
2. Booking Dashboard — Complete overview of upcoming reservations, revenue, and guest management.
3. Room & Property Management — Configure unlimited room types, capacity, pricing, and availability rules.
4. Real-Time Availability Calendar — Colour-coded interactive calendar showing live room availability and bookings.
5. Plugin Settings Panel — Full configuration for email notifications, currencies, booking rules, and AI Concierge setup.

== Changelog ==

= 2.4.5 =
* **MOD (Free & Pro)**: Improved translation plugin compatibility WPML, Polylang and added Bogo translate compatibility.

= 2.4.4 =
* **NEW (Free & Pro)**: Atomic Availability Locking using MySQL native locks (`GET_LOCK`) for high-concurrency booking environments.
* **MOD (Free & Pro)**: Improved mobile responsiveness and styling for the Booking Modal (Coupon Section and Tax Breakdown Table).
* **MOD (Free & Pro)**: Updated bundled FullCalendar library to v7.0.0.
* **FIX (Free & Pro)**: AI Concierge: Abilities API Category Description Fix to prevent PHP notices when registering categories on WP 6.9+.
* **FIX (Free & Pro)**: AI Concierge: Abilities API Callback Self-Containment to prevent client integration breakage on WP 7.0+.
* **FIX (Free & Pro)**: AI Concierge: Chat REST API Tool Call Array Safety to prevent PHP warnings.
* **FIX (Free & Pro)**: AI Concierge: Reset Engine Transients parity to clear dynamic fallback model chains.
* **FIX (Free & Pro)**: Frontend: Avoid printing empty grid container divs on room search results when there are no rooms.
* **FIX (Pro)**: iCal High-precision parsing to ensure dates never shift in positive UTC offsets.

= 2.4.2 =
* **FIX (Free & Pro): Abilities Explorer Visibility** — Resolved an issue with the Abilities Explorer not showing AI Abilities. The internal name of registered abilities is no longer corrupted by the 'name' property override in the WordPress 7.0+ Abilities API.

= 2.4.1 =
* **FIX (Free & Pro): Check-in/Check-out Time Consistency** — Resolved an issue where admin-configured check-in and check-out times from Settings > General were not reflected in guest emails, iCal (.ics) calendar attachments, the booking form summary panel, and AI Concierge responses. All surfaces now consistently read the saved settings instead of falling back to defaults.

= 2.4.0 =
* **NEW (Free & Pro): AI Concierge Flagship Release** — Refactored chatbot into state-aware "one room per turn" booking process.
* **NEW (Free & Pro): WP 7.0 Native Abilities Compliance** — Registered and grouped all 13 conversational AI capabilities as native WP 7.0 Abilities with REST exposure. Rebuilt SQLite-backed playground preview snapshots.
* **NEW (Pro): Adaptive License Verification Resilience** — Implemented dynamic check intervals (45 days to daily), automatic 3-stage backoff retries with 6-hour spacing, and loyalty-scaled grace periods (3–21 days) to prevent sudden feature lockout during temporary API/network dropouts.
* **NEW (Pro): iCal Resilience & Timezone Precision** — Implemented strict date parsing for UTC offset corrections, auto-cancellation of orphans, and cache-bypass feed headers. Added Travelminit & Szallas.hu detection.
* **MOD (Free & Pro): AI Model Migration** — Replaced retired `gemini-3.1-flash-lite-preview` model with `gemini-3.5-flash` (GA) across all fallbacks and primary connections. Updated Anthropic Sonnet default to `claude-sonnet-4-6` and added `claude-haiku-4-5` budget option. Expose `gpt-5.5` and `gpt-5.5-instant` reasoning configurations.
* **MOD (Free & Pro): Zero-Trust Security Audit & PHPStan Static Analysis Cleanup** — Enforced strict zero-trust unslashing and key-by-key sanitization for all superglobals across Analytics, Pricing, Shortcodes, Admin Menu, and AI settings. Achieving zero static analysis errors.
* **FIX**: Resolved Gemini payload "contents is not specified" API errors, GPT-5 reasoning effort scope, and direct SQL queries.

= 2.3.9 =
* **MOD (Free)**: Compiled and synchronized all translation assets across 15 standard locales.
* **MOD (Free)**: Refined production WordPress 7.0 and AI support.
* **MOD (Free)**: Updated integrated WordPress Playground snapshots and blueprints for previews.


== Upgrade Notice ==

= 2.4.4 =
Improved mobile responsiveness for the Booking Modal, AI model updates and connections, updated FullCalendar v7.0.0. Recommended for all users.

== Credits ==

Open-source libraries bundled locally — no external CDN requests:

* **FullCalendar** v7.0.0 — MIT License — [https://fullcalendar.io](https://fullcalendar.io)
* **Chart.js** v4.5.1 — MIT License — [https://www.chartjs.org](https://www.chartjs.org)
* **Flatpickr** v4.6.13 — MIT License — [https://flatpickr.js.org](https://flatpickr.js.org)

== Privacy Policy ==

Modern Hotel Booking does not collect or transmit guest or admin data to our servers. All booking data is stored locally in your WordPress database.

**AI Concierge:** When enabled, guest messages and property context are sent to your configured AI provider (Google Gemini or OpenAI) to generate responses. Conversation context is stored as WordPress Transients for up to 2 hours then automatically deleted. No PII is permanently stored by this plugin.

**Rate Limiting:** Anonymised per-IP request counts are stored as Transients (2-minute TTL) to prevent abuse. No IP addresses are permanently saved.

See our full [Privacy Policy](https://startmysuccess.com/privacy-policy/).

== External Services ==

All connections are optional and only active when configured by the administrator:

* **WhatsApp** — Communication links only. [Privacy Policy](https://www.whatsapp.com/legal/privacy-policy)
* **Revolut** — Payment links and QR codes. [Privacy Policy](https://www.revolut.com/legal/privacy)
* **Google Gemini / OpenAI** — AI Concierge responses during active chat only. [Google Privacy](https://policies.google.com/privacy) | [OpenAI Privacy](https://openai.com/privacy)

**Pro version only:**

* **Stripe** — Card, Apple Pay, Google Pay processing. [Privacy Policy](https://stripe.com/privacy)
* **PayPal** — Account payment processing. [Privacy Policy](https://www.paypal.com/webapps/mpp/ua/privacy-full)
* **iCal Sync** — Reads public calendar feeds. No data sent to our servers.
* **StartMySuccess** — License verification and Pro updates. [Privacy Policy](https://startmysuccess.com/privacy-policy/)