WPCalibrate Hotel Booking Manager

Enterprise-grade hotel, room inventory, rate plans, pricing, multi-property reservations, availability calendar, and guest management system for WordPress.

🏨 About

WPCalibrate Hotel Booking Manager is a high-performance, production-ready WordPress plugin engineered specifically for hotel chains, boutique property operators, and multi-hotel hospitality businesses. It enables centralized management of multiple properties, room categories, rate plans, pricing rules, real-time availability, reservations, and guest communications from a single WordPress installation—with zero mandatory WooCommerce dependency.

Designed from the ground up for speed, reliability, and precision, the plugin features an atomic SQL inventory locking engine to prevent double bookings, immutable financial ledgers for compliance and accounting, and a modular architecture that adapts seamlessly from single-property inns to enterprise multi-hotel hospitality groups.

⚡ Key Features

🏢 Multi-Property Hospitality Management

• Independent Hotel Profiles: Manage one or dozens of hotel properties with isolated addresses, contact points, coordinates, timezones, local currencies, check-in/out policies, and tax rates.
• Granular Staff Permissions: Assign Hotel Managers and Hotel Staff to specific properties with scoped capabilities. Restricted managers can only view and operate their assigned hotels.
• Hierarchical Amenities: Pre-seeded taxonomy of standard hotel facilities (Wi-Fi, swimming pool, fitness center, spa, parking) and room amenities (king-size bed, private balcony, climate control).

🛏️ Room Type & Inventory Architecture

• Room Types & Bed Configurations: Manage bookable room categories with physical room capacities, adult/child occupancy limits, and amenity checklists.
• Double-Booking Protection Engine: Conditional atomic database queries prevent race conditions when concurrent guests book the final remaining room:

  UPDATE wp_wpchbm_inventory
  SET hold_quantity = hold_quantity + %d
  WHERE room_type_id = %d AND date = %s
    AND (base_quantity - booked_quantity - hold_quantity) >= %d

• Temporary Checkout Holds: 15-minute tokenized hold locking with dual-layer cleanup (scheduled background WP-Cron and opportunistic garbage collection on public availability search).

💰 Authoritative Dynamic Pricing Engine

• Seasonal Date Overrides: Custom nightly base rates with holiday and weekend seasonal adjustments.
• Multi-Plan Multipliers: Flexible vs. Non-Refundable rate plans with customizable discount multipliers (e.g. 10% off for non-refundable).
• Extra Guests & Add-On Services: Configurable adult/child extra guest surcharges and add-on services (daily breakfast, airport transfer, parking, pet fees).
• Authoritative Immutability: All confirmed reservations store an immutable JSON snapshot of calculated pricing (pricing_snapshot), guaranteeing historical booking accuracy regardless of future rate changes.

💳 Financial Ledger & Payment Subsystem

• Immutable Payment Transactions: Dedicated SQL ledger (wp_wpchbm_payments) tracking deposits, balance collections, gateway transaction IDs, and idempotency keys.
• Flexible Gateways: Built-in Stripe (PaymentIntents API with webhook validation), PayPal (Orders v2 API with webhook capture), and Offline / Pay at Hotel.
• Deposit & Split Payments: Support for 100% full payment, percentage deposits, or fixed amount deposits with in-context balance settlement upon check-in.
• Manual Payments & Ledger Reconciliation: Front-desk manual payment collection modal with opportunistic backfilling of historical bookings.

📊 Modern Administrative Operations

• Interactive 14-Day Rates Matrix: Horizontal scroll-bounded grid with sticky room type header, real-time availability counters, base quantity inputs, blackout stop-sell toggles, and 1-click starter room generation.
• Visual Booking Calendar: Monthly availability manifests with property filtering, day-by-day guest manifests, and status badges.
• Guest CRM & Manifests: Unified guest directory tracking total stays, lifetime value, contact information, and reservation history.
• Overview & Onboarding Walkthrough: 6-step interactive guide, architecture reference, and blocks/shortcodes directory.

🔄 In-Dashboard Updates

• Native GitHub Updater: Direct integration with GitHub Releases. WordPress automatically notifies administrators of new versions and performs 1-click updates from the WordPress dashboard without third-party updater plugins.

📚 Documentation & How to Use

Installation

Method 1: WordPress Dashboard Upload (Recommended)

1. Download wpcalibrate-hotel-booking-manager-1.0.5.zip from the Releases page.
2. In your WordPress admin dashboard, go to Plugins → Add New Plugin → Upload Plugin.
3. Choose the ZIP file and click Install Now.
4. Click Activate Plugin.

Method 2: Manual FTP / SFTP Installation

1. Extract the wpcalibrate-hotel-booking-manager directory.
2. Upload the folder to /wp-content/plugins/ on your WordPress server.
3. In WordPress admin, go to Plugins → Installed Plugins and activate WPCalibrate Hotel Booking Manager.

In-Dashboard Updates

This plugin includes native integration with GitHub Releases:

• Whenever a new release tag (e.g. v1.0.6) is published on this repository, WordPress detects the update during standard background checks.
• An update notification badge will appear in your WordPress dashboard under Dashboard → Updates and Plugins.
• You can click "Update Now" or click "View version details" to view changelog release notes directly inside WordPress.

Shortcode Directory

Embed booking flows on any page or builder template using these shortcodes:

Gutenberg Blocks

1. Open any page or post in the WordPress Block Editor.
2. Click the block inserter (+) and search for "Hotel Booking".
3. Select from available blocks:
   • Hotel Search Bar
   • Hotel Directory Showcase
   • Booking Checkout
   • Booking Confirmation

Administrative Workflow (6-Step Quickstart)

1. Add Hotel Property: Navigate to Hotels → Add New. Enter property name, address, contact details, currency, check-in/out policies, and select Hotel Amenities.
2. Configure Room Types: Go to Room Types → Add New (or use the 1-click starter generator inside Rates Matrix) to define capacities, bed layouts, and pricing.
3. Set Rates & Availability: Open WPCalibrate → Rates & Availability to review the 14-day grid, adjust physical room counts, or apply stop-sell closures.
4. Configure Payment Gateways: Go to WPCalibrate → Settings → Payments and enable Stripe, PayPal, or Pay at Hotel / Offline payment.
5. Set Email Notifications: Open WPCalibrate → Settings → Emails to customize transactional email triggers for guests and admin staff.
6. Publish Booking Page: Create a public booking page with [wpchbm_booking_search] or [wpchbm_hotel_directory].

📋 Changelog

[1.0.5] - 2026-10-10

• Added: In-context + Create Custom Room Type CTA and ⚡ 1-Click: Quick-Generate Starter Room Types inside Rates & Availability Matrix (provisions Standard Room & Deluxe Suite with 30-day inventory).
• Added: Smart hotel preselection and auto-assignment for single-hotel WordPress environments.
• Added: Full payment ledger ingestion for Offline Gateway and manual reservations (wp_wpchbm_payments).
• Added: + Record Manual Payment modal in Payments log and in-context Record Payment / Collect Balance action in Reservations.
• Added: Opportunistic ledger auto-reconciliation backfilling transactions from existing confirmed bookings.
• Fixed: Redesigned multi-property search bar layout with dedicated fields for Adults, Children, and Rooms.
• Added: Instant Room Selection Picker card in [wpchbm_booking_checkout] for standalone/cold-start visits.
• Added: Booking Lookup Card in [wpchbm_booking_confirmation] enabling guest lookup by Reference and Email without URL tokens.
• Added: Pre-seeded 15 default hotel amenities and 12 room amenities upon plugin activation and init.
• Added: Dedicated admin submenus for — Hotel Amenities and — Room Amenities.
• Added: Native in-dashboard GitHub release updater (GitHubUpdater) supporting 1-click updates from WordPress admin.

[1.0.4] - 2026-10-10

• Fixed: Normalized header branding logo to 28×28px across all admin tab headers.
• Added: Inline <head> CSS styling and cache-busting version bump to prevent browser asset caching delays.

[1.0.3] - 2026-10-10

• Fixed: Redesigned Rates & Availability matrix into a 2120px min-width horizontal scroll wrapper.
• Added: Sticky pinned Room Type column and structured daily cells into spacious Day Cards.
• Enhanced: Modernized tab navigation, date steppers, and toolbars across all administrative tabs.

[1.0.2] - 2026-10-10

• Fixed: Admin sidebar menu icon sizing strictly constrained to 20×20px matching native WordPress palette and hover transitions.

[1.0.1] - 2026-10-10

• Added: Comprehensive Overview Tab with 6-step walkthrough, architecture reference, and blocks/shortcodes directory.
• Added: Automated FTP synchronization tooling.

[1.0.0] - 2026-10-10

• Initial Release: Multi-property management, atomic inventory holds, Stripe/PayPal/Offline gateways, interactive calendar, Gutenberg blocks, and shortcodes.

📄 License

This plugin is free and open-source software, licensed under the terms of the GNU General Public License v2.0 or later. Copyright © 2026 WPCalibrate.

💬 Support & Inquiries

• Author: WPCalibrate
• Support Portal: https://wpcalibrate.com/support
• Documentation: https://docs.wpcalibrate.com
• Issues & Contributions: GitHub Issues