1. Overview — what this product is

Booking Pro is a premium niche WordPress theme for hotel, villa, tour, activity, car, and package businesses. Design, catalog listings, Customizer options, page templates, and marketing content live in the theme.

Booking System is a separate, independent plugin that provides the booking engine: availability, pricing, cart, checkout, payments, customers, coupons, taxes, reviews, wishlist, map search, reports, iCal, housekeeping, and notifications.

2. Architecture (how they connect)

┌─────────────────────────────────────────────────────────┐
│  WordPress site (http://localhost/test/)                │
│                                                         │
│  ┌──────────────────────┐   ┌─────────────────────────┐ │
│  │ Theme: booking-pro   │   │ Plugin: booking-system  │ │
│  │ prefix: BPro_ / bpro │   │ prefix: BS_ / bs_       │ │
│  │                      │   │                         │ │
│  │ CPT catalog + meta   │──▶│ reads item_type + id    │ │
│  │ templates / CSS      │   │ availability / pricing  │ │
│  │ Customizer UI        │   │ creates booking rows    │ │
│  └──────────────────────┘   └─────────────────────────┘ │
│              │                          │               │
│              └──────── front shortcodes ┘               │
│                                                         │
│  Staff Web Panel: /staff-panel/  (plugin BS_Staff_Panel) │
│  → WordPress login + role menus + admin view reuse      │
└─────────────────────────────────────────────────────────┘
  

Item type mapping

3. Requirements

Local paths (this project)

• Site: http://localhost/test/
• Theme: wp-content/themes/booking-pro/
• Plugin: wp-content/plugins/booking-system/

4. Installation (step by step)

5. First-run setup (recommended order)

1. Booking System → Settings — currency, emails, pages, gateways (see §23).
2. Appearance → Setup Demo — sample rooms, pages, and menus (see §6).
3. Appearance → Customize — enable and order homepage sections.
4. Settings → Reading — set Homepage to a static page (demo usually sets the Front Page).
5. Appearance → Menus — confirm the Primary menu (demo often attaches links).
6. Run one real booking test: Room single → dates → checkout → confirm it appears under admin Bookings.
7. Staff Web Panel — open /staff-panel/, log in as admin, confirm dashboard loads (see §35).

6. Demo content

Path: Appearance → Setup Demo (inc/demo-setup.php).

What typically gets installed

• Sample Rooms / Villas / Tours (plus traveler items if seeded)
• Sample Offers and Stay Packages (marketing CPTs)
• Homepage, About, Contact, Rooms, Booking, and related pages
• Page template assignments
• Menus, sample Customizer content, and section items
• Brand colors (linen / charcoal palette — see §16)
• Footer widget area footer-1 cleared (removes default Archives / Categories widgets)

Buttons

The plugin also offers seeding under Booking System → Tools → Seed demo data.

7. Marketplace package (selling the product)

Booking Pro v1.4.0 is packaged for commercial distribution. The theme alone is not enough — always ship the Booking System plugin in the same bundle.

What buyers receive

Recommended ZIP structure

booking-pro-bundle-v1.4.0.zip
├── booking-pro/              ← upload to wp-content/themes/
├── booking-system/           ← upload to wp-content/plugins/
├── documentation/
│   └── BOOKING-PRO-COMPLETE-GUIDE.html
└── LICENSE.txt

Before you publish

1. Update Theme URI and Author URI in style.css (replace https://bookingpro.theme with your store URL).
2. Run a fresh WordPress install test: theme + plugin → Setup Demo → one full booking.
3. Install the Theme Check plugin locally and fix any reported warnings.
4. Provide license terms (GPL theme + your commercial plugin license if applicable).
5. Host a live demo with both packages active.
6. Document the Staff Web Panel URL for buyers (/staff-panel/).

8. Theme-related admin menus

9. Catalog custom post types

Core

• bpro_room — supports title, editor, thumbnail, excerpt
• bpro_villa
• bpro_tour
• bpro_property — properties

Taxonomies (rooms example)

• bpro_room_type — Room Types
• bpro_room_category — categories
• Amenity-related taxonomies (see inc/post-types.php)

Single template location

Singles live in single-pages/:

• single-bpro_room.php
• single-bpro_villa.php
• single-bpro_tour.php
• single-bpro_activity.php
• single-bpro_car.php
• single-bpro_bundle.php

Loader: inc/setup.php → single_template filter.

Shared markup: template-parts/catalog/single.php (gallery, booking sidebar, reviews, wishlist, quick facts — controlled by Customizer toggles).

10. Content / marketing CPTs

File: inc/content-post-types.php

11. Room / Villa / Tour field groups

Fields are centralized. Room example: inc/rooms/class-room-fields.php. Meta prefix: _bpro_room_*. The plugin catalog layer reads price and inventory from these fields.

Room UI groups

Booking mode (all major catalog types)

• Instant book — booking status comes from the Instant book status setting (default: confirmed)
• Request to book — typically a pending / request flow

Map fields: Latitude, Longitude, Map address label — used by the Map Search shortcode.

12. Traveler types — Activities, Cars, Bundles

Files: inc/traveler/register.php, class-traveler-meta.php, frontend.php.

Activity (bpro_activity)

• Adult price, Child price
• Max guests per slot, Duration
• Available dates (one per line YYYY-MM-DD)
• Booking mode, lat/lng, meeting point

Car / Transfer (bpro_car)

• Price per day, optional one-way transfer price
• Fleet count, max passengers
• Vehicle type: sedan / SUV / van / luxury / airport transfer
• Booking mode and map fields

Travel Bundle (bpro_bundle → item_type package)

• Package pricing and linked inventory fields (see meta registration)
• Booked through the plugin package handlers

Front pages auto-created

• Activities → template page-activities.php
• Cars → page-cars.php
• Bundles → page-bundles.php
• Map & Wishlist → page-map.php

13. Homepage Section Manager

Appearance → Customize → Homepage Section Manager (priority ~30).

Section Order

Drag-and-drop order control. Stored as JSON in theme mod bpro_homepage_sections.

Per-section options (every section)

• Enable section checkbox
• Design variant select (Design 01, 02… auto-discovered from files)
• Content fields: title, subtitle, description, image, buttons, limits, columns, and more
• Hero: slides repeater (“Add new slide”)
• Some sections: items / gallery repeaters
• Color controls where registered

Available homepage sections

Design file convention

template-parts/sections/{section}/{section}-01.php
assets/css/sections/{section}/{section}-01.css

When you add a new design file, it appears automatically as a Customizer choice.

14. Innerpage Manager

Customize → Innerpage Manager — sections, titles, and colors per page template.

Covered templates include:

• About, Contact, FAQ, Gallery, Services, Amenities, Team, Testimonials
• Rooms, Villas, Tours listing pages
• Activities, Cars & Transfers, Travel Bundles
• Map & Wishlist, Booking, Destinations, Offers, Packages, Full width, and more

Listing pages often include a limit control (defaults 12 / 9).

CSS scope uses body classes such as bpro-page-rooms (see inc/innerpage-customizer.php).

15. Single Catalog Manager

Customize → Single Catalog Manager (priority ~31).

Types: Single Room, Villa, Tour, Activity, Car/Transfer, Travel Bundle.

Section toggles (every type)

Extras: CTA text, layout, titles, color controls. Body classes: bpro-single-room, bpro-single-activity, and so on.

16. Typography & global look

• Customize → Typography — fonts / sizes (inc/typography-customizer.php)
• Customize → Brand Colors — live CSS variables on the front page (inc/customizer.php)
• Design tokens: assets/css/global.css (CSS variables)
• Header / footer design variants under template-parts
• Google Fonts: Cormorant Garamond (display) + Outfit (body) — loaded from fonts.googleapis.com

Default color palette (v1.4.0 — linen / charcoal)

Demo setup and Customizer both seed these values. Buyers can override every color under Customize → Brand Colors.

17. Core templates (404, search, archives)

Added in v1.4.0 for marketplace / Theme Check readiness.

Error & search

Catalog archives (native CPT URLs)

Room / villa / tour archives enqueue the matching section CSS (rooms-01.css, etc.) for consistent styling with homepage cards. Inner listing pages (e.g. page template “Rooms”) remain available as an alternative layout.

18. Page templates

Folder: page-templates/. On the page edit screen, use the Template dropdown.

19. Theme presentation shortcodes

Every homepage section ID becomes a shortcode:

[hero design="1"]
[rooms design="2" limit="6" columns="3"]
[booking-search]
[activities]
[map-search]

Aliases: [hero1], [rooms02], and similar (inc/shortcodes.php).

20. Theme file map (quick reference)

booking-pro/
├── functions.php          # bootstrap + requires (BPRO_VERSION)
├── style.css              # theme header + marketplace metadata
├── readme.txt             # WordPress.org-style readme
├── screenshot.png         # theme preview image
├── 404.php / search.php   # error + search templates (v1.4.0)
├── archive-bpro_*.php     # room / villa / tour / activity / car / bundle archives
├── front-page.php         # homepage sections
├── header.php / footer.php
├── single-pages/          # CPT singles
├── page-templates/        # inner pages
├── template-parts/
│   ├── catalog/single.php
│   ├── catalog/archive-grid.php   # shared archive cards (v1.4.0)
│   ├── header/ footer/
│   └── sections/…         # homepage designs
├── assets/css|js|…
└── inc/
    ├── setup.php, enqueue.php, helpers.php
    ├── customizer.php, innerpage-customizer.php, single-customizer.php
    ├── post-types.php, content-post-types.php, catalog*.php
    ├── rooms/ villas/ tours/ traveler/
    ├── demo-setup.php, demos.php, plugin-notice.php
    └── sticky-book.php, forms.php, schema.php…

21. Booking System plugin — overview

• Theme: 1.4.0 · Plugin: 1.4.0 · DB version: 1.2.0
• Main file: booking-system/booking-system.php
• Text domain: booking-system
• Works with any theme via shortcodes / REST / PHP helpers — best paired with Booking Pro

Core classes (includes/)

22. Plugin admin menus

Top-level menu: Booking System (calendar dashicon).

23. Plugin Settings — every option in detail

Path: Booking System → Settings. Stored in option key bs_settings.

A. General

B. Payments

C. SMS / WhatsApp

24. Booking flow (how a booking is created)

Creating a booking from admin

Booking System → Bookings → Add: item_type, item_id, check-in/out, adults/children, status, customer fields.

25. Availability & pricing

Availability

• Table: wp_bs_availability (plus booking date ranges that block inventory)
• Day items (tours/activities) vs stay items (rooms/villas): helpers bs_is_day_item(), bs_is_stay_item()
• Calendar UI: shortcode [availability_calendar] and admin Calendar

Pricing rules

Booking System → Pricing — seasonal / weekend / length-of-stay style rules via BS_Pricing::save_rule.

Listing base price comes from theme meta (for example room base price).

26. Payments & gateways

• Base gateway is filterable: Pay at Hotel (offline)
• Additional gateways register via the bs_payment_gateways filter / BS_Gateways / online checkout class
• Enable them in Settings and add API keys
• Admin Payments: record manual payments
• Invoices: BS_Invoice templates

27. Coupons, taxes, services

Coupons

Create a code, discount type/amount, usage limits, and validity. Applied at checkout.

Taxes

Tax rates table — applied to the pricing total.

Services (add-ons)

Breakfast, airport pickup, and similar. Attached to bookings; stored in booking_services.

28. Notifications

Booking System → Notifications — edit templates (BS_Notification::update_template).

• Email on new booking / confirmation / cancellation
• Optional SMS (Twilio) and WhatsApp when enabled in Settings
• Reminders via cron using reminder_days_before

Tip: use WP Mail SMTP or Mailhog locally, otherwise emails may appear to “disappear”.

29. Wishlist, reviews, map search

Wishlist

• Class: BS_Wishlist — logged-in user meta + guest cookie
• AJAX heart toggle on grids / singles
• Shortcode: [booking_wishlist]

Reviews

• Table: wp_bs_reviews
• Shortcode: [booking_reviews] (usually in item context)
• Admin: Booking System → Reviews
• Setting: auto-approve on/off

Map search

• Leaflet-based UI
• Shortcode: [booking_map]
• Requires lat/lng on listings
• Homepage section map-search and Map page template

30. iCal, housekeeping, reports

iCal Sync

Import an external calendar URL for a given item_type + item_id. Optionally save the feed for re-import.

Housekeeping

Post-checkout cleaning / room readiness operations for hotels.

Reports

Occupancy / revenue views plus CSV export.

31. Plugin shortcodes (complete list)

Example page content

[booking_checkout]


[booking_confirmation]


[my_bookings]


[booking_map]
[booking_wishlist]

32. REST API

Namespace: booking-system/v1

Local example: http://localhost/test/wp-json/booking-system/v1/items/room

33. Database tables

Prefix is usually wp_bs_ (via bs_table()).

34. WooCommerce integration

BS_WooCommerce::init — if WooCommerce is active, gateways / checkout bridging can be filtered in.

• Optional — WooCommerce is not required for core theme booking
• Test that with WC active there is no conflict between WC cart and booking cart shortcodes

35. Staff Web Panel — complete guide

The Staff Web Panel is a front-end workspace for hotel and property staff. It uses normal WordPress login (username + password) but shows a dedicated booking UI instead of the full wp-admin dashboard. Staff see only the menus their role allows.

A. URLs and access

On subdirectory installs (e.g. http://localhost/test/) the path is /test/staff-panel/. Pretty URLs require permalinks to be flushed once (Settings → Permalinks → Save).

Fallback query-string URL (if rewrites fail):

?bs_staff_panel=1&bs_staff_page=login

B. Who can log in?

Only users with staff panel access are allowed past the login screen:

• Administrator — full access
• Booking Manager (bs_manager)
• Front Desk (bs_frontdesk)
• Housekeeper (bs_housekeeper)

C. Roles, capabilities & menu access

Capability reference

D. Login flow

E. Panel screens (what each menu does)

F. Creating staff users

Path: Staff Panel → Staff Users (or wp-admin user screen for advanced edits).

1. Fill Username, Email, and Password (required).
2. Optional: first name / last name.
3. Select Role from the dropdown (limited by your own role — see table in §35-C).
4. Click Create user. The new user signs in at /staff-panel/login/ with the same credentials.

G. Design & UX (v1.4.0)

• Matches Booking Pro linen / charcoal palette (§16)
• Fonts: Cormorant Garamond (headings) + Outfit (UI)
• Dark sidebar with SVG icons per menu item
• Sticky top bar: page title, “View site” link, user avatar
• Card-style KPIs, tables, and filter bars
• Mobile: slide-out sidebar + hamburger menu
• WordPress admin bar is hidden inside the panel
• Site custom logo (Customizer) appears in sidebar and login if set

H. Technical implementation

Form posts (save booking, record payment, update settings, etc.) are handled by the same BS_Admin::handle_actions() logic as wp-admin. Data is stored in the same wp_bs_* tables — there is no separate database for the panel.

I. Staff panel vs wp-admin

J. QA checklist (staff panel)

• /staff-panel/login/ loads branded login page
• Admin login → dashboard KPIs and recent bookings show
• Each menu link opens without PHP fatal error
• Front Desk user sees only allowed menus (no Settings/Users)
• Housekeeper sees Housekeeping + limited Bookings/Calendar
• Filter forms on Bookings/Calendar/Reports stay on panel URLs (not wp-admin)
• Create Front Desk user as Manager → new user can log in
• Logout clears session and returns to login
• Mobile: sidebar toggle opens/closes; tables scroll horizontally if needed
• Subdirectory install (/test/) resolves /test/staff-panel/ correctly

36. Required / recommended pages

37. Menus & permalinks

1. Settings → Permalinks → Post name → Save
2. Appearance → Menus — Primary location: Home, Rooms, Villas, Tours, Activities, Cars, Bundles, Map, Booking, Contact
3. If archives return 404: Save Permalinks again and clear any cache

38. Full testing checklist

Print or tick during QA:

A. Install smoke

• Plugin activates without a PHP fatal error
• Theme activates without a PHP fatal error
• Admin shows plugin-required warning when Booking System is deactivated
• readme.txt and screenshot.png exist in the theme folder
• wp_bs_bookings table exists in phpMyAdmin
• Admin menus: Booking System + Rooms are visible
• Front homepage loads CSS correctly

B. Demo & pages

• Setup Demo installs without error
• Static homepage shows sections
• Rooms / Activities / Map pages open
• Native archives /rooms/, /villas/, /tours/ show card grids (v1.4.0)
• 404.php and search.php render branded layouts
• Footer does not show default Archives / Categories widgets after demo install
• Primary menu links work (no 404)

C. Catalog CRUD

• Add a Room with price, featured image, booking mode Instant
• Add Villa / Tour with lat/lng
• Add Activity with a dates list
• Add Car + Travel Bundle
• Single pages show gallery, price, book form, sticky bar

D. Customizer

• Disable a homepage section → it disappears
• Reorder sections → order changes
• Switch design variant → layout changes, content stays the same
• Single Catalog: disable Reviews → reviews hide
• Innerpage colors apply on the Rooms listing

E. Booking happy path

• Search available dates → results appear
• Book a room with Pay at Hotel → confirmation
• Admin → Bookings shows the new row with the correct total
• Same dates are blocked / inventory is respected
• Request-to-book listing → pending/request status
• Instant book → confirmed (per settings)

F. Traveler

• Activity booking for a listed date
• Car day price calculates correctly
• Bundle/package books successfully
• Wishlist heart toggles (logged out + logged in)
• Submit a review → appears (or awaits approval)
• Map pins show for items with lat/lng

G. Commerce extras

• Coupon reduces the total
• Tax adds to the total
• Extra service is selectable
• Payment is recorded on the Payments screen

H. Ops

• Calendar shows the booking
• Reports load / CSV export works
• Notification email is received (or logged)
• iCal import marks blocked dates (if a feed is available)
• Mobile: sticky book bar and forms are usable

J. Staff Web Panel

• /staff-panel/login/ — branded login loads
• Administrator — all 10 panel menus open without error
• Booking Manager — full panel + can create Front Desk / Housekeeper users
• Front Desk — Dashboard, Bookings, Calendar, Customers, Payments, Reports only
• Housekeeper — Dashboard, Bookings, Calendar, Housekeeping only
• Bookings filter + calendar month picker submit to panel URLs
• Record a manual payment from Payments screen
• Update a housekeeping room status
• Logout works; non-staff WP user is rejected at login

K. REST smoke

• GET items/room returns JSON
• POST availability with a valid body returns available true/false

39. Troubleshooting

40. Changelog

Plugin v1.4.0 — Staff Web Panel

• Front-end Staff Web Panel at /staff-panel/ with WordPress login
• Custom roles: Booking Manager, Front Desk, Housekeeper (BS_Capabilities)
• Role-based sidebar menus — 10 screens (Dashboard through Staff Users)
• Staff user creation inside panel (Admin: all roles; Manager: Front Desk + Housekeeper)
• Premium UI matching Booking Pro linen/charcoal design system
• Mobile sidebar, top bar, SVG nav icons, Google fonts (Cormorant + Outfit)
• Reuses wp-admin booking views on front-end; shared BS_Admin::handle_actions()
• Helpers: bs_is_staff_panel(), bs_booking_admin_url()
• Subdirectory install support + pretty permalink rewrite rules

Theme v1.4.0 (marketplace release)

• Unified product branding as Booking Pro (removed TravelCraft naming)
• Added readme.txt, screenshot.png, version sync via BPRO_VERSION
• Added 404.php and search.php
• Added archive-bpro_room.php, archive-bpro_villa.php, archive-bpro_tour.php
• Added template-parts/catalog/archive-grid.php shared archive layout
• Added inc/plugin-notice.php — admin warning when Booking System is inactive
• Demo setup clears default footer-1 widgets; seeds offers/packages when missing
• Default linen / charcoal color palette documented in §16
• Catalog single CSS now loads for activity, car, and bundle singles too
• Booking search + map section layout fixes (panel wrapper, hero nav z-index)

Theme v1.3.x

• Homepage Section Manager, 100+ demo presets
• Innerpage + Single Catalog Customizer
• One-click demo under Appearance → Setup Demo
• Aman-inspired design refresh (header, footer, section-01 styles)

41. FAQ

What is the Staff Web Panel?

A front-end booking workspace at /staff-panel/ for hotel staff. It uses WordPress login but hides wp-admin. See §35 for roles, URLs, and setup.

How do I give my receptionist access without wp-admin?

Create a Front Desk user under Staff Panel → Staff Users (or wp-admin Users). They log in at /staff-panel/login/.

Can housekeeping staff change bookings?

Housekeepers see Dashboard, Bookings (view), Calendar, and Housekeeping. They update room status on the housekeeping board; full booking edits require Front Desk or Manager roles.

How do I edit layouts?

Use the WordPress Customizer — Homepage Section Manager, Innerpage Manager, and Single Catalog Manager. No separate page builder is required.

Can the theme be sold without the plugin?

You can sell design alone, but booking features require the plugin. Packaging both together is recommended.

Will the plugin work with another theme?

Yes, via shortcodes / REST. Catalog CPTs are provided by Booking Pro; another theme needs its own catalog wiring.

How do I remove demo content?

Trash demo pages/posts; reset Customizer options manually; the flag bpro_demo_installed lives in the options table.

What files are required to sell on a marketplace?

Minimum: theme folder with style.css, readme.txt, screenshot.png, plus the Booking System plugin bundle and this documentation. See §7.

Where is this documentation file?

Path:

wp-content/themes/booking-pro/docs/BOOKING-PRO-COMPLETE-GUIDE.html

Open it directly in a browser (double-click) or serve it from your local URL.