Official Technical & Operational Reference Manual
Modern Hotel Booking User Guide: Complete Reference Manual
This single-page reference manual consolidates all 8 operational parts of Modern Hotel Booking: Quick-Start Setup, 3-Tier Edition Matrix, Shortcodes & Gutenberg Blocks, Payment & USALI Folio Accounting, 2-Way iCal Channel Sync, Front Desk Tablet Mode, AI Concierge & Abilities API and WP-CLI / REST API Developer Reference.
Access the full uncompressed guide formatted for quick searching and offline review.
Part 1: 5-Minute Quick-Start & 3-Tier Edition Architecture
- Install & Activate: Install Modern Hotel Booking from WordPress.org (Free Core) or upload your Starter ($49.99/yr) or Pro ($89.99/yr) ZIP archive under Plugins → Add New → Upload Plugin.
- Configure Hotel Timezone, Currency & Notification Emails: Navigate to Hotel Booking → Settings → General. Set your city timezone, currency symbol, global minimum/maximum stay rules and Primary/CC Operational Notification Emails (included in Free, Starter and Pro with automatic fallback to your WordPress admin email).
- Create Room Types & Physical Units: Open Hotel Booking → Room Types, define your categories, base nightly rates and adult/child capacities and generate individual physical units under Rooms.
- Embed Booking Blocks: Add the Room Calendar, Booking Form and Guest Portal Gutenberg blocks (or shortcodes) to your reservation pages.
Need step-by-step screenshots? See Getting Started and Room Setup.
Part 2: All 8 Gutenberg Blocks & 12 Shortcodes (All Tiers)
| Component | Gutenberg Block Slug | Shortcode & Key Attributes |
|---|---|---|
| 1. Room Availability Calendar | modern-hotel-booking/room-calendar | [mhbo_room_calendar room_id="1" show_prices="true"] |
| 2. Direct Booking Form & Search | modern-hotel-booking/booking-form | [mhbo_booking_form room_type="all"] |
| 3. Hotel Company Info Card | modern-hotel-booking/company-info | [mhbo_company_info] |
| 4. AI Concierge Chat Widget | modern-hotel-booking/ai-chat-widget | [mhbo_ai_concierge mode="floating"] |
| 5. WhatsApp Booking Button | modern-hotel-booking/whatsapp-button | [mhbo_whatsapp] |
| 6. IBAN Banking Details Card | modern-hotel-booking/banking-details | [mhbo_banking_details] |
| 7. Revolut Payment & QR Card | modern-hotel-booking/revolut-details | [mhbo_revolut_details] |
| 8. Hotel Business Card | modern-hotel-booking/business-card | [mhbo_business_card] |
| 9. Guest Self-Service Portal | Shortcode only (Free) | [mhbo_guest_portal] |
| 10. Rooms Showcase & Payment Info | Shortcodes only (Free) | [mhbo_rooms] / [mhbo_payment_methods] |
| 11. Balance Payment Collection | Shortcode only (Pro) | [mhbo_balance_payment] |
Part 3: 4-Tier Staff Privilege Roles & Front Desk Operations
Modern Hotel Booking provisions dedicated WordPress roles so receptionists and housekeepers never need full Administrator access:
- Hotel Manager (
mhbo_hotel_manager): Full access to rooms, bookings, pricing rules, payment gateways, iCal sync and revenue analytics. - Front Desk Receptionist (
mhbo_front_desk): Access to Front Desk Live Tablet Mode, Tape Chart, Manual Walk-In Reservation Desk, check-in/check-out and folio tender collection. - Housekeeper (
mhbo_housekeeper): Restricted access to the Housekeeping Operational Board to update room cleaning statuses (Dirty, Clean, Inspected, Out of Order).
Part 4: REST API Namespaces, Webhooks & 17 WordPress Abilities
All asynchronous frontend operations run through /wp-json/mhbo/v1/ using WP_REST_Controller endpoints. Pro Edition also exposes HMAC-SHA256 outgoing webhooks (booking.confirmed, booking.cancelled, payment.received) and registers 17 contract-driven WordPress Abilities under the modern-hotel-booking namespace for AI agent and Model Context Protocol (MCP) discovery.
