11 Commits

Author SHA1 Message Date
13fd25f84c Implement Phase 9: Prometheus Metrics (v0.9.0)
All checks were successful
Create Release Package / build-release (push) Successful in 1m8s
- Add Prometheus metrics integration via wp-prometheus hooks
- Create Grafana dashboard JSON with 24 panels
- Add metrics settings tab with enable/disable toggle
- Expose inventory, booking, occupancy, revenue, and guest metrics

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 20:40:54 +01:00
b6d7eeb5ec Add detailed Dashboard and Reports documentation to README (v0.8.0)
All checks were successful
Create Release Package / build-release (push) Successful in 1m9s
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 20:23:02 +01:00
b137fec4fb Implement Phase 8: Dashboard & Reports (v0.8.0)
Some checks failed
Create Release Package / build-release (push) Has been cancelled
- Add comprehensive admin dashboard with stat cards and widgets
- Add Chart.js for occupancy/revenue trend charts
- Add Reports page with Occupancy, Revenue, Guest tabs
- Add CSV and PDF export functionality (using mPDF)
- Add date range filters for reports

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 20:20:27 +01:00
992d961066 Fix CF7 tag generator buttons not appearing in admin (v0.7.2)
All checks were successful
Create Release Package / build-release (push) Successful in 56s
Moved CF7 initialization from init_frontend() to init_components()
so tag generators register in admin context via wpcf7_admin_init hook.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 17:18:46 +01:00
be6d9d68b5 Update CLAUDE.md with v0.7.1 session history
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 17:11:10 +01:00
a784d92cc9 Add CF7 tag generator buttons for admin form editor (v0.7.1)
All checks were successful
Create Release Package / build-release (push) Successful in 59s
- Register tag generators via wpcf7_admin_init hook
- Add BnB Building select tag generator with first_as_label option
- Add BnB Room select tag generator with building_field and include_price options
- Add BnB Check-in date tag generator with min/max advance options
- Add BnB Check-out date tag generator with checkin_field and min/max nights options
- Add BnB Guests count tag generator with room_field and min/max/default options
- All generators support id and class attribute configuration
- Remove bug from Known Bugs section in CLAUDE.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 17:00:26 +01:00
f61dca5f45 Update CLAUDE.md with v0.7.0 session history
Document CF7 integration implementation details:
- Directory structure updated with Integration folder
- New CF7 assets (JS, CSS) documented
- Session history with learnings and patterns

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 16:34:00 +01:00
28350aabfa Implement Phase 7: Contact Form 7 Integration (v0.7.0)
All checks were successful
Create Release Package / build-release (push) Successful in 1m1s
Add custom CF7 form tags for booking requests:
- [bnb_building_select] - Building filter dropdown
- [bnb_room_select] - Room selection with capacity data
- [bnb_date_checkin/checkout] - Date pickers with validation
- [bnb_guests] - Guest count with capacity limits

Features:
- Server-side validation for all fields
- Real-time AJAX availability checking
- Automatic price calculation display
- Booking creation on form submission
- Guest record creation/linking
- Custom mail tags for CF7 templates

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 16:30:30 +01:00
3579904bad Add Phase 10: Security Audit to roadmap
- Added security audit phase (v0.10.0) to PLAN.md
- WordPress best practices review
- OWASP Top 10 review (XSS, XSRF, SQLi, etc.)
- Updated version milestones table

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 16:10:19 +01:00
602549208f Fix MD012 linting warning in CLAUDE.md
Remove duplicate blank line between session history sections.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 16:03:40 +01:00
45a73e15aa Add Phase 9: Prometheus Metrics to roadmap
- Added Prometheus metrics integration phase (v0.9.0) to PLAN.md
- Includes meaningful metrics for plugin, example Grafana dashboard
- Settings page option to enable/disable metrics
- Links to wp-prometheus README for implementation details
- Updated version milestones table

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 16:02:17 +01:00
17 changed files with 9384 additions and 110 deletions

View File

@@ -5,6 +5,135 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [0.9.0] - 2026-02-03
### Added
- Prometheus Metrics Integration:
- New `src/Integration/Prometheus.php` class for metrics collection
- Integration with wp-prometheus plugin via `wp_prometheus_collect_metrics` hook
- Inventory metrics: buildings total, rooms by status, services by status
- Booking metrics: bookings by status, check-ins/check-outs today, upcoming 7 days, avg duration
- Guest metrics: total guests, guests by status, repeat guests, new guests this month
- Occupancy metrics: current rate, monthly rate, occupied rooms, total bed capacity
- Revenue metrics: this month, YTD, average booking value, services revenue
- Grafana Dashboard:
- Pre-configured dashboard at `assets/grafana/wp-bnb-dashboard.json`
- Automatic registration with wp-prometheus dashboard provider
- Occupancy gauges with color-coded thresholds
- Pie charts for bookings, rooms, and guests by status
- Revenue and guest statistics panels
- Responsive grid layout with 24 panels
- Settings page Metrics tab:
- Enable/disable metrics collection toggle
- WP Prometheus detection with status indicator
- Complete metrics reference table
- Dashboard file location and export info
### Changed
- Plugin.php updated to initialize Prometheus integration
- Settings page now has six tabs: General, Pricing, License, Updates, Metrics
## [0.8.0] - 2026-02-03
### Added
- Admin Dashboard with comprehensive statistics:
- Occupancy overview card with current rate and comparison to last month
- Revenue summary card with this month, YTD, and comparison
- Bookings stat card with pending/confirmed counts
- Guests stat card with total, new, and repeat counts
- Today's Activity widget showing check-ins and check-outs
- Upcoming Bookings widget (next 7 days)
- Quick Actions widget for common tasks
- Chart.js integration for visual trend charts:
- Occupancy trend line chart (30 days)
- Revenue trend bar chart (6 months)
- Reports page with three report types:
- Occupancy Report: by room, by building, with progress bars
- Revenue Report: by room, by pricing tier, with averages
- Guest Statistics: top guests, nationality breakdown
- Date range filters (this month, last month, this year, custom)
- Export functionality:
- CSV export for all report types (native PHP)
- PDF export using mPDF library with professional styling
- New Composer dependency: mpdf/mpdf ^8.2 for PDF generation
- Dashboard and Reports CSS styles in admin.css (~350 lines)
- JavaScript chart initialization and report page handlers
### Changed
- Dashboard now uses dedicated `src/Admin/Dashboard.php` class
- Admin menu now includes Reports submenu item
- Asset enqueuing conditionally loads Chart.js on dashboard page
## [0.7.2] - 2026-02-03
### Fixed
- CF7 tag generator buttons not appearing in admin form editor
- Moved CF7 initialization from frontend-only to run in both admin and frontend contexts
- Tag generators now properly register via `wpcf7_admin_init` hook
## [0.7.1] - 2026-02-03
### Added
- CF7 Admin Tag Generator buttons:
- Tag generator buttons appear in CF7 form editor for all WP BnB custom tags
- BnB Building select with first option label configuration
- BnB Room select with building field linking and price display options
- BnB Check-in date with min/max advance booking days
- BnB Check-out date with check-in field linking and min/max nights
- BnB Guests count with room field linking and min/max/default values
- All generators support id and class attribute configuration
## [0.7.0] - 2026-02-03
### Added
- Contact Form 7 Integration:
- New `src/Integration/CF7.php` class for CF7 integration
- Custom form tags: `[bnb_building_select]`, `[bnb_room_select]`, `[bnb_date_checkin]`, `[bnb_date_checkout]`, `[bnb_guests]`
- Server-side validation for all custom tags
- Availability checking before form submission
- Automatic booking creation on form submission with 'pending' status
- Guest record creation/linking using existing `find_or_create_guest` pattern
- Price calculation using existing Calculator class
- Email notifications via existing EmailNotifier
- CF7 Frontend Assets:
- `assets/js/cf7-integration.js` for dynamic form behavior
- Building-based room filtering
- Date linking (checkout min = checkin + 1)
- Capacity validation against selected room
- AJAX availability checking with status display
- Dynamic price calculation display
- `assets/css/cf7-integration.css` for form styling
- Availability status indicators (checking/available/unavailable)
- Price display formatting
- Capacity warning styling
- Responsive design with dark mode support
- Custom CF7 Mail Tags:
- `[_bnb_booking_reference]` - Generated booking reference
- `[_bnb_booking_id]` - Booking post ID
- `[_bnb_room_name]` - Selected room title
- `[_bnb_calculated_price]` - Formatted price
- `[_bnb_nights]` - Number of nights
- Form Type Detection:
- Auto-detects booking forms by presence of `[bnb_room_select]`, `[bnb_date_checkin]`, `[bnb_date_checkout]`
- CSS class `wp-bnb-booking-form` for explicit form type declaration
- Inquiry forms use default CF7 email handling without booking creation
### Changed
- Plugin.php updated to conditionally initialize CF7 integration when CF7 is active
- Frontend assets now include CF7-specific CSS and JavaScript when CF7 is detected
### Dependencies
- Contact Form 7 plugin required for CF7 integration features (optional)
## [0.6.1] - 2026-02-03 ## [0.6.1] - 2026-02-03
### Added ### Added

255
CLAUDE.md
View File

@@ -40,7 +40,7 @@ This project is proudly **"vibe-coded"** using Claude.AI - the entire codebase w
### Known Bugs ### Known Bugs
No known bugs at this time. (none)
## Technical Stack ## Technical Stack
@@ -260,6 +260,8 @@ wp-bnb/
│ │ ├── Calculator.php # Price calculation │ │ ├── Calculator.php # Price calculation
│ │ ├── PricingTier.php # Pricing tier enum │ │ ├── PricingTier.php # Pricing tier enum
│ │ └── Season.php # Seasonal pricing │ │ └── Season.php # Seasonal pricing
│ ├── Integration/ # Third-party integrations
│ │ └── CF7.php # Contact Form 7 integration
│ └── Taxonomies/ # Custom taxonomies │ └── Taxonomies/ # Custom taxonomies
│ ├── Amenity.php # Amenity taxonomy (tags) │ ├── Amenity.php # Amenity taxonomy (tags)
│ └── RoomType.php # Room type taxonomy (categories) │ └── RoomType.php # Room type taxonomy (categories)
@@ -270,10 +272,12 @@ wp-bnb/
│ ├── css/ │ ├── css/
│ │ ├── admin.css # Admin styles │ │ ├── admin.css # Admin styles
│ │ ├── blocks-editor.css # Gutenberg editor styles │ │ ├── blocks-editor.css # Gutenberg editor styles
│ │ ├── cf7-integration.css # CF7 form styles
│ │ └── frontend.css # Frontend styles (~1250 lines) │ │ └── frontend.css # Frontend styles (~1250 lines)
│ └── js/ │ └── js/
│ ├── admin.js # Admin scripts │ ├── admin.js # Admin scripts
│ ├── blocks-editor.js # Gutenberg editor scripts │ ├── blocks-editor.js # Gutenberg editor scripts
│ ├── cf7-integration.js # CF7 form scripts
│ └── frontend.js # Frontend scripts (~825 lines) │ └── frontend.js # Frontend scripts (~825 lines)
├── templates/ # Twig templates (future) ├── templates/ # Twig templates (future)
├── languages/ # Translation files (future) ├── languages/ # Translation files (future)
@@ -338,7 +342,7 @@ Admin features always work; frontend requires valid license.
- Implemented license settings page with validation/activation buttons - Implemented license settings page with validation/activation buttons
- Created admin CSS and JavaScript for license management - Created admin CSS and JavaScript for license management
- Created Gitea CI/CD pipeline at `.gitea/workflows/release.yml` - Created Gitea CI/CD pipeline at `.gitea/workflows/release.yml`
- Created `PLAN.md` with full implementation roadmap (8 phases) - Created `PLAN.md` with full implementation roadmap (10 phases)
- Created `README.md` with user documentation - Created `README.md` with user documentation
- Created `CHANGELOG.md` following Keep a Changelog format - Created `CHANGELOG.md` following Keep a Changelog format
- Updated `CLAUDE.md` with architecture details - Updated `CLAUDE.md` with architecture details
@@ -658,7 +662,6 @@ Admin features always work; frontend requires valid license.
- Tagged: `v0.6.0` - Tagged: `v0.6.0`
- Pushed to origin: dev, main, v0.6.0 - Pushed to origin: dev, main, v0.6.0
### 2026-02-03 - Bug Fixes and Enhancements ### 2026-02-03 - Bug Fixes and Enhancements
**Completed:** **Completed:**
@@ -743,3 +746,249 @@ Admin features always work; frontend requires valid license.
- `use_block_editor_for_post_type` filter disables Gutenberg per post type - `use_block_editor_for_post_type` filter disables Gutenberg per post type
- Post types with `show_in_rest => true` get Gutenberg by default, which hides traditional meta boxes - Post types with `show_in_rest => true` get Gutenberg by default, which hides traditional meta boxes
- Form-based admin interfaces (data entry) should use classic editor, not block editor - Form-based admin interfaces (data entry) should use classic editor, not block editor
### 2026-02-03 - Version 0.7.0 (Contact Form 7 Integration)
**Completed:**
- Created `src/Integration/CF7.php` (~750 lines)
- Custom form tags: `[bnb_building_select]`, `[bnb_room_select]`, `[bnb_date_checkin]`, `[bnb_date_checkout]`, `[bnb_guests]`
- Server-side validation for all custom tags
- Availability validation in `wpcf7_before_send_mail` hook
- Automatic booking creation on form submission via `wpcf7_mail_sent`
- Guest record creation/linking using `find_or_create_guest()` pattern
- Custom mail tags: `[_bnb_room_name]`, `[_bnb_building_name]`, `[_bnb_calculated_price]`, `[_bnb_nights]`, `[_bnb_booking_reference]`
- Form type detection via CSS class `wp-bnb-booking-form`
- Created `assets/js/cf7-integration.js` (~230 lines)
- Building-based room filtering (rooms dropdown updates when building selected)
- Date validation (check-out after check-in, no past dates)
- Guest capacity validation against room limits
- AJAX availability checking with status display
- AJAX price calculation with formatted display
- Debounced updates to prevent excessive requests
- Created `assets/css/cf7-integration.css` (~200 lines)
- Two-column responsive form layout
- Availability status indicators (checking spinner, available checkmark, unavailable X)
- Price display formatting
- Capacity warning styling
- Dark mode support via `prefers-color-scheme`
- Print styles (hide interactive elements)
- Updated `src/Plugin.php`
- Added `use Magdev\WpBnb\Integration\CF7` import
- CF7 initialization in `init_frontend()` when WPCF7 class exists
- CF7 assets enqueuing with localized i18n strings
- Updated `README.md` with comprehensive CF7 documentation
- Custom form tags reference with options
- Example booking form template
- Example inquiry form template
- Custom mail tags documentation
**Files Created:**
- `src/Integration/CF7.php` - Main CF7 integration class
- `assets/js/cf7-integration.js` - Frontend JavaScript
- `assets/css/cf7-integration.css` - Form styling
**Learnings:**
- CF7 custom tags registered via `wpcf7_add_form_tag()` with callback functions
- Validation filters follow pattern `wpcf7_validate_{tag_name}`
- `wpcf7_before_send_mail` can abort submission by setting `$abort` to true and adding validation error
- `wpcf7_mail_sent` fires after successful email, ideal for booking creation
- Custom mail tags via `wpcf7_special_mail_tags` filter receive submission data
- Form type detection by CSS class more reliable than checking for specific tags
- Room dropdown with `data-building` attributes enables client-side filtering
- AJAX endpoints reuse existing `wp_bnb_get_availability` and `wp_bnb_calculate_price` actions
- CF7 assets should depend on `contact-form-7` script/style handles
- Guest linking uses email as unique identifier for find-or-create pattern
**Released:**
- Committed: `28350aa` on dev branch
- Merged to main (fast-forward)
- Tagged: `v0.7.0`
- Pushed to origin: dev, main, v0.7.0
### 2026-02-03 - Version 0.7.1 (CF7 Tag Generators)
**Completed:**
- Added CF7 tag generator buttons for admin form editor
- Hook into `wpcf7_admin_init` to register tag generators
- `register_tag_generators()` method using `WPCF7_TagGenerator::add()`
- BnB Building select generator with `first_as_label` option
- BnB Room select generator with `building_field` and `include_price` options
- BnB Check-in date generator with `min_advance` and `max_advance` options
- BnB Check-out date generator with `checkin_field`, `min_nights`, `max_nights` options
- BnB Guests count generator with `room_field`, `min`, `max`, `default` options
- All generators support `id` and `class` attribute configuration
- CF7 v2 tag generator format with `version => '2'` option
- Removed bug from Known Bugs section in CLAUDE.md
**Files Changed:**
- `src/Integration/CF7.php` - Added ~560 lines for tag generator registration and modal callbacks
- `CLAUDE.md` - Removed bug from Known Bugs section
- `wp-bnb.php` - Version bump to 0.7.1
- `CHANGELOG.md` - Added v0.7.1 release notes
**Learnings:**
- CF7 tag generators use `WPCF7_TagGenerator::get_instance()->add()` for registration
- Tag generator callbacks receive `$contact_form` and `$options` parameters
- CF7 v2 tag generator format requires `'version' => '2'` in options array
- Modal HTML structure: `<header class="description-box">`, `<div class="control-box">`, `<footer class="insert-box">`
- Form inputs use classes like `tg-name`, `oneline`, `option`, `idvalue`, `classvalue` for CF7's JavaScript handling
- The `tag-generator-insert-button` class triggers CF7's tag insertion JavaScript
- Mail tag tip shows users which tag to use in the Mail tab
- Tag generators are registered at priority 60 in `wpcf7_admin_init` to appear after core tags
**Released:**
- Committed: `a784d92` on dev branch
- Merged to main (fast-forward)
- Tagged: `v0.7.1`
- Pushed to origin: dev, main, v0.7.1
### 2026-02-03 - Version 0.8.0 (Dashboard & Reports)
**Completed:**
- Created `src/Admin/Dashboard.php` class (~700 lines)
- `render()` method for full dashboard page
- Occupancy stat card with current rate, room count, comparison to last month
- Revenue stat card with this month, YTD, comparison
- Bookings stat card with pending/confirmed counts
- Guests stat card with total, new this month, repeat guests
- Today's Activity widget showing check-ins and check-outs
- Upcoming Bookings widget with next 7 days' bookings
- Quick Actions widget (New Booking, New Guest, Calendar, Reports)
- Occupancy trend chart (30-day line chart)
- Revenue trend chart (6-month bar chart)
- Data methods: `get_occupancy_stats()`, `get_revenue_stats()`, `get_booking_stats()`, `get_guest_stats()`
- Chart data methods: `get_occupancy_trend_data()`, `get_revenue_trend_data()`
- Transient caching for expensive calculations (1-hour expiry)
- Created `src/Admin/Reports.php` class (~1100 lines)
- Tabbed interface: Occupancy, Revenue, Guests
- Date range filters with presets (this month, last month, this year, custom)
- Occupancy Report: by room, by building with progress bars and status labels
- Revenue Report: by room, by pricing tier, with averages
- Guest Statistics: top guests by revenue, nationality breakdown
- CSV export using native PHP `fputcsv()`
- PDF export using mPDF with professional HTML styling
- Summary cards with key metrics
- Progress bar visualizations for occupancy rates
- Added mPDF dependency to `composer.json` (`mpdf/mpdf ^8.2`)
- Updated `src/Plugin.php`
- Added Dashboard and Reports class imports
- `render_dashboard_page()` delegates to `Dashboard::render()`
- Added `render_reports_page()` method
- Reports submenu registration
- Updated menu ordering to include Reports
- Chart.js CDN enqueuing on dashboard page
- Chart data passed via `wp_localize_script()`
- Dashboard CSS styles (~350 lines in admin.css)
- Responsive grid layout (4-col stats, 2-col charts, 3-col activity)
- Stat cards with icons and gradients
- Widget components with headers
- Activity list styling
- Upcoming bookings table
- Quick action buttons grid
- Reports CSS styles (~200 lines in admin.css)
- Filter form layout
- Summary cards with primary variant
- Progress bars for occupancy
- Status labels (high/medium/low)
- Export buttons styling
- JavaScript additions in admin.js
- `initDashboardCharts()` for Chart.js initialization
- Occupancy line chart with tooltips and styling
- Revenue bar chart with currency formatting
- `initReportsPage()` for custom date toggle
- Updated version to 0.8.0
**Files Created:**
- `src/Admin/Dashboard.php` - Dashboard page with widgets and charts
- `src/Admin/Reports.php` - Reports page with tabs and export
**Files Changed:**
- `composer.json` - Added mpdf/mpdf dependency
- `composer.lock` - Updated with mPDF and dependencies
- `src/Plugin.php` - Dashboard/Reports integration, Chart.js enqueuing
- `assets/css/admin.css` - Dashboard and Reports styles (~550 lines added)
- `assets/js/admin.js` - Chart initialization, reports page handlers
- `wp-bnb.php` - Version bump to 0.8.0
- `CHANGELOG.md` - Added v0.8.0 release notes
- `PLAN.md` - Marked Phase 8 as complete
**Learnings:**
- Chart.js CDN loading requires conditional enqueuing to avoid loading on all admin pages
- Dashboard data methods should use transient caching for expensive queries
- PDF export with mPDF requires HTML string generation with inline CSS
- Reports use `get_posts()` with meta queries for date range filtering
- Progress bar visualization done with CSS positioning and `min(100, value)` clamping
- Chart.js 4.x uses `new Chart()` constructor with configuration object
- PDF generation needs `try/catch` for mPDF exceptions
- CSV export with BOM (`\xEF\xBB\xBF`) ensures Excel compatibility
- Guest data aggregation from bookings uses unique key pattern for anonymous guests
- Occupancy calculation: (booked nights / total room nights) * 100
### 2026-02-03 - Version 0.9.0 (Prometheus Metrics)
**Completed:**
- Created `src/Integration/Prometheus.php` class (~700 lines)
- Integration with wp-prometheus via `wp_prometheus_collect_metrics` hook
- Dashboard registration via `wp_prometheus_register_dashboards` hook
- Option to enable/disable metrics collection
- Inventory metrics: buildings total, rooms by status, services by status
- Booking metrics: by status, check-ins/outs today, upcoming 7 days, avg duration
- Guest metrics: total, by status, repeat guests, new this month
- Occupancy metrics: current rate, monthly rate, occupied rooms, bed capacity
- Revenue metrics: this month, YTD, avg booking value, services revenue
- Optimized SQL queries using `$wpdb->prepare()` throughout
- Created `assets/grafana/wp-bnb-dashboard.json` Grafana dashboard
- 24 panels with responsive grid layout
- Occupancy gauges with color-coded thresholds (red < 30%, orange < 50%, yellow < 70%, green ≥ 70%)
- Pie charts for bookings, rooms, and guests by status
- Revenue stat panels (this month, YTD, avg value, services)
- Guest stat panels (total, new, repeat, active services)
- Today's activity panels (check-ins, check-outs, upcoming)
- Prometheus datasource variable for flexibility
- Auto-refresh every 5 minutes
- Updated `src/Plugin.php`
- Added Prometheus class import
- Initialized Prometheus integration in `init_components()`
- Added "Metrics" tab to settings page (6 tabs total)
- Added `render_metrics_settings()` method with WP Prometheus detection
- Added `save_metrics_settings()` method
- Metrics reference table showing all available metrics
- Updated version to 0.9.0
**Files Created:**
- `src/Integration/Prometheus.php` - Prometheus metrics integration class
- `assets/grafana/wp-bnb-dashboard.json` - Pre-configured Grafana dashboard
**Files Changed:**
- `src/Plugin.php` - Prometheus initialization, metrics settings tab
- `wp-bnb.php` - Version bump to 0.9.0 (header and constant)
- `CHANGELOG.md` - Added v0.9.0 release notes
- `PLAN.md` - Marked Phase 9 as complete
- `README.md` - Added Prometheus metrics documentation
**Learnings:**
- wp-prometheus uses `wp_prometheus_collect_metrics` action with collector object
- Collector provides `register_gauge()` for fluctuating values
- Labels are passed as array to `register_gauge()`, values to `set()`
- Grafana dashboard JSON requires proper panel IDs and grid positions
- Occupancy queries need careful date range handling for month boundaries
- Revenue queries use `DECIMAL(10,2)` casting for accurate sums
- Metrics should be cached or computed efficiently as they're scraped frequently
- Dashboard registration requires file path, title, description, icon, and plugin name
- Settings tab detection uses `$prometheus_active` to show WP Prometheus status

79
PLAN.md
View File

@@ -149,36 +149,55 @@ This document outlines the implementation plan for the WP BnB Management plugin.
- [x] Building rooms widget - [x] Building rooms widget
- [x] Availability calendar widget - [x] Availability calendar widget
## Phase 7: Contact Form 7 Integration (v0.7.0) ## Phase 7: Contact Form 7 Integration (v0.7.0) - Complete
### Booking Request Form ### Booking Request Form
- [ ] Custom CF7 tags for rooms/dates - [x] Custom CF7 tags for rooms/dates
- [ ] Form validation - [x] Form validation
- [ ] Booking creation on submission - [x] Booking creation on submission
- [ ] Email notifications - [x] Email notifications
### Inquiry Form ### Inquiry Form
- [ ] General inquiry handling - [x] General inquiry handling
- [ ] Room-specific inquiries - [x] Room-specific inquiries
- [ ] Auto-response templates - [x] Auto-response templates (uses default CF7 mail templates)
## Phase 8: Dashboard & Reports (v0.8.0) ## Phase 8: Dashboard & Reports (v0.8.0) - Complete
### Admin Dashboard ### Admin Dashboard
- [ ] Occupancy overview - [x] Occupancy overview
- [ ] Upcoming check-ins/check-outs - [x] Upcoming check-ins/check-outs
- [ ] Revenue summary - [x] Revenue summary
- [ ] Quick actions - [x] Quick actions
### Reports ### Reports
- [ ] Occupancy report - [x] Occupancy report
- [ ] Revenue report - [x] Revenue report
- [ ] Guest statistics - [x] Guest statistics
- [ ] Export functionality (CSV, PDF) - [x] Export functionality (CSV, PDF)
## Phase 9: Prometheus Metrics (v0.9.0) - Complete
- [x] Meaningful Metrics for this Plugin:
- Inventory: buildings, rooms by status, services by status
- Bookings: by status, check-ins/check-outs today, upcoming, avg duration
- Guests: total, by status, repeat guests, new this month
- Occupancy: current rate, monthly rate, occupied rooms, bed capacity
- Revenue: this month, YTD, average booking value, services revenue
- [x] Example Grafana Dashboard:
- Pre-configured dashboard JSON at `assets/grafana/wp-bnb-dashboard.json`
- Automatic registration with wp-prometheus
- 24 panels with gauges, pie charts, and stat displays
- [x] Update settings page to enable/disable metrics
## Phase 10: Security Audit (v0.10.0)
- [ ] Check for Wordpress best-practices
- [ ] Review the code for OWASP Top 10, including XSS, XSRF, SQLi and other critical threads
## Future Considerations (v1.0.0+) ## Future Considerations (v1.0.0+)
@@ -286,15 +305,17 @@ The plugin will provide extensive hooks for customization:
## Version Milestones ## Version Milestones
| Version | Focus | Target | | Version | Focus | Target |
| ------- | --------------- | -------- | | ------- | ------------------ | -------- |
| 0.0.1 | Initial setup | Complete | | 0.0.1 | Initial setup | Complete |
| 0.1.0 | Data structures | Complete | | 0.1.0 | Data structures | Complete |
| 0.2.0 | Pricing | Complete | | 0.2.0 | Pricing | Complete |
| 0.3.0 | Bookings | Complete | | 0.3.0 | Bookings | Complete |
| 0.4.0 | Guests | Complete | | 0.4.0 | Guests | Complete |
| 0.5.0 | Services | Complete | | 0.5.0 | Services | Complete |
| 0.6.0 | Frontend | Complete | | 0.6.0 | Frontend | Complete |
| 0.7.0 | CF7 Integration | TBD | | 0.7.0 | CF7 Integration | Complete |
| 0.8.0 | Dashboard | TBD | | 0.8.0 | Dashboard | Complete |
| 1.0.0 | Stable Release | TBD | | 0.9.0 | Prometheus Metrics | Complete |
| 0.10.0 | Security Audit | TBD |
| 1.0.0 | Stable Release | TBD |

286
README.md
View File

@@ -18,13 +18,17 @@ WP BnB Management enables WordPress to act as a full management system for B&B h
- **Frontend Integration**: Gutenberg blocks, widgets, and shortcodes - **Frontend Integration**: Gutenberg blocks, widgets, and shortcodes
- **Auto-Updates**: Automatic update checks and installation from license server - **Auto-Updates**: Automatic update checks and installation from license server
- **Development Mode**: License bypass for local development environments - **Development Mode**: License bypass for local development environments
- **Contact Form 7 Integration**: Accept booking requests through forms (planned) - **Contact Form 7 Integration**: Accept booking requests and inquiries through CF7 forms
- **Dashboard**: Comprehensive admin dashboard with statistics and charts
- **Reports**: Detailed reports with CSV and PDF export
- **Prometheus Metrics**: Expose operational metrics for monitoring with Grafana
### Requirements ### Requirements
- WordPress 6.0 or higher - WordPress 6.0 or higher
- PHP 8.3 or higher - PHP 8.3 or higher
- Valid license key - Valid license key
- Contact Form 7 (optional, for booking forms)
## Installation ## Installation
@@ -97,6 +101,80 @@ The plugin automatically detects local development environments and bypasses lic
2. View guest records and booking history 2. View guest records and booking history
3. Manage guest information 3. Manage guest information
### Dashboard
The dashboard (**WP BnB → Dashboard**) provides an at-a-glance overview of your B&B operations:
**Statistics Cards:**
- **Occupancy Rate** - Current percentage of rooms occupied with trend indicator
- **Monthly Revenue** - This month's revenue with comparison to previous month
- **Total Bookings** - Active bookings count with status breakdown
- **Total Guests** - Guest count with new guests this month
**Today's Activity:**
- Check-ins scheduled for today with guest names and room assignments
- Check-outs scheduled for today
- Quick links to manage each booking
**Upcoming Bookings:**
- Next 7 days of arrivals
- Guest name, room, dates, and booking status
- Direct links to booking details
**Quick Actions:**
- New Booking - Create a booking directly
- New Guest - Add a guest record
- View Calendar - Open the availability calendar
- View Reports - Access detailed reports
**Trend Charts:**
- 30-day occupancy trend line chart
- 6-month revenue bar chart
### Reports
Access detailed reports at **WP BnB → Reports**. All reports support date range filtering and export.
**Occupancy Report:**
- Overall occupancy percentage for the selected period
- Breakdown by room showing nights booked, available, and occupancy rate
- Visual progress bars for easy comparison
- Total nights booked vs. available across all rooms
**Revenue Report:**
- Total revenue for the selected period
- Revenue breakdown by room
- Revenue breakdown by pricing tier (short-term, mid-term, long-term)
- Revenue from additional services
- Average booking value
**Guest Statistics:**
- Total guests and new guests in period
- Repeat guest rate (guests with 2+ bookings)
- Top guests by total spending
- Guest nationality distribution
- Average spending per guest
**Export Options:**
- **CSV Export** - Download report data as spreadsheet-compatible CSV
- **PDF Export** - Generate formatted PDF reports for printing or archiving
**Date Filters:**
- This Month (default)
- Last Month
- This Year
- Custom date range
## Shortcodes ## Shortcodes
Display buildings and rooms on your site using shortcodes: Display buildings and rooms on your site using shortcodes:
@@ -143,6 +221,152 @@ Available sidebar widgets:
- **Building Rooms** - List all rooms in a building - **Building Rooms** - List all rooms in a building
- **Availability Calendar** - Mini calendar showing booking status - **Availability Calendar** - Mini calendar showing booking status
## Contact Form 7 Integration
The plugin integrates with Contact Form 7 to accept booking requests and inquiries. Custom form tags are provided for room selection, date pickers, and guest counts.
### Custom Form Tags
Use these tags in your CF7 forms:
- `[bnb_building_select name]` - Building dropdown (optional filter for rooms)
- `[bnb_room_select* name]` - Room dropdown with capacity data
- `[bnb_date_checkin* name]` - Check-in date picker
- `[bnb_date_checkout* name]` - Check-out date picker
- `[bnb_guests* name]` - Guest count input
### Tag Options
**`[bnb_building_select]`**:
- `first_as_label:"text"` - Placeholder text (default: "All Locations")
**`[bnb_room_select]`**:
- `building_field:"name"` - Link to building field for filtering
- `first_as_label:"text"` - Placeholder text (default: "Select Room")
**`[bnb_guests]`**:
- `min:N` - Minimum guests (default: 1)
- `max:N` - Maximum guests (default: 10)
- `default:N` - Default value (default: 1)
### Example Booking Form
```txt
<div class="wp-bnb-booking-form">
<h3>Book Your Stay</h3>
<div class="wp-bnb-form-row">
[bnb_building_select building first_as_label:"All Locations"]
</div>
<div class="wp-bnb-form-row">
[bnb_room_select* room building_field:"building" first_as_label:"Select a Room"]
</div>
<div class="wp-bnb-form-row-2col">
<div class="wp-bnb-form-field">
<label>Check-in</label>
[bnb_date_checkin* check_in]
</div>
<div class="wp-bnb-form-field">
<label>Check-out</label>
[bnb_date_checkout* check_out]
</div>
</div>
<div class="wp-bnb-availability-status"></div>
<div class="wp-bnb-form-row">
<label>Number of Guests</label>
[bnb_guests* guests min:1 max:10 default:2]
</div>
<div class="wp-bnb-price-display"></div>
<h4>Your Information</h4>
<div class="wp-bnb-form-row-2col">
<div class="wp-bnb-form-field">
<label>First Name</label>
[text* first_name]
</div>
<div class="wp-bnb-form-field">
<label>Last Name</label>
[text* last_name]
</div>
</div>
<div class="wp-bnb-form-row">
<label>Email</label>
[email* your_email]
</div>
<div class="wp-bnb-form-row">
<label>Phone</label>
[tel your_phone]
</div>
<div class="wp-bnb-form-row">
<label>Message</label>
[textarea your_message]
</div>
[submit "Request Booking"]
</div>
```
### Example Inquiry Form
For room-specific inquiries, add the `wp-bnb-inquiry-form` class:
```txt
<div class="wp-bnb-inquiry-form">
<h3>Inquire About This Room</h3>
[hidden room default:123]
<div class="wp-bnb-form-row">
<label>Your Name</label>
[text* your_name]
</div>
<div class="wp-bnb-form-row">
<label>Email</label>
[email* your_email]
</div>
<div class="wp-bnb-form-row">
<label>Your Question</label>
[textarea* your_message]
</div>
[submit "Send Inquiry"]
</div>
```
### Form Features
- **Availability Checking**: Real-time AJAX validation shows room availability
- **Price Display**: Estimated total calculated and displayed automatically
- **Room Filtering**: Rooms filter by building selection
- **Date Validation**: Check-out must be after check-in, no past dates
- **Capacity Validation**: Guest count validated against room capacity
- **Automatic Booking**: Booking record created with "pending" status on submission
- **Guest Linking**: Guest records created or linked by email address
### Custom Mail Tags
Use these in your CF7 mail templates:
- `[_bnb_room_name]` - Room title
- `[_bnb_building_name]` - Building name
- `[_bnb_calculated_price]` - Formatted price
- `[_bnb_nights]` - Number of nights
- `[_bnb_booking_reference]` - Booking reference (after creation)
## Hooks and Filters ## Hooks and Filters
Developers can customize behavior using these hooks: Developers can customize behavior using these hooks:
@@ -160,6 +384,66 @@ add_action( 'wp_bnb_before_booking_create', function( $booking_data ) {
} ); } );
``` ```
## Prometheus Metrics
The plugin integrates with [WP Prometheus](https://src.bundespruefstelle.ch/magdev/wp-prometheus) to expose operational metrics for monitoring with Prometheus and Grafana.
### Enabling Metrics
1. Install and activate the WP Prometheus plugin
2. Navigate to **WP BnB → Settings → Metrics**
3. Enable "Expose BnB metrics via Prometheus"
4. Metrics will be available at your site's `/metrics/` endpoint
### Available Metrics
**Inventory Metrics:**
- `wp_bnb_buildings_total` - Total number of buildings
- `wp_bnb_rooms_total{status}` - Rooms by status (available, occupied, maintenance, inactive)
- `wp_bnb_services_total{status}` - Services by status (active, inactive)
- `wp_bnb_total_capacity_beds` - Total bed capacity across all rooms
**Booking Metrics:**
- `wp_bnb_bookings_total{status}` - Bookings by status (pending, confirmed, checked_in, checked_out, cancelled)
- `wp_bnb_checkins_today` - Check-ins scheduled for today
- `wp_bnb_checkouts_today` - Check-outs scheduled for today
- `wp_bnb_bookings_upcoming_7days` - Bookings starting in next 7 days
- `wp_bnb_booking_avg_duration_nights` - Average booking duration
**Occupancy Metrics:**
- `wp_bnb_occupancy_rate_current` - Current room occupancy rate (percentage)
- `wp_bnb_occupancy_rate_this_month` - Monthly occupancy rate (percentage)
- `wp_bnb_rooms_currently_occupied` - Rooms currently occupied
**Revenue Metrics:**
- `wp_bnb_revenue_this_month{currency}` - Revenue for current month
- `wp_bnb_revenue_ytd{currency}` - Revenue year to date
- `wp_bnb_booking_avg_value{currency}` - Average booking value
- `wp_bnb_services_revenue_this_month{currency}` - Services revenue this month
**Guest Metrics:**
- `wp_bnb_guests_total` - Total registered guests
- `wp_bnb_guests_by_status{status}` - Guests by status (active, blocked, vip)
- `wp_bnb_guests_repeat` - Guests with more than one booking
- `wp_bnb_guests_new_this_month` - New guests this month
### Grafana Dashboard
A pre-configured Grafana dashboard is included at `assets/grafana/wp-bnb-dashboard.json`. If WP Prometheus is installed, the dashboard is automatically registered and available for export.
The dashboard includes:
- Occupancy gauges with color-coded thresholds
- Bookings, rooms, and guests pie charts by status
- Revenue and guest statistics panels
- Today's check-ins/check-outs
- Trend indicators
## Frequently Asked Questions ## Frequently Asked Questions
### Do I need a license to use this plugin? ### Do I need a license to use this plugin?

View File

@@ -4,7 +4,382 @@
* @package Magdev\WpBnb * @package Magdev\WpBnb
*/ */
/* Dashboard */ /* ============================================
Dashboard
============================================ */
.wp-bnb-dashboard-grid {
margin-top: 20px;
}
.wp-bnb-dashboard-row {
display: grid;
gap: 20px;
margin-bottom: 20px;
}
/* Stats Row - 4 columns */
.wp-bnb-stats-row {
grid-template-columns: repeat(4, 1fr);
}
/* Charts Row - 2 columns */
.wp-bnb-charts-row {
grid-template-columns: repeat(2, 1fr);
}
/* Activity Row - 3 columns */
.wp-bnb-activity-row {
grid-template-columns: 1fr 1.5fr 1fr;
}
/* Responsive adjustments */
@media screen and (max-width: 1400px) {
.wp-bnb-stats-row {
grid-template-columns: repeat(2, 1fr);
}
.wp-bnb-activity-row {
grid-template-columns: 1fr 1fr;
}
.wp-bnb-activity-row .wp-bnb-quick-actions {
grid-column: span 2;
}
}
@media screen and (max-width: 782px) {
.wp-bnb-stats-row,
.wp-bnb-charts-row,
.wp-bnb-activity-row {
grid-template-columns: 1fr;
}
.wp-bnb-activity-row .wp-bnb-quick-actions {
grid-column: span 1;
}
}
/* Stat Cards */
.wp-bnb-stat-card {
background: #fff;
border: 1px solid #c3c4c7;
border-radius: 8px;
padding: 20px;
display: flex;
align-items: flex-start;
gap: 15px;
transition: box-shadow 0.2s ease;
}
.wp-bnb-stat-card:hover {
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
}
.wp-bnb-stat-icon {
width: 48px;
height: 48px;
border-radius: 12px;
background: linear-gradient(135deg, #2271b1, #135e96);
display: flex;
align-items: center;
justify-content: center;
flex-shrink: 0;
}
.wp-bnb-stat-icon.revenue {
background: linear-gradient(135deg, #00a32a, #007017);
}
.wp-bnb-stat-icon.bookings {
background: linear-gradient(135deg, #9b59b6, #8e44ad);
}
.wp-bnb-stat-icon.guests {
background: linear-gradient(135deg, #e67e22, #d35400);
}
.wp-bnb-stat-icon .dashicons {
color: #fff;
font-size: 24px;
width: 24px;
height: 24px;
}
.wp-bnb-stat-content {
flex: 1;
min-width: 0;
}
.wp-bnb-stat-label {
font-size: 13px;
color: #50575e;
margin-bottom: 4px;
}
.wp-bnb-stat-value {
font-size: 28px;
font-weight: 600;
color: #1d2327;
line-height: 1.2;
margin-bottom: 4px;
}
.wp-bnb-stat-meta {
font-size: 12px;
color: #787c82;
}
.wp-bnb-stat-change {
display: inline-flex;
align-items: center;
gap: 4px;
font-size: 12px;
margin-top: 8px;
padding: 2px 8px;
border-radius: 4px;
}
.wp-bnb-stat-change.positive {
background: #d4edda;
color: #00a32a;
}
.wp-bnb-stat-change.negative {
background: #f8d7da;
color: #d63638;
}
.wp-bnb-stat-change .dashicons {
font-size: 14px;
width: 14px;
height: 14px;
}
/* Widgets */
.wp-bnb-widget {
background: #fff;
border: 1px solid #c3c4c7;
border-radius: 8px;
overflow: hidden;
}
.wp-bnb-widget-header {
display: flex;
align-items: center;
justify-content: space-between;
padding: 15px 20px;
background: #f6f7f7;
border-bottom: 1px solid #c3c4c7;
}
.wp-bnb-widget-header h3 {
margin: 0;
font-size: 14px;
font-weight: 600;
color: #1d2327;
}
.wp-bnb-widget-header .wp-bnb-widget-date {
font-size: 12px;
color: #787c82;
}
.wp-bnb-widget-header .wp-bnb-view-all {
font-size: 12px;
text-decoration: none;
}
.wp-bnb-widget-content {
padding: 20px;
}
/* Chart Widgets */
.wp-bnb-chart-widget .wp-bnb-widget-content {
padding: 15px;
}
/* Empty State */
.wp-bnb-empty-state {
text-align: center;
padding: 30px 20px;
color: #787c82;
}
.wp-bnb-empty-state .dashicons {
font-size: 48px;
width: 48px;
height: 48px;
color: #c3c4c7;
margin-bottom: 10px;
}
.wp-bnb-empty-state p {
margin: 0;
font-size: 13px;
}
/* Activity Section */
.wp-bnb-activity-section {
margin-bottom: 20px;
}
.wp-bnb-activity-section:last-child {
margin-bottom: 0;
}
.wp-bnb-activity-section h4 {
display: flex;
align-items: center;
gap: 8px;
margin: 0 0 12px;
padding-bottom: 8px;
border-bottom: 1px solid #f0f0f1;
font-size: 13px;
font-weight: 600;
color: #1d2327;
}
.wp-bnb-activity-section h4 .dashicons {
font-size: 16px;
width: 16px;
height: 16px;
color: #2271b1;
}
.wp-bnb-activity-section h4 .count {
background: #2271b1;
color: #fff;
font-size: 11px;
font-weight: 600;
padding: 2px 6px;
border-radius: 10px;
margin-left: auto;
}
.wp-bnb-activity-list {
list-style: none;
margin: 0;
padding: 0;
}
.wp-bnb-activity-list li {
margin-bottom: 8px;
}
.wp-bnb-activity-list li:last-child {
margin-bottom: 0;
}
.wp-bnb-activity-list a {
display: flex;
align-items: center;
justify-content: space-between;
padding: 8px 12px;
background: #f6f7f7;
border-radius: 4px;
text-decoration: none;
transition: background 0.15s ease;
}
.wp-bnb-activity-list a:hover {
background: #dcdcde;
}
.wp-bnb-activity-list strong {
color: #1d2327;
font-weight: 600;
}
.wp-bnb-activity-list .room {
font-size: 12px;
color: #787c82;
}
/* Upcoming Bookings Table */
.wp-bnb-upcoming-table {
width: 100%;
border-collapse: collapse;
}
.wp-bnb-upcoming-table th {
text-align: left;
padding: 8px 12px;
font-size: 12px;
font-weight: 600;
color: #50575e;
background: #f6f7f7;
border-bottom: 1px solid #c3c4c7;
}
.wp-bnb-upcoming-table td {
padding: 10px 12px;
font-size: 13px;
border-bottom: 1px solid #f0f0f1;
vertical-align: middle;
}
.wp-bnb-upcoming-table tr:last-child td {
border-bottom: none;
}
.wp-bnb-upcoming-table a {
color: #2271b1;
text-decoration: none;
font-weight: 500;
}
.wp-bnb-upcoming-table a:hover {
color: #135e96;
text-decoration: underline;
}
.wp-bnb-upcoming-table .wp-bnb-status-badge {
font-size: 10px;
padding: 3px 8px;
}
/* Quick Actions */
.wp-bnb-quick-actions .wp-bnb-widget-content {
padding: 15px;
}
.wp-bnb-actions-grid {
display: grid;
grid-template-columns: repeat(2, 1fr);
gap: 10px;
}
.wp-bnb-action-btn {
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
gap: 8px;
padding: 20px 10px;
background: #f6f7f7;
border: 1px solid #c3c4c7;
border-radius: 6px;
text-decoration: none;
color: #1d2327;
transition: all 0.2s ease;
}
.wp-bnb-action-btn:hover {
background: #2271b1;
border-color: #2271b1;
color: #fff;
}
.wp-bnb-action-btn .dashicons {
font-size: 24px;
width: 24px;
height: 24px;
}
.wp-bnb-action-btn span:last-child {
font-size: 12px;
font-weight: 500;
text-align: center;
}
/* Legacy Dashboard (backward compatibility) */
.wp-bnb-dashboard { .wp-bnb-dashboard {
background: #fff; background: #fff;
border: 1px solid #c3c4c7; border: 1px solid #c3c4c7;
@@ -1345,3 +1720,305 @@
font-size: 18px; font-size: 18px;
color: #135e96; color: #135e96;
} }
/* ============================================
Reports Page
============================================ */
/* Reports Tabs */
.wp-bnb-reports-tabs .nav-tab {
display: inline-flex;
align-items: center;
gap: 6px;
}
.wp-bnb-reports-tabs .nav-tab .dashicons {
font-size: 16px;
width: 16px;
height: 16px;
}
/* Reports Content Container */
.wp-bnb-reports-content {
background: #fff;
border: 1px solid #c3c4c7;
border-top: none;
padding: 20px;
}
/* Reports Filters */
.wp-bnb-reports-filters {
display: flex;
align-items: center;
justify-content: space-between;
flex-wrap: wrap;
gap: 15px;
padding: 15px 20px;
background: #f6f7f7;
border: 1px solid #c3c4c7;
border-radius: 4px;
margin-bottom: 20px;
}
.wp-bnb-filter-form {
display: flex;
align-items: center;
gap: 15px;
flex-wrap: wrap;
}
.wp-bnb-filter-group {
display: flex;
align-items: center;
gap: 8px;
}
.wp-bnb-filter-group label {
font-weight: 600;
font-size: 13px;
color: #50575e;
}
.wp-bnb-period-select {
min-width: 150px;
}
.wp-bnb-custom-dates {
display: flex;
align-items: center;
gap: 8px;
}
.wp-bnb-custom-dates input[type="date"] {
width: 140px;
}
.wp-bnb-report-period {
font-size: 13px;
color: #50575e;
}
.wp-bnb-report-period strong {
color: #1d2327;
}
/* Report Body */
.wp-bnb-report-body {
margin-bottom: 20px;
}
.wp-bnb-report-section {
margin-bottom: 30px;
}
.wp-bnb-report-section h3 {
font-size: 14px;
font-weight: 600;
color: #1d2327;
margin: 25px 0 15px;
padding-bottom: 8px;
border-bottom: 1px solid #c3c4c7;
}
.wp-bnb-report-section h3:first-child {
margin-top: 0;
}
/* Summary Cards */
.wp-bnb-summary-cards {
display: grid;
grid-template-columns: repeat(4, 1fr);
gap: 15px;
margin-bottom: 25px;
}
.wp-bnb-summary-cards.secondary {
grid-template-columns: repeat(3, 1fr);
margin-bottom: 30px;
}
@media screen and (max-width: 1200px) {
.wp-bnb-summary-cards {
grid-template-columns: repeat(2, 1fr);
}
.wp-bnb-summary-cards.secondary {
grid-template-columns: repeat(3, 1fr);
}
}
@media screen and (max-width: 782px) {
.wp-bnb-summary-cards,
.wp-bnb-summary-cards.secondary {
grid-template-columns: 1fr;
}
}
.wp-bnb-summary-card {
background: #f6f7f7;
border: 1px solid #c3c4c7;
border-radius: 6px;
padding: 20px;
text-align: center;
}
.wp-bnb-summary-card.primary {
background: linear-gradient(135deg, #d4edda, #c3e6cb);
border-color: #a3d4aa;
}
.wp-bnb-summary-card.small {
padding: 15px;
}
.wp-bnb-summary-value {
display: block;
font-size: 28px;
font-weight: 700;
color: #2271b1;
line-height: 1.2;
margin-bottom: 5px;
}
.wp-bnb-summary-card.primary .wp-bnb-summary-value {
color: #00a32a;
}
.wp-bnb-summary-card.small .wp-bnb-summary-value {
font-size: 20px;
}
.wp-bnb-summary-label {
display: block;
font-size: 12px;
color: #50575e;
text-transform: uppercase;
letter-spacing: 0.5px;
}
/* Report Tables */
.wp-bnb-report-table {
border-collapse: collapse;
}
.wp-bnb-report-table th,
.wp-bnb-report-table td {
padding: 10px 12px;
text-align: left;
}
.wp-bnb-report-table th.num,
.wp-bnb-report-table td.num {
text-align: right;
}
.wp-bnb-report-table tfoot th {
background: #f0f6fc;
font-weight: 600;
}
.wp-bnb-report-table a {
color: #2271b1;
text-decoration: none;
}
.wp-bnb-report-table a:hover {
color: #135e96;
text-decoration: underline;
}
/* Progress Bar */
.wp-bnb-progress-bar {
position: relative;
background: #dcdcde;
border-radius: 10px;
height: 20px;
overflow: hidden;
min-width: 100px;
}
.wp-bnb-progress-fill {
position: absolute;
top: 0;
left: 0;
height: 100%;
background: linear-gradient(90deg, #2271b1, #135e96);
border-radius: 10px;
transition: width 0.3s ease;
}
.wp-bnb-progress-text {
position: absolute;
top: 50%;
left: 50%;
transform: translate(-50%, -50%);
font-size: 11px;
font-weight: 600;
color: #1d2327;
text-shadow: 0 0 3px #fff;
}
/* Status Labels */
.wp-bnb-status {
display: inline-block;
padding: 3px 8px;
border-radius: 4px;
font-size: 11px;
font-weight: 600;
text-transform: uppercase;
}
.wp-bnb-status.high {
background: #d4edda;
color: #00a32a;
}
.wp-bnb-status.medium {
background: #fff3cd;
color: #856404;
}
.wp-bnb-status.low {
background: #f8d7da;
color: #d63638;
}
/* No Data Message */
.wp-bnb-no-data {
padding: 30px;
text-align: center;
color: #787c82;
font-style: italic;
background: #f6f7f7;
border-radius: 4px;
}
/* Export Buttons */
.wp-bnb-export-buttons {
padding: 20px;
background: #f6f7f7;
border: 1px solid #c3c4c7;
border-radius: 4px;
}
.wp-bnb-export-buttons h4 {
margin: 0 0 15px;
font-size: 14px;
font-weight: 600;
}
.wp-bnb-export-actions {
display: flex;
gap: 10px;
}
.wp-bnb-export-actions .button {
display: inline-flex;
align-items: center;
gap: 6px;
}
.wp-bnb-export-actions .button .dashicons {
font-size: 16px;
width: 16px;
height: 16px;
}

View File

@@ -0,0 +1,344 @@
/**
* WP BnB Contact Form 7 Integration Styles
*
* Styling for CF7 booking forms.
*
* @package Magdev\WpBnb
*/
/* Custom Properties */
:root {
--wp-bnb-cf7-primary: #2271b1;
--wp-bnb-cf7-success: #00a32a;
--wp-bnb-cf7-warning: #dba617;
--wp-bnb-cf7-error: #d63638;
--wp-bnb-cf7-text: #1d2327;
--wp-bnb-cf7-text-light: #646970;
--wp-bnb-cf7-border: #c3c4c7;
--wp-bnb-cf7-bg: #f0f0f1;
--wp-bnb-cf7-radius: 4px;
--wp-bnb-cf7-spacing: 1rem;
}
/* Form Layout */
.wp-bnb-booking-form,
.wp-bnb-inquiry-form {
max-width: 700px;
margin: 0 auto;
}
.wp-bnb-booking-form h3,
.wp-bnb-booking-form h4,
.wp-bnb-inquiry-form h3,
.wp-bnb-inquiry-form h4 {
margin-top: 1.5em;
margin-bottom: 0.75em;
padding-bottom: 0.5em;
border-bottom: 1px solid var(--wp-bnb-cf7-border);
}
.wp-bnb-booking-form h3:first-child,
.wp-bnb-inquiry-form h3:first-child {
margin-top: 0;
}
/* Form Rows */
.wp-bnb-form-row {
margin-bottom: var(--wp-bnb-cf7-spacing);
}
.wp-bnb-form-row-2col {
display: grid;
grid-template-columns: 1fr 1fr;
gap: var(--wp-bnb-cf7-spacing);
}
@media (max-width: 480px) {
.wp-bnb-form-row-2col {
grid-template-columns: 1fr;
}
}
/* Form Fields */
.wp-bnb-form-field {
display: flex;
flex-direction: column;
}
.wp-bnb-form-field label {
display: block;
margin-bottom: 0.25rem;
font-weight: 600;
font-size: 0.875rem;
color: var(--wp-bnb-cf7-text);
}
/* Custom CF7 Tags Styling */
.wp-bnb-building-select,
.wp-bnb-room-select,
.wp-bnb-date-checkin,
.wp-bnb-date-checkout,
.wp-bnb-guests {
width: 100%;
padding: 0.5rem 0.75rem;
font-size: 1rem;
line-height: 1.5;
border: 1px solid var(--wp-bnb-cf7-border);
border-radius: var(--wp-bnb-cf7-radius);
background-color: #fff;
transition: border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out;
}
.wp-bnb-building-select:focus,
.wp-bnb-room-select:focus,
.wp-bnb-date-checkin:focus,
.wp-bnb-date-checkout:focus,
.wp-bnb-guests:focus {
outline: none;
border-color: var(--wp-bnb-cf7-primary);
box-shadow: 0 0 0 2px rgba(34, 113, 177, 0.25);
}
/* Select dropdown */
.wp-bnb-room-select optgroup {
font-weight: 600;
font-style: normal;
color: var(--wp-bnb-cf7-text);
}
/* Date inputs */
.wp-bnb-date-checkin,
.wp-bnb-date-checkout {
cursor: pointer;
}
/* Number input */
.wp-bnb-guests {
max-width: 120px;
}
/* Availability Status */
.wp-bnb-availability-status {
padding: var(--wp-bnb-cf7-spacing);
margin: var(--wp-bnb-cf7-spacing) 0;
background-color: var(--wp-bnb-cf7-bg);
border-radius: var(--wp-bnb-cf7-radius);
text-align: center;
min-height: 50px;
display: flex;
align-items: center;
justify-content: center;
}
.wp-bnb-availability-status:empty {
display: none;
}
.wp-bnb-checking {
color: var(--wp-bnb-cf7-text-light);
font-style: italic;
}
.wp-bnb-checking::before {
content: "";
display: inline-block;
width: 16px;
height: 16px;
margin-right: 8px;
border: 2px solid var(--wp-bnb-cf7-border);
border-top-color: var(--wp-bnb-cf7-primary);
border-radius: 50%;
animation: wp-bnb-spin 0.8s linear infinite;
vertical-align: middle;
}
@keyframes wp-bnb-spin {
to {
transform: rotate(360deg);
}
}
.wp-bnb-available {
color: var(--wp-bnb-cf7-success);
font-weight: 600;
}
.wp-bnb-available::before {
content: "\2713";
display: inline-block;
margin-right: 8px;
font-size: 1.25em;
}
.wp-bnb-unavailable {
color: var(--wp-bnb-cf7-error);
font-weight: 600;
}
.wp-bnb-unavailable::before {
content: "\2717";
display: inline-block;
margin-right: 8px;
font-size: 1.25em;
}
/* Price Display */
.wp-bnb-price-display {
padding: var(--wp-bnb-cf7-spacing);
margin: var(--wp-bnb-cf7-spacing) 0;
background-color: #e7f5ea;
border: 1px solid var(--wp-bnb-cf7-success);
border-radius: var(--wp-bnb-cf7-radius);
text-align: center;
}
.wp-bnb-price-display:empty {
display: none;
}
.wp-bnb-price-label {
color: var(--wp-bnb-cf7-text-light);
font-size: 0.875rem;
}
.wp-bnb-price-amount {
font-size: 1.5rem;
font-weight: 700;
color: var(--wp-bnb-cf7-success);
margin: 0 0.5rem;
}
.wp-bnb-nights {
color: var(--wp-bnb-cf7-text-light);
font-size: 0.875rem;
}
/* Capacity Warning */
.wp-bnb-capacity-warning {
display: block;
margin-top: 0.25rem;
padding: 0.25rem 0.5rem;
font-size: 0.8125rem;
color: var(--wp-bnb-cf7-error);
background-color: #fcf0f1;
border-radius: var(--wp-bnb-cf7-radius);
}
/* Validation Errors */
.wpcf7-form-control-wrap .wpcf7-not-valid-tip {
color: var(--wp-bnb-cf7-error);
font-size: 0.8125rem;
margin-top: 0.25rem;
}
.wpcf7-form-control.wpcf7-not-valid {
border-color: var(--wp-bnb-cf7-error);
}
/* Response Messages */
.wpcf7 form.sent .wpcf7-response-output {
border-color: var(--wp-bnb-cf7-success);
background-color: #e7f5ea;
color: var(--wp-bnb-cf7-success);
}
.wpcf7 form.failed .wpcf7-response-output,
.wpcf7 form.aborted .wpcf7-response-output,
.wpcf7 form.spam .wpcf7-response-output,
.wpcf7 form.invalid .wpcf7-response-output {
border-color: var(--wp-bnb-cf7-error);
background-color: #fcf0f1;
color: var(--wp-bnb-cf7-error);
}
/* Submit Button */
.wp-bnb-booking-form .wpcf7-submit,
.wp-bnb-inquiry-form .wpcf7-submit {
display: inline-block;
padding: 0.75rem 1.5rem;
font-size: 1rem;
font-weight: 600;
color: #fff;
background-color: var(--wp-bnb-cf7-primary);
border: none;
border-radius: var(--wp-bnb-cf7-radius);
cursor: pointer;
transition: background-color 0.15s ease-in-out;
}
.wp-bnb-booking-form .wpcf7-submit:hover,
.wp-bnb-inquiry-form .wpcf7-submit:hover {
background-color: #135e96;
}
.wp-bnb-booking-form .wpcf7-submit:disabled,
.wp-bnb-inquiry-form .wpcf7-submit:disabled {
opacity: 0.7;
cursor: not-allowed;
}
/* Spinner */
.wpcf7 .wpcf7-spinner {
margin-left: 0.5rem;
}
/* Hidden Room Field (for inquiry forms) */
.wp-bnb-inquiry-form input[type="hidden"] + .wpcf7-form-control-wrap {
display: none;
}
/* Form Section Headers */
.wp-bnb-booking-form hr,
.wp-bnb-inquiry-form hr {
margin: 1.5rem 0;
border: none;
border-top: 1px solid var(--wp-bnb-cf7-border);
}
/* Dark Mode Support */
@media (prefers-color-scheme: dark) {
:root {
--wp-bnb-cf7-text: #f0f0f1;
--wp-bnb-cf7-text-light: #a7aaad;
--wp-bnb-cf7-border: #50575e;
--wp-bnb-cf7-bg: #2c3338;
}
.wp-bnb-building-select,
.wp-bnb-room-select,
.wp-bnb-date-checkin,
.wp-bnb-date-checkout,
.wp-bnb-guests {
background-color: #3c434a;
color: var(--wp-bnb-cf7-text);
}
.wp-bnb-price-display {
background-color: #1a3320;
border-color: var(--wp-bnb-cf7-success);
}
.wp-bnb-capacity-warning {
background-color: #3c1618;
}
.wpcf7 form.sent .wpcf7-response-output {
background-color: #1a3320;
}
.wpcf7 form.failed .wpcf7-response-output,
.wpcf7 form.aborted .wpcf7-response-output,
.wpcf7 form.spam .wpcf7-response-output,
.wpcf7 form.invalid .wpcf7-response-output {
background-color: #3c1618;
}
}
/* Print Styles */
@media print {
.wp-bnb-availability-status,
.wp-bnb-price-display,
.wpcf7-submit {
display: none;
}
}

File diff suppressed because it is too large Load Diff

View File

@@ -1024,6 +1024,181 @@
updateServicesTotal(); updateServicesTotal();
} }
/**
* Initialize dashboard charts.
*/
function initDashboardCharts() {
// Only run on dashboard page.
if (!wpBnbAdmin.isDashboard || typeof Chart === 'undefined') {
return;
}
var chartData = wpBnbAdmin.chartData;
if (!chartData) {
return;
}
// Chart.js default configuration.
Chart.defaults.font.family = '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen-Sans, Ubuntu, Cantarell, "Helvetica Neue", sans-serif';
Chart.defaults.font.size = 12;
Chart.defaults.color = '#50575e';
// Initialize Occupancy Chart.
var occupancyCtx = document.getElementById('wp-bnb-occupancy-chart');
if (occupancyCtx && chartData.occupancy) {
new Chart(occupancyCtx, {
type: 'line',
data: {
labels: chartData.occupancy.labels,
datasets: [{
label: wpBnbAdmin.i18n.occupancy,
data: chartData.occupancy.data,
borderColor: '#2271b1',
backgroundColor: 'rgba(34, 113, 177, 0.1)',
fill: true,
tension: 0.3,
pointRadius: 3,
pointHoverRadius: 5,
pointBackgroundColor: '#2271b1',
pointBorderColor: '#fff',
pointBorderWidth: 2
}]
},
options: {
responsive: true,
maintainAspectRatio: false,
plugins: {
legend: {
display: false
},
tooltip: {
backgroundColor: '#1d2327',
titleColor: '#fff',
bodyColor: '#fff',
padding: 12,
displayColors: false,
callbacks: {
label: function(context) {
return context.parsed.y.toFixed(1) + '%';
}
}
}
},
scales: {
y: {
beginAtZero: true,
max: 100,
ticks: {
callback: function(value) {
return value + '%';
}
},
grid: {
color: 'rgba(0, 0, 0, 0.05)'
}
},
x: {
grid: {
display: false
}
}
},
interaction: {
intersect: false,
mode: 'index'
}
}
});
}
// Initialize Revenue Chart.
var revenueCtx = document.getElementById('wp-bnb-revenue-chart');
if (revenueCtx && chartData.revenue) {
new Chart(revenueCtx, {
type: 'bar',
data: {
labels: chartData.revenue.labels,
datasets: [{
label: wpBnbAdmin.i18n.revenue,
data: chartData.revenue.data,
backgroundColor: 'rgba(0, 163, 42, 0.8)',
borderColor: '#00a32a',
borderWidth: 1,
borderRadius: 4,
barPercentage: 0.6
}]
},
options: {
responsive: true,
maintainAspectRatio: false,
plugins: {
legend: {
display: false
},
tooltip: {
backgroundColor: '#1d2327',
titleColor: '#fff',
bodyColor: '#fff',
padding: 12,
displayColors: false,
callbacks: {
label: function(context) {
return new Intl.NumberFormat('de-CH', {
style: 'currency',
currency: 'CHF'
}).format(context.parsed.y);
}
}
}
},
scales: {
y: {
beginAtZero: true,
ticks: {
callback: function(value) {
return new Intl.NumberFormat('de-CH', {
style: 'currency',
currency: 'CHF',
maximumFractionDigits: 0
}).format(value);
}
},
grid: {
color: 'rgba(0, 0, 0, 0.05)'
}
},
x: {
grid: {
display: false
}
}
}
}
});
}
}
/**
* Initialize reports page functionality.
*/
function initReportsPage() {
var $periodSelect = $('.wp-bnb-period-select');
var $customDates = $('.wp-bnb-custom-dates');
if (!$periodSelect.length) {
return;
}
// Toggle custom date fields based on period selection.
$periodSelect.on('change', function() {
if ($(this).val() === 'custom') {
$customDates.show();
} else {
$customDates.hide();
}
});
}
// Initialize on document ready. // Initialize on document ready.
$(document).ready(function() { $(document).ready(function() {
initLicenseManagement(); initLicenseManagement();
@@ -1037,6 +1212,8 @@
initGuestSearch(); initGuestSearch();
initServicePricing(); initServicePricing();
initBookingServices(); initBookingServices();
initDashboardCharts();
initReportsPage();
}); });
})(jQuery); })(jQuery);

View File

@@ -0,0 +1,375 @@
/**
* WP BnB Contact Form 7 Integration
*
* Handles dynamic form behavior for booking forms.
*
* @package Magdev\WpBnb
*/
(function() {
'use strict';
const WpBnbCF7 = {
config: window.wpBnbCF7 || {},
/**
* Initialize all CF7 integration features.
*/
init: function() {
this.initBuildingRoomFilter();
this.initDateValidation();
this.initCapacityValidation();
this.initAvailabilityCheck();
this.initPriceDisplay();
},
/**
* Filter rooms dropdown when building is selected.
*/
initBuildingRoomFilter: function() {
document.querySelectorAll('[data-bnb-building-select]').forEach(function(buildingSelect) {
const form = buildingSelect.closest('form');
const roomSelect = form ? form.querySelector('[data-bnb-room-select]') : null;
if (!roomSelect) return;
// Store all options for filtering
const allOptions = Array.from(roomSelect.querySelectorAll('option, optgroup'));
const originalHTML = roomSelect.innerHTML;
buildingSelect.addEventListener('change', function() {
const selectedBuilding = buildingSelect.value;
// Show all options if no building selected
if (!selectedBuilding) {
roomSelect.innerHTML = originalHTML;
roomSelect.dispatchEvent(new Event('change'));
return;
}
// Filter options by building
roomSelect.innerHTML = '';
// Add placeholder option
const placeholder = document.createElement('option');
placeholder.value = '';
placeholder.textContent = WpBnbCF7.config.i18n?.selectRoom || '-- Select Room --';
roomSelect.appendChild(placeholder);
allOptions.forEach(function(el) {
if (el.tagName === 'OPTGROUP') {
// Check if any options in this optgroup match
const matchingOptions = Array.from(el.querySelectorAll('option')).filter(function(opt) {
return opt.dataset.building === selectedBuilding;
});
if (matchingOptions.length > 0) {
const clonedGroup = el.cloneNode(false);
matchingOptions.forEach(function(opt) {
clonedGroup.appendChild(opt.cloneNode(true));
});
roomSelect.appendChild(clonedGroup);
}
}
});
// Trigger change to update dependent fields
roomSelect.dispatchEvent(new Event('change'));
});
});
},
/**
* Validate and link check-in/check-out dates.
*/
initDateValidation: function() {
document.querySelectorAll('[data-bnb-checkin]').forEach(function(checkinInput) {
const form = checkinInput.closest('form');
const checkoutInput = form ? form.querySelector('[data-bnb-checkout]') : null;
if (!checkoutInput) return;
// Set minimum check-in to today
const today = WpBnbCF7.formatDate(new Date());
if (!checkinInput.getAttribute('min') || checkinInput.getAttribute('min') < today) {
checkinInput.setAttribute('min', today);
}
checkinInput.addEventListener('change', function() {
if (checkinInput.value) {
// Set checkout minimum to checkin + 1 day
const minCheckout = new Date(checkinInput.value);
minCheckout.setDate(minCheckout.getDate() + 1);
checkoutInput.setAttribute('min', WpBnbCF7.formatDate(minCheckout));
// Clear checkout if it's now invalid
if (checkoutInput.value && checkoutInput.value <= checkinInput.value) {
checkoutInput.value = '';
}
// Trigger availability check
WpBnbCF7.triggerAvailabilityCheck(form);
}
});
checkoutInput.addEventListener('change', function() {
if (checkoutInput.value && checkinInput.value) {
if (checkoutInput.value <= checkinInput.value) {
alert(WpBnbCF7.config.i18n?.invalidDateRange || 'Check-out must be after check-in');
checkoutInput.value = '';
return;
}
// Trigger availability check
WpBnbCF7.triggerAvailabilityCheck(form);
}
});
});
},
/**
* Validate guest count against room capacity.
*/
initCapacityValidation: function() {
document.querySelectorAll('[data-bnb-guests]').forEach(function(guestsInput) {
const form = guestsInput.closest('form');
const roomSelect = form ? form.querySelector('[data-bnb-room-select]') : null;
if (!roomSelect) return;
const validateCapacity = function() {
const selectedOption = roomSelect.selectedOptions[0];
const capacity = parseInt(selectedOption?.dataset.capacity || 99, 10);
const guests = parseInt(guestsInput.value || 0, 10);
// Update max attribute
guestsInput.setAttribute('max', capacity);
// Show warning if over capacity
const wrapper = guestsInput.closest('.wpcf7-form-control-wrap');
let warning = wrapper ? wrapper.querySelector('.wp-bnb-capacity-warning') : null;
if (guests > capacity) {
if (!warning && wrapper) {
warning = document.createElement('span');
warning.className = 'wp-bnb-capacity-warning';
wrapper.appendChild(warning);
}
if (warning) {
warning.textContent = (WpBnbCF7.config.i18n?.capacityExceeded || 'Maximum %d guests for this room').replace('%d', capacity);
}
} else if (warning) {
warning.remove();
}
};
roomSelect.addEventListener('change', validateCapacity);
guestsInput.addEventListener('change', validateCapacity);
guestsInput.addEventListener('input', validateCapacity);
});
},
/**
* Initialize AJAX availability checking.
*/
initAvailabilityCheck: function() {
// Find forms with availability display
document.querySelectorAll('.wp-bnb-availability-status').forEach(function(statusEl) {
const form = statusEl.closest('form');
if (form) {
form._availabilityStatus = statusEl;
}
});
},
/**
* Trigger availability check for a form.
*
* @param {HTMLFormElement} form Form element.
*/
triggerAvailabilityCheck: function(form) {
const roomSelect = form.querySelector('[data-bnb-room-select]');
const checkinInput = form.querySelector('[data-bnb-checkin]');
const checkoutInput = form.querySelector('[data-bnb-checkout]');
const statusEl = form._availabilityStatus || form.querySelector('.wp-bnb-availability-status');
const priceEl = form.querySelector('.wp-bnb-price-display');
if (!roomSelect || !checkinInput || !checkoutInput) return;
const roomId = roomSelect.value;
const checkIn = checkinInput.value;
const checkOut = checkoutInput.value;
if (!roomId || !checkIn || !checkOut) {
if (statusEl) statusEl.innerHTML = '';
if (priceEl) priceEl.innerHTML = '';
return;
}
// Show loading state
if (statusEl) {
statusEl.innerHTML = '<span class="wp-bnb-checking">' + (WpBnbCF7.config.i18n?.checking || 'Checking availability...') + '</span>';
}
// Make AJAX request
WpBnbCF7.ajax('wp_bnb_get_availability', {
room_id: roomId,
check_in: checkIn,
check_out: checkOut
})
.then(function(response) {
if (statusEl) {
if (response.available) {
let html = '<span class="wp-bnb-available">' + (WpBnbCF7.config.i18n?.available || 'Room is available!') + '</span>';
statusEl.innerHTML = html;
} else {
statusEl.innerHTML = '<span class="wp-bnb-unavailable">' + (WpBnbCF7.config.i18n?.unavailable || 'Room is not available for these dates') + '</span>';
}
}
// Update price display
if (priceEl && response.available && response.price_formatted) {
priceEl.innerHTML = '<span class="wp-bnb-price-label">' + (WpBnbCF7.config.i18n?.estimatedTotal || 'Estimated Total') + ':</span> ' +
'<span class="wp-bnb-price-amount">' + response.price_formatted + '</span> ' +
'<span class="wp-bnb-nights">(' + response.nights + ' ' + (WpBnbCF7.config.i18n?.nights || 'nights') + ')</span>';
} else if (priceEl) {
priceEl.innerHTML = '';
}
})
.catch(function(error) {
console.error('Availability check failed:', error);
if (statusEl) {
statusEl.innerHTML = '';
}
});
},
/**
* Initialize price display updates.
*/
initPriceDisplay: function() {
const self = this;
document.querySelectorAll('.wp-bnb-price-display').forEach(function(priceEl) {
const form = priceEl.closest('form');
if (!form) return;
const updatePrice = self.debounce(function() {
const roomSelect = form.querySelector('[data-bnb-room-select]');
const checkinInput = form.querySelector('[data-bnb-checkin]');
const checkoutInput = form.querySelector('[data-bnb-checkout]');
if (!roomSelect?.value || !checkinInput?.value || !checkoutInput?.value) {
priceEl.innerHTML = '';
return;
}
self.ajax('wp_bnb_calculate_price', {
room_id: roomSelect.value,
check_in: checkinInput.value,
check_out: checkoutInput.value
})
.then(function(response) {
priceEl.innerHTML = '<span class="wp-bnb-price-label">' + (self.config.i18n?.estimatedTotal || 'Estimated Total') + ':</span> ' +
'<span class="wp-bnb-price-amount">' + response.price_formatted + '</span> ' +
'<span class="wp-bnb-nights">(' + response.nights + ' ' + (self.config.i18n?.nights || 'nights') + ')</span>';
})
.catch(function() {
priceEl.innerHTML = '';
});
}, 500);
// Bind to relevant field changes
form.querySelectorAll('[data-bnb-room-select], [data-bnb-checkin], [data-bnb-checkout]')
.forEach(function(input) {
input.addEventListener('change', updatePrice);
});
});
},
/**
* Make AJAX request.
*
* @param {string} action AJAX action name.
* @param {object} data Request data.
* @return {Promise}
*/
ajax: function(action, data) {
data = data || {};
const formData = new FormData();
formData.append('action', action);
formData.append('nonce', this.config.nonce || '');
Object.keys(data).forEach(function(key) {
if (data[key] !== null && data[key] !== undefined) {
formData.append(key, data[key]);
}
});
return fetch(this.config.ajaxUrl || '/wp-admin/admin-ajax.php', {
method: 'POST',
body: formData,
credentials: 'same-origin'
})
.then(function(response) {
return response.json();
})
.then(function(responseData) {
if (!responseData.success) {
throw new Error(responseData.data?.message || 'Request failed');
}
return responseData.data;
});
},
/**
* Format date as YYYY-MM-DD.
*
* @param {Date} date Date object.
* @return {string}
*/
formatDate: function(date) {
const year = date.getFullYear();
const month = String(date.getMonth() + 1).padStart(2, '0');
const day = String(date.getDate()).padStart(2, '0');
return year + '-' + month + '-' + day;
},
/**
* Debounce function.
*
* @param {function} func Function to debounce.
* @param {number} wait Milliseconds to wait.
* @return {function}
*/
debounce: function(func, wait) {
let timeout;
return function() {
const context = this;
const args = arguments;
clearTimeout(timeout);
timeout = setTimeout(function() {
func.apply(context, args);
}, wait);
};
}
};
// Initialize on DOM ready
if (document.readyState === 'loading') {
document.addEventListener('DOMContentLoaded', function() {
WpBnbCF7.init();
});
} else {
WpBnbCF7.init();
}
// Re-initialize on CF7 form reset
document.addEventListener('wpcf7reset', function(event) {
setTimeout(function() {
WpBnbCF7.init();
}, 100);
});
// Export to window for external access
window.WpBnbCF7 = WpBnbCF7;
})();

View File

@@ -22,7 +22,8 @@
"require": { "require": {
"php": ">=8.3.0", "php": ">=8.3.0",
"twig/twig": "^3.0", "twig/twig": "^3.0",
"magdev/wc-licensed-product-client": "^0.2" "magdev/wc-licensed-product-client": "^0.2",
"mpdf/mpdf": "^8.2"
}, },
"autoload": { "autoload": {
"psr-4": { "psr-4": {

357
composer.lock generated
View File

@@ -4,7 +4,7 @@
"Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
"This file is @generated automatically" "This file is @generated automatically"
], ],
"content-hash": "aed1e4dd36ea76994768a8379100314b", "content-hash": "ae9fdb5fb51bbef492ad4f2a40406fd3",
"packages": [ "packages": [
{ {
"name": "magdev/wc-licensed-product-client", "name": "magdev/wc-licensed-product-client",
@@ -56,6 +56,289 @@
"relative": true "relative": true
} }
}, },
{
"name": "mpdf/mpdf",
"version": "v8.2.7",
"source": {
"type": "git",
"url": "https://github.com/mpdf/mpdf.git",
"reference": "b59670a09498689c33ce639bac8f5ba26721dab3"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/mpdf/mpdf/zipball/b59670a09498689c33ce639bac8f5ba26721dab3",
"reference": "b59670a09498689c33ce639bac8f5ba26721dab3",
"shasum": ""
},
"require": {
"ext-gd": "*",
"ext-mbstring": "*",
"mpdf/psr-http-message-shim": "^1.0 || ^2.0",
"mpdf/psr-log-aware-trait": "^2.0 || ^3.0",
"myclabs/deep-copy": "^1.7",
"paragonie/random_compat": "^1.4|^2.0|^9.99.99",
"php": "^5.6 || ^7.0 || ~8.0.0 || ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0",
"psr/http-message": "^1.0 || ^2.0",
"psr/log": "^1.0 || ^2.0 || ^3.0",
"setasign/fpdi": "^2.1"
},
"require-dev": {
"mockery/mockery": "^1.3.0",
"mpdf/qrcode": "^1.1.0",
"squizlabs/php_codesniffer": "^3.5.0",
"tracy/tracy": "~2.5",
"yoast/phpunit-polyfills": "^1.0"
},
"suggest": {
"ext-bcmath": "Needed for generation of some types of barcodes",
"ext-xml": "Needed mainly for SVG manipulation",
"ext-zlib": "Needed for compression of embedded resources, such as fonts"
},
"type": "library",
"autoload": {
"files": [
"src/functions.php"
],
"psr-4": {
"Mpdf\\": "src/"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"GPL-2.0-only"
],
"authors": [
{
"name": "Matěj Humpál",
"role": "Developer, maintainer"
},
{
"name": "Ian Back",
"role": "Developer (retired)"
}
],
"description": "PHP library generating PDF files from UTF-8 encoded HTML",
"homepage": "https://mpdf.github.io",
"keywords": [
"pdf",
"php",
"utf-8"
],
"support": {
"docs": "https://mpdf.github.io",
"issues": "https://github.com/mpdf/mpdf/issues",
"source": "https://github.com/mpdf/mpdf"
},
"funding": [
{
"url": "https://www.paypal.me/mpdf",
"type": "custom"
}
],
"time": "2025-12-01T10:18:02+00:00"
},
{
"name": "mpdf/psr-http-message-shim",
"version": "v2.0.1",
"source": {
"type": "git",
"url": "https://github.com/mpdf/psr-http-message-shim.git",
"reference": "f25a0153d645e234f9db42e5433b16d9b113920f"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/mpdf/psr-http-message-shim/zipball/f25a0153d645e234f9db42e5433b16d9b113920f",
"reference": "f25a0153d645e234f9db42e5433b16d9b113920f",
"shasum": ""
},
"require": {
"psr/http-message": "^2.0"
},
"type": "library",
"autoload": {
"psr-4": {
"Mpdf\\PsrHttpMessageShim\\": "src/"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"MIT"
],
"authors": [
{
"name": "Mark Dorison",
"email": "mark@chromatichq.com"
},
{
"name": "Kristofer Widholm",
"email": "kristofer@chromatichq.com"
},
{
"name": "Nigel Cunningham",
"email": "nigel.cunningham@technocrat.com.au"
}
],
"description": "Shim to allow support of different psr/message versions.",
"support": {
"issues": "https://github.com/mpdf/psr-http-message-shim/issues",
"source": "https://github.com/mpdf/psr-http-message-shim/tree/v2.0.1"
},
"time": "2023-10-02T14:34:03+00:00"
},
{
"name": "mpdf/psr-log-aware-trait",
"version": "v3.0.0",
"source": {
"type": "git",
"url": "https://github.com/mpdf/psr-log-aware-trait.git",
"reference": "a633da6065e946cc491e1c962850344bb0bf3e78"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/mpdf/psr-log-aware-trait/zipball/a633da6065e946cc491e1c962850344bb0bf3e78",
"reference": "a633da6065e946cc491e1c962850344bb0bf3e78",
"shasum": ""
},
"require": {
"psr/log": "^3.0"
},
"type": "library",
"autoload": {
"psr-4": {
"Mpdf\\PsrLogAwareTrait\\": "src/"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"MIT"
],
"authors": [
{
"name": "Mark Dorison",
"email": "mark@chromatichq.com"
},
{
"name": "Kristofer Widholm",
"email": "kristofer@chromatichq.com"
}
],
"description": "Trait to allow support of different psr/log versions.",
"support": {
"issues": "https://github.com/mpdf/psr-log-aware-trait/issues",
"source": "https://github.com/mpdf/psr-log-aware-trait/tree/v3.0.0"
},
"time": "2023-05-03T06:19:36+00:00"
},
{
"name": "myclabs/deep-copy",
"version": "1.13.4",
"source": {
"type": "git",
"url": "https://github.com/myclabs/DeepCopy.git",
"reference": "07d290f0c47959fd5eed98c95ee5602db07e0b6a"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/myclabs/DeepCopy/zipball/07d290f0c47959fd5eed98c95ee5602db07e0b6a",
"reference": "07d290f0c47959fd5eed98c95ee5602db07e0b6a",
"shasum": ""
},
"require": {
"php": "^7.1 || ^8.0"
},
"conflict": {
"doctrine/collections": "<1.6.8",
"doctrine/common": "<2.13.3 || >=3 <3.2.2"
},
"require-dev": {
"doctrine/collections": "^1.6.8",
"doctrine/common": "^2.13.3 || ^3.2.2",
"phpspec/prophecy": "^1.10",
"phpunit/phpunit": "^7.5.20 || ^8.5.23 || ^9.5.13"
},
"type": "library",
"autoload": {
"files": [
"src/DeepCopy/deep_copy.php"
],
"psr-4": {
"DeepCopy\\": "src/DeepCopy/"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"MIT"
],
"description": "Create deep copies (clones) of your objects",
"keywords": [
"clone",
"copy",
"duplicate",
"object",
"object graph"
],
"support": {
"issues": "https://github.com/myclabs/DeepCopy/issues",
"source": "https://github.com/myclabs/DeepCopy/tree/1.13.4"
},
"funding": [
{
"url": "https://tidelift.com/funding/github/packagist/myclabs/deep-copy",
"type": "tidelift"
}
],
"time": "2025-08-01T08:46:24+00:00"
},
{
"name": "paragonie/random_compat",
"version": "v9.99.100",
"source": {
"type": "git",
"url": "https://github.com/paragonie/random_compat.git",
"reference": "996434e5492cb4c3edcb9168db6fbb1359ef965a"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/paragonie/random_compat/zipball/996434e5492cb4c3edcb9168db6fbb1359ef965a",
"reference": "996434e5492cb4c3edcb9168db6fbb1359ef965a",
"shasum": ""
},
"require": {
"php": ">= 7"
},
"require-dev": {
"phpunit/phpunit": "4.*|5.*",
"vimeo/psalm": "^1"
},
"suggest": {
"ext-libsodium": "Provides a modern crypto API that can be used to generate random bytes."
},
"type": "library",
"notification-url": "https://packagist.org/downloads/",
"license": [
"MIT"
],
"authors": [
{
"name": "Paragon Initiative Enterprises",
"email": "security@paragonie.com",
"homepage": "https://paragonie.com"
}
],
"description": "PHP 5.x polyfill for random_bytes() and random_int() from PHP 7",
"keywords": [
"csprng",
"polyfill",
"pseudorandom",
"random"
],
"support": {
"email": "info@paragonie.com",
"issues": "https://github.com/paragonie/random_compat/issues",
"source": "https://github.com/paragonie/random_compat"
},
"time": "2020-10-15T08:29:30+00:00"
},
{ {
"name": "psr/cache", "name": "psr/cache",
"version": "3.0.0", "version": "3.0.0",
@@ -313,6 +596,78 @@
}, },
"time": "2024-09-11T13:17:53+00:00" "time": "2024-09-11T13:17:53+00:00"
}, },
{
"name": "setasign/fpdi",
"version": "v2.6.4",
"source": {
"type": "git",
"url": "https://github.com/Setasign/FPDI.git",
"reference": "4b53852fde2734ec6a07e458a085db627c60eada"
},
"dist": {
"type": "zip",
"url": "https://api.github.com/repos/Setasign/FPDI/zipball/4b53852fde2734ec6a07e458a085db627c60eada",
"reference": "4b53852fde2734ec6a07e458a085db627c60eada",
"shasum": ""
},
"require": {
"ext-zlib": "*",
"php": "^7.1 || ^8.0"
},
"conflict": {
"setasign/tfpdf": "<1.31"
},
"require-dev": {
"phpunit/phpunit": "^7",
"setasign/fpdf": "~1.8.6",
"setasign/tfpdf": "~1.33",
"squizlabs/php_codesniffer": "^3.5",
"tecnickcom/tcpdf": "^6.8"
},
"suggest": {
"setasign/fpdf": "FPDI will extend this class but as it is also possible to use TCPDF or tFPDF as an alternative. There's no fixed dependency configured."
},
"type": "library",
"autoload": {
"psr-4": {
"setasign\\Fpdi\\": "src/"
}
},
"notification-url": "https://packagist.org/downloads/",
"license": [
"MIT"
],
"authors": [
{
"name": "Jan Slabon",
"email": "jan.slabon@setasign.com",
"homepage": "https://www.setasign.com"
},
{
"name": "Maximilian Kresse",
"email": "maximilian.kresse@setasign.com",
"homepage": "https://www.setasign.com"
}
],
"description": "FPDI is a collection of PHP classes facilitating developers to read pages from existing PDF documents and use them as templates in FPDF. Because it is also possible to use FPDI with TCPDF, there are no fixed dependencies defined. Please see suggestions for packages which evaluates the dependencies automatically.",
"homepage": "https://www.setasign.com/fpdi",
"keywords": [
"fpdf",
"fpdi",
"pdf"
],
"support": {
"issues": "https://github.com/Setasign/FPDI/issues",
"source": "https://github.com/Setasign/FPDI/tree/v2.6.4"
},
"funding": [
{
"url": "https://tidelift.com/funding/github/packagist/setasign/fpdi",
"type": "tidelift"
}
],
"time": "2025-08-05T09:57:14+00:00"
},
{ {
"name": "symfony/deprecation-contracts", "name": "symfony/deprecation-contracts",
"version": "v3.6.0", "version": "v3.6.0",

942
src/Admin/Dashboard.php Normal file
View File

@@ -0,0 +1,942 @@
<?php
/**
* Admin Dashboard page.
*
* Displays comprehensive dashboard with statistics, charts, and quick actions.
*
* @package Magdev\WpBnb\Admin
*/
declare( strict_types=1 );
namespace Magdev\WpBnb\Admin;
use Magdev\WpBnb\Booking\Availability;
use Magdev\WpBnb\License\Manager as LicenseManager;
use Magdev\WpBnb\PostTypes\Booking;
use Magdev\WpBnb\PostTypes\Building;
use Magdev\WpBnb\PostTypes\Guest;
use Magdev\WpBnb\PostTypes\Room;
use Magdev\WpBnb\Pricing\Calculator;
/**
* Dashboard class.
*/
final class Dashboard {
/**
* Cache key for dashboard stats.
*/
private const CACHE_KEY = 'wp_bnb_dashboard_stats';
/**
* Cache expiry in seconds (1 hour).
*/
private const CACHE_EXPIRY = HOUR_IN_SECONDS;
/**
* Render the dashboard page.
*
* @return void
*/
public static function render(): void {
$license_valid = LicenseManager::is_license_valid();
$is_localhost = LicenseManager::is_localhost();
?>
<div class="wrap">
<h1><?php esc_html_e( 'WP BnB Dashboard', 'wp-bnb' ); ?></h1>
<?php self::render_notices( $license_valid, $is_localhost ); ?>
<div class="wp-bnb-dashboard-grid">
<!-- Row 1: Stats Cards -->
<div class="wp-bnb-dashboard-row wp-bnb-stats-row">
<?php self::render_occupancy_card(); ?>
<?php self::render_revenue_card(); ?>
<?php self::render_bookings_card(); ?>
<?php self::render_guests_card(); ?>
</div>
<!-- Row 2: Charts -->
<div class="wp-bnb-dashboard-row wp-bnb-charts-row">
<?php self::render_occupancy_chart(); ?>
<?php self::render_revenue_chart(); ?>
</div>
<!-- Row 3: Activity and Quick Actions -->
<div class="wp-bnb-dashboard-row wp-bnb-activity-row">
<?php self::render_today_activity(); ?>
<?php self::render_upcoming_bookings(); ?>
<?php self::render_quick_actions(); ?>
</div>
</div>
</div>
<?php
}
/**
* Render admin notices.
*
* @param bool $license_valid Whether license is valid.
* @param bool $is_localhost Whether running on localhost.
* @return void
*/
private static function render_notices( bool $license_valid, bool $is_localhost ): void {
if ( $is_localhost ) :
?>
<div class="notice notice-info">
<p>
<span class="dashicons dashicons-info" style="color: #72aee6;"></span>
<strong><?php esc_html_e( 'Development Mode', 'wp-bnb' ); ?></strong>
<?php esc_html_e( 'You are running on a local development environment. All features are enabled.', 'wp-bnb' ); ?>
</p>
</div>
<?php
elseif ( ! $license_valid ) :
?>
<div class="notice notice-warning">
<p>
<?php
printf(
/* translators: %s: Link to settings page */
esc_html__( 'Your license is not active. Please %s to unlock all features.', 'wp-bnb' ),
'<a href="' . esc_url( admin_url( 'admin.php?page=wp-bnb-settings&tab=license' ) ) . '">' . esc_html__( 'activate your license', 'wp-bnb' ) . '</a>'
);
?>
</p>
</div>
<?php
endif;
}
/**
* Render occupancy stat card.
*
* @return void
*/
private static function render_occupancy_card(): void {
$stats = self::get_occupancy_stats();
$rate = $stats['rate'];
$occupied = $stats['occupied'];
$total = $stats['total'];
$previous_rate = $stats['previous_rate'];
$change = $rate - $previous_rate;
$change_class = $change >= 0 ? 'positive' : 'negative';
$change_icon = $change >= 0 ? 'arrow-up-alt' : 'arrow-down-alt';
?>
<div class="wp-bnb-stat-card">
<div class="wp-bnb-stat-icon">
<span class="dashicons dashicons-admin-home"></span>
</div>
<div class="wp-bnb-stat-content">
<div class="wp-bnb-stat-label"><?php esc_html_e( 'Current Occupancy', 'wp-bnb' ); ?></div>
<div class="wp-bnb-stat-value"><?php echo esc_html( number_format( $rate, 1 ) ); ?>%</div>
<div class="wp-bnb-stat-meta">
<?php
printf(
/* translators: 1: Number of occupied rooms, 2: Total rooms */
esc_html__( '%1$d of %2$d rooms', 'wp-bnb' ),
$occupied,
$total
);
?>
</div>
<?php if ( $previous_rate > 0 ) : ?>
<div class="wp-bnb-stat-change <?php echo esc_attr( $change_class ); ?>">
<span class="dashicons dashicons-<?php echo esc_attr( $change_icon ); ?>"></span>
<?php
printf(
/* translators: %s: Percentage change */
esc_html__( '%s%% vs last month', 'wp-bnb' ),
number_format( abs( $change ), 1 )
);
?>
</div>
<?php endif; ?>
</div>
</div>
<?php
}
/**
* Render revenue stat card.
*
* @return void
*/
private static function render_revenue_card(): void {
$stats = self::get_revenue_stats();
$this_month = $stats['this_month'];
$last_month = $stats['last_month'];
$change = $last_month > 0 ? ( ( $this_month - $last_month ) / $last_month ) * 100 : 0;
$change_class = $change >= 0 ? 'positive' : 'negative';
$change_icon = $change >= 0 ? 'arrow-up-alt' : 'arrow-down-alt';
?>
<div class="wp-bnb-stat-card">
<div class="wp-bnb-stat-icon revenue">
<span class="dashicons dashicons-chart-area"></span>
</div>
<div class="wp-bnb-stat-content">
<div class="wp-bnb-stat-label"><?php esc_html_e( 'Revenue This Month', 'wp-bnb' ); ?></div>
<div class="wp-bnb-stat-value"><?php echo esc_html( Calculator::formatPrice( $this_month ) ); ?></div>
<div class="wp-bnb-stat-meta">
<?php
printf(
/* translators: %s: Year-to-date revenue */
esc_html__( 'YTD: %s', 'wp-bnb' ),
Calculator::formatPrice( $stats['ytd'] )
);
?>
</div>
<?php if ( $last_month > 0 ) : ?>
<div class="wp-bnb-stat-change <?php echo esc_attr( $change_class ); ?>">
<span class="dashicons dashicons-<?php echo esc_attr( $change_icon ); ?>"></span>
<?php
printf(
/* translators: %s: Percentage change */
esc_html__( '%s%% vs last month', 'wp-bnb' ),
number_format( abs( $change ), 1 )
);
?>
</div>
<?php endif; ?>
</div>
</div>
<?php
}
/**
* Render bookings stat card.
*
* @return void
*/
private static function render_bookings_card(): void {
$stats = self::get_booking_stats();
?>
<div class="wp-bnb-stat-card">
<div class="wp-bnb-stat-icon bookings">
<span class="dashicons dashicons-calendar-alt"></span>
</div>
<div class="wp-bnb-stat-content">
<div class="wp-bnb-stat-label"><?php esc_html_e( 'Bookings This Month', 'wp-bnb' ); ?></div>
<div class="wp-bnb-stat-value"><?php echo esc_html( $stats['this_month'] ); ?></div>
<div class="wp-bnb-stat-meta">
<?php
printf(
/* translators: 1: Pending count, 2: Confirmed count */
esc_html__( '%1$d pending, %2$d confirmed', 'wp-bnb' ),
$stats['pending'],
$stats['confirmed']
);
?>
</div>
</div>
</div>
<?php
}
/**
* Render guests stat card.
*
* @return void
*/
private static function render_guests_card(): void {
$stats = self::get_guest_stats();
?>
<div class="wp-bnb-stat-card">
<div class="wp-bnb-stat-icon guests">
<span class="dashicons dashicons-groups"></span>
</div>
<div class="wp-bnb-stat-content">
<div class="wp-bnb-stat-label"><?php esc_html_e( 'Total Guests', 'wp-bnb' ); ?></div>
<div class="wp-bnb-stat-value"><?php echo esc_html( $stats['total'] ); ?></div>
<div class="wp-bnb-stat-meta">
<?php
printf(
/* translators: 1: New guests this month, 2: Repeat guests count */
esc_html__( '%1$d new this month, %2$d repeat', 'wp-bnb' ),
$stats['new_this_month'],
$stats['repeat']
);
?>
</div>
</div>
</div>
<?php
}
/**
* Render occupancy trend chart.
*
* @return void
*/
private static function render_occupancy_chart(): void {
?>
<div class="wp-bnb-widget wp-bnb-chart-widget">
<div class="wp-bnb-widget-header">
<h3><?php esc_html_e( 'Occupancy Trend (Last 30 Days)', 'wp-bnb' ); ?></h3>
</div>
<div class="wp-bnb-widget-content">
<canvas id="wp-bnb-occupancy-chart" height="200"></canvas>
</div>
</div>
<?php
}
/**
* Render revenue trend chart.
*
* @return void
*/
private static function render_revenue_chart(): void {
?>
<div class="wp-bnb-widget wp-bnb-chart-widget">
<div class="wp-bnb-widget-header">
<h3><?php esc_html_e( 'Revenue Trend (Last 6 Months)', 'wp-bnb' ); ?></h3>
</div>
<div class="wp-bnb-widget-content">
<canvas id="wp-bnb-revenue-chart" height="200"></canvas>
</div>
</div>
<?php
}
/**
* Render today's activity widget.
*
* @return void
*/
private static function render_today_activity(): void {
$checkins = Availability::get_todays_checkins();
$checkouts = Availability::get_todays_checkouts();
?>
<div class="wp-bnb-widget">
<div class="wp-bnb-widget-header">
<h3><?php esc_html_e( "Today's Activity", 'wp-bnb' ); ?></h3>
<span class="wp-bnb-widget-date"><?php echo esc_html( wp_date( get_option( 'date_format' ) ) ); ?></span>
</div>
<div class="wp-bnb-widget-content">
<?php if ( empty( $checkins ) && empty( $checkouts ) ) : ?>
<div class="wp-bnb-empty-state">
<span class="dashicons dashicons-calendar"></span>
<p><?php esc_html_e( 'No check-ins or check-outs scheduled for today.', 'wp-bnb' ); ?></p>
</div>
<?php else : ?>
<?php if ( ! empty( $checkins ) ) : ?>
<div class="wp-bnb-activity-section">
<h4>
<span class="dashicons dashicons-migrate"></span>
<?php esc_html_e( 'Check-ins', 'wp-bnb' ); ?>
<span class="count"><?php echo count( $checkins ); ?></span>
</h4>
<ul class="wp-bnb-activity-list">
<?php foreach ( $checkins as $booking ) : ?>
<?php
$guest_name = get_post_meta( $booking->ID, '_bnb_booking_guest_name', true );
$room_id = get_post_meta( $booking->ID, '_bnb_booking_room_id', true );
$room = get_post( $room_id );
?>
<li>
<a href="<?php echo esc_url( get_edit_post_link( $booking->ID ) ); ?>">
<strong><?php echo esc_html( $guest_name ); ?></strong>
<?php if ( $room ) : ?>
<span class="room"><?php echo esc_html( $room->post_title ); ?></span>
<?php endif; ?>
</a>
</li>
<?php endforeach; ?>
</ul>
</div>
<?php endif; ?>
<?php if ( ! empty( $checkouts ) ) : ?>
<div class="wp-bnb-activity-section">
<h4>
<span class="dashicons dashicons-external"></span>
<?php esc_html_e( 'Check-outs', 'wp-bnb' ); ?>
<span class="count"><?php echo count( $checkouts ); ?></span>
</h4>
<ul class="wp-bnb-activity-list">
<?php foreach ( $checkouts as $booking ) : ?>
<?php
$guest_name = get_post_meta( $booking->ID, '_bnb_booking_guest_name', true );
$room_id = get_post_meta( $booking->ID, '_bnb_booking_room_id', true );
$room = get_post( $room_id );
?>
<li>
<a href="<?php echo esc_url( get_edit_post_link( $booking->ID ) ); ?>">
<strong><?php echo esc_html( $guest_name ); ?></strong>
<?php if ( $room ) : ?>
<span class="room"><?php echo esc_html( $room->post_title ); ?></span>
<?php endif; ?>
</a>
</li>
<?php endforeach; ?>
</ul>
</div>
<?php endif; ?>
<?php endif; ?>
</div>
</div>
<?php
}
/**
* Render upcoming bookings widget.
*
* @return void
*/
private static function render_upcoming_bookings(): void {
$bookings = self::get_upcoming_bookings( 7 );
?>
<div class="wp-bnb-widget">
<div class="wp-bnb-widget-header">
<h3><?php esc_html_e( 'Upcoming Bookings', 'wp-bnb' ); ?></h3>
<a href="<?php echo esc_url( admin_url( 'edit.php?post_type=' . Booking::POST_TYPE ) ); ?>" class="wp-bnb-view-all">
<?php esc_html_e( 'View All', 'wp-bnb' ); ?>
</a>
</div>
<div class="wp-bnb-widget-content">
<?php if ( empty( $bookings ) ) : ?>
<div class="wp-bnb-empty-state">
<span class="dashicons dashicons-calendar-alt"></span>
<p><?php esc_html_e( 'No upcoming bookings in the next 7 days.', 'wp-bnb' ); ?></p>
</div>
<?php else : ?>
<table class="wp-bnb-upcoming-table">
<thead>
<tr>
<th><?php esc_html_e( 'Guest', 'wp-bnb' ); ?></th>
<th><?php esc_html_e( 'Room', 'wp-bnb' ); ?></th>
<th><?php esc_html_e( 'Check-in', 'wp-bnb' ); ?></th>
<th><?php esc_html_e( 'Status', 'wp-bnb' ); ?></th>
</tr>
</thead>
<tbody>
<?php foreach ( $bookings as $booking ) : ?>
<?php
$guest_name = get_post_meta( $booking->ID, '_bnb_booking_guest_name', true );
$room_id = get_post_meta( $booking->ID, '_bnb_booking_room_id', true );
$check_in = get_post_meta( $booking->ID, '_bnb_booking_check_in', true );
$status = get_post_meta( $booking->ID, '_bnb_booking_status', true );
$room = get_post( $room_id );
$statuses = Booking::get_booking_statuses();
$colors = Booking::get_status_colors();
?>
<tr>
<td>
<a href="<?php echo esc_url( get_edit_post_link( $booking->ID ) ); ?>">
<?php echo esc_html( $guest_name ); ?>
</a>
</td>
<td><?php echo $room ? esc_html( $room->post_title ) : '—'; ?></td>
<td><?php echo esc_html( wp_date( get_option( 'date_format' ), strtotime( $check_in ) ) ); ?></td>
<td>
<span class="wp-bnb-status-badge" style="background-color: <?php echo esc_attr( $colors[ $status ] ?? '#666' ); ?>">
<?php echo esc_html( $statuses[ $status ] ?? $status ); ?>
</span>
</td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
<?php endif; ?>
</div>
</div>
<?php
}
/**
* Render quick actions widget.
*
* @return void
*/
private static function render_quick_actions(): void {
?>
<div class="wp-bnb-widget wp-bnb-quick-actions">
<div class="wp-bnb-widget-header">
<h3><?php esc_html_e( 'Quick Actions', 'wp-bnb' ); ?></h3>
</div>
<div class="wp-bnb-widget-content">
<div class="wp-bnb-actions-grid">
<a href="<?php echo esc_url( admin_url( 'post-new.php?post_type=' . Booking::POST_TYPE ) ); ?>" class="wp-bnb-action-btn">
<span class="dashicons dashicons-plus-alt"></span>
<span><?php esc_html_e( 'New Booking', 'wp-bnb' ); ?></span>
</a>
<a href="<?php echo esc_url( admin_url( 'post-new.php?post_type=' . Guest::POST_TYPE ) ); ?>" class="wp-bnb-action-btn">
<span class="dashicons dashicons-admin-users"></span>
<span><?php esc_html_e( 'New Guest', 'wp-bnb' ); ?></span>
</a>
<a href="<?php echo esc_url( admin_url( 'admin.php?page=wp-bnb-calendar' ) ); ?>" class="wp-bnb-action-btn">
<span class="dashicons dashicons-calendar-alt"></span>
<span><?php esc_html_e( 'View Calendar', 'wp-bnb' ); ?></span>
</a>
<a href="<?php echo esc_url( admin_url( 'admin.php?page=wp-bnb-reports' ) ); ?>" class="wp-bnb-action-btn">
<span class="dashicons dashicons-analytics"></span>
<span><?php esc_html_e( 'View Reports', 'wp-bnb' ); ?></span>
</a>
</div>
</div>
</div>
<?php
}
/**
* Get occupancy statistics.
*
* @return array{rate: float, occupied: int, total: int, previous_rate: float}
*/
public static function get_occupancy_stats(): array {
// Get total rooms.
$rooms = get_posts(
array(
'post_type' => Room::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => -1,
'fields' => 'ids',
)
);
$total_rooms = count( $rooms );
// Get currently occupied rooms.
$current_bookings = Availability::get_current_bookings();
$occupied_rooms = count( $current_bookings );
$rate = $total_rooms > 0 ? ( $occupied_rooms / $total_rooms ) * 100 : 0;
// Calculate last month's average occupancy.
$previous_rate = self::get_average_occupancy_for_month(
(int) gmdate( 'Y', strtotime( '-1 month' ) ),
(int) gmdate( 'n', strtotime( '-1 month' ) )
);
return array(
'rate' => $rate,
'occupied' => $occupied_rooms,
'total' => $total_rooms,
'previous_rate' => $previous_rate,
);
}
/**
* Get average occupancy rate for a specific month.
*
* @param int $year Year.
* @param int $month Month.
* @return float Average occupancy percentage.
*/
private static function get_average_occupancy_for_month( int $year, int $month ): float {
$cache_key = self::CACHE_KEY . "_occupancy_{$year}_{$month}";
$cached = get_transient( $cache_key );
if ( false !== $cached ) {
return (float) $cached;
}
$rooms = get_posts(
array(
'post_type' => Room::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => -1,
'fields' => 'ids',
)
);
$total_rooms = count( $rooms );
if ( $total_rooms === 0 ) {
return 0.0;
}
$days_in_month = (int) gmdate( 't', mktime( 0, 0, 0, $month, 1, $year ) );
$total_room_nights = $total_rooms * $days_in_month;
$booked_nights = 0;
$month_start = sprintf( '%04d-%02d-01', $year, $month );
$month_end = sprintf( '%04d-%02d-%02d', $year, $month, $days_in_month );
$bookings = get_posts(
array(
'post_type' => Booking::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => -1,
'meta_query' => array(
'relation' => 'AND',
array(
'key' => '_bnb_booking_status',
'value' => array( 'confirmed', 'checked_in', 'checked_out' ),
'compare' => 'IN',
),
array(
'key' => '_bnb_booking_check_in',
'value' => $month_end,
'compare' => '<=',
'type' => 'DATE',
),
array(
'key' => '_bnb_booking_check_out',
'value' => $month_start,
'compare' => '>=',
'type' => 'DATE',
),
),
)
);
foreach ( $bookings as $booking ) {
$check_in = get_post_meta( $booking->ID, '_bnb_booking_check_in', true );
$check_out = get_post_meta( $booking->ID, '_bnb_booking_check_out', true );
// Clamp to month boundaries.
$start = max( $check_in, $month_start );
$end = min( $check_out, gmdate( 'Y-m-d', strtotime( $month_end . ' +1 day' ) ) );
$nights = Booking::calculate_nights( $start, $end );
$booked_nights += $nights;
}
$rate = ( $booked_nights / $total_room_nights ) * 100;
set_transient( $cache_key, $rate, self::CACHE_EXPIRY );
return $rate;
}
/**
* Get revenue statistics.
*
* @return array{this_month: float, last_month: float, ytd: float}
*/
public static function get_revenue_stats(): array {
$this_month = self::get_revenue_for_period(
gmdate( 'Y-m-01' ),
gmdate( 'Y-m-t' )
);
$last_month = self::get_revenue_for_period(
gmdate( 'Y-m-01', strtotime( '-1 month' ) ),
gmdate( 'Y-m-t', strtotime( '-1 month' ) )
);
$ytd = self::get_revenue_for_period(
gmdate( 'Y-01-01' ),
gmdate( 'Y-m-d' )
);
return array(
'this_month' => $this_month,
'last_month' => $last_month,
'ytd' => $ytd,
);
}
/**
* Get revenue for a specific period.
*
* @param string $start_date Start date (Y-m-d).
* @param string $end_date End date (Y-m-d).
* @return float Total revenue.
*/
public static function get_revenue_for_period( string $start_date, string $end_date ): float {
$bookings = get_posts(
array(
'post_type' => Booking::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => -1,
'meta_query' => array(
'relation' => 'AND',
array(
'key' => '_bnb_booking_status',
'value' => array( 'confirmed', 'checked_in', 'checked_out' ),
'compare' => 'IN',
),
array(
'key' => '_bnb_booking_check_in',
'value' => $start_date,
'compare' => '>=',
'type' => 'DATE',
),
array(
'key' => '_bnb_booking_check_in',
'value' => $end_date,
'compare' => '<=',
'type' => 'DATE',
),
),
)
);
$total = 0.0;
foreach ( $bookings as $booking ) {
$price = get_post_meta( $booking->ID, '_bnb_booking_calculated_price', true );
$total += (float) $price;
// Add services total.
$services_total = Booking::calculate_booking_services_total( $booking->ID );
$total += $services_total;
}
return $total;
}
/**
* Get booking statistics.
*
* @return array{this_month: int, pending: int, confirmed: int}
*/
public static function get_booking_stats(): array {
$month_start = gmdate( 'Y-m-01' );
$month_end = gmdate( 'Y-m-t' );
// Bookings created this month.
$this_month = get_posts(
array(
'post_type' => Booking::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => -1,
'fields' => 'ids',
'date_query' => array(
array(
'after' => $month_start,
'before' => $month_end,
'inclusive' => true,
),
),
)
);
// Pending bookings.
$pending = get_posts(
array(
'post_type' => Booking::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => -1,
'fields' => 'ids',
'meta_query' => array(
array(
'key' => '_bnb_booking_status',
'value' => 'pending',
),
),
)
);
// Confirmed bookings.
$confirmed = get_posts(
array(
'post_type' => Booking::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => -1,
'fields' => 'ids',
'meta_query' => array(
array(
'key' => '_bnb_booking_status',
'value' => 'confirmed',
),
),
)
);
return array(
'this_month' => count( $this_month ),
'pending' => count( $pending ),
'confirmed' => count( $confirmed ),
);
}
/**
* Get guest statistics.
*
* @return array{total: int, new_this_month: int, repeat: int}
*/
public static function get_guest_stats(): array {
$month_start = gmdate( 'Y-m-01' );
$month_end = gmdate( 'Y-m-t' );
// Total guests.
$total = get_posts(
array(
'post_type' => Guest::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => -1,
'fields' => 'ids',
)
);
// New guests this month.
$new_this_month = get_posts(
array(
'post_type' => Guest::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => -1,
'fields' => 'ids',
'date_query' => array(
array(
'after' => $month_start,
'before' => $month_end,
'inclusive' => true,
),
),
)
);
// Repeat guests (2+ bookings).
$all_guests = get_posts(
array(
'post_type' => Guest::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => -1,
)
);
$repeat = 0;
foreach ( $all_guests as $guest ) {
$booking_count = Guest::get_booking_count( $guest->ID );
if ( $booking_count >= 2 ) {
++$repeat;
}
}
return array(
'total' => count( $total ),
'new_this_month' => count( $new_this_month ),
'repeat' => $repeat,
);
}
/**
* Get upcoming bookings.
*
* @param int $days Number of days to look ahead.
* @return array<\WP_Post> Array of booking posts.
*/
private static function get_upcoming_bookings( int $days = 7 ): array {
$today = gmdate( 'Y-m-d' );
$end_date = gmdate( 'Y-m-d', strtotime( "+{$days} days" ) );
return get_posts(
array(
'post_type' => Booking::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => 10,
'meta_query' => array(
'relation' => 'AND',
array(
'key' => '_bnb_booking_status',
'value' => array( 'pending', 'confirmed' ),
'compare' => 'IN',
),
array(
'key' => '_bnb_booking_check_in',
'value' => $today,
'compare' => '>=',
'type' => 'DATE',
),
array(
'key' => '_bnb_booking_check_in',
'value' => $end_date,
'compare' => '<=',
'type' => 'DATE',
),
),
'orderby' => 'meta_value',
'meta_key' => '_bnb_booking_check_in',
'order' => 'ASC',
)
);
}
/**
* Get occupancy trend data for charts.
*
* @param int $days Number of days to include.
* @return array{labels: array<string>, data: array<float>}
*/
public static function get_occupancy_trend_data( int $days = 30 ): array {
$labels = array();
$data = array();
$rooms = get_posts(
array(
'post_type' => Room::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => -1,
'fields' => 'ids',
)
);
$total_rooms = count( $rooms );
if ( $total_rooms === 0 ) {
return array(
'labels' => array(),
'data' => array(),
);
}
for ( $i = $days - 1; $i >= 0; $i-- ) {
$date = gmdate( 'Y-m-d', strtotime( "-{$i} days" ) );
$labels[] = wp_date( 'M j', strtotime( $date ) );
// Count bookings active on this date.
$bookings = get_posts(
array(
'post_type' => Booking::POST_TYPE,
'post_status' => 'publish',
'posts_per_page' => -1,
'fields' => 'ids',
'meta_query' => array(
'relation' => 'AND',
array(
'key' => '_bnb_booking_status',
'value' => array( 'confirmed', 'checked_in', 'checked_out' ),
'compare' => 'IN',
),
array(
'key' => '_bnb_booking_check_in',
'value' => $date,
'compare' => '<=',
'type' => 'DATE',
),
array(
'key' => '_bnb_booking_check_out',
'value' => $date,
'compare' => '>',
'type' => 'DATE',
),
),
)
);
$rate = ( count( $bookings ) / $total_rooms ) * 100;
$data[] = round( $rate, 1 );
}
return array(
'labels' => $labels,
'data' => $data,
);
}
/**
* Get revenue trend data for charts.
*
* @param int $months Number of months to include.
* @return array{labels: array<string>, data: array<float>}
*/
public static function get_revenue_trend_data( int $months = 6 ): array {
$labels = array();
$data = array();
for ( $i = $months - 1; $i >= 0; $i-- ) {
$month_start = gmdate( 'Y-m-01', strtotime( "-{$i} months" ) );
$month_end = gmdate( 'Y-m-t', strtotime( "-{$i} months" ) );
$month_name = gmdate( 'M Y', strtotime( $month_start ) );
$labels[] = $month_name;
$data[] = self::get_revenue_for_period( $month_start, $month_end );
}
return array(
'labels' => $labels,
'data' => $data,
);
}
}

1368
src/Admin/Reports.php Normal file

File diff suppressed because it is too large Load Diff

1654
src/Integration/CF7.php Normal file

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,877 @@
<?php
/**
* Prometheus Metrics Integration.
*
* Provides meaningful metrics for monitoring BnB operations.
*
* @package Magdev\WpBnb\Integration
*/
declare( strict_types=1 );
namespace Magdev\WpBnb\Integration;
use Magdev\WpBnb\PostTypes\Booking;
use Magdev\WpBnb\PostTypes\Building;
use Magdev\WpBnb\PostTypes\Guest;
use Magdev\WpBnb\PostTypes\Room;
use Magdev\WpBnb\PostTypes\Service;
/**
* Prometheus Metrics Integration class.
*
* Exposes BnB metrics via the wp-prometheus plugin.
*/
class Prometheus {
/**
* Option key for enabling metrics.
*/
public const OPTION_ENABLED = 'wp_bnb_metrics_enabled';
/**
* Initialize the Prometheus integration.
*
* @return void
*/
public static function init(): void {
// Only hook if metrics are enabled.
if ( ! self::is_enabled() ) {
return;
}
// Hook into wp-prometheus collector.
add_action( 'wp_prometheus_collect_metrics', array( self::class, 'collect_metrics' ) );
// Register Grafana dashboard.
add_action( 'wp_prometheus_register_dashboards', array( self::class, 'register_dashboards' ) );
}
/**
* Check if metrics collection is enabled.
*
* @return bool
*/
public static function is_enabled(): bool {
return 'yes' === get_option( self::OPTION_ENABLED, 'yes' );
}
/**
* Enable metrics collection.
*
* @return void
*/
public static function enable(): void {
update_option( self::OPTION_ENABLED, 'yes' );
}
/**
* Disable metrics collection.
*
* @return void
*/
public static function disable(): void {
update_option( self::OPTION_ENABLED, 'no' );
}
/**
* Collect and register all BnB metrics.
*
* @param object $collector The wp-prometheus collector instance.
* @return void
*/
public static function collect_metrics( $collector ): void {
self::collect_inventory_metrics( $collector );
self::collect_booking_metrics( $collector );
self::collect_guest_metrics( $collector );
self::collect_occupancy_metrics( $collector );
self::collect_revenue_metrics( $collector );
}
/**
* Collect inventory metrics (buildings, rooms, services).
*
* @param object $collector The wp-prometheus collector instance.
* @return void
*/
private static function collect_inventory_metrics( $collector ): void {
// Buildings total.
$buildings_total = wp_count_posts( Building::POST_TYPE );
$gauge = $collector->register_gauge(
'wp_bnb_buildings_total',
'Total number of buildings',
array()
);
$gauge->set( (int) $buildings_total->publish, array() );
// Rooms by status.
$rooms_gauge = $collector->register_gauge(
'wp_bnb_rooms_total',
'Total number of rooms by status',
array( 'status' )
);
$room_statuses = array( 'available', 'occupied', 'maintenance', 'inactive' );
foreach ( $room_statuses as $status ) {
$count = self::count_rooms_by_status( $status );
$rooms_gauge->set( $count, array( $status ) );
}
// Services by status.
$services_gauge = $collector->register_gauge(
'wp_bnb_services_total',
'Total number of services by status',
array( 'status' )
);
$service_statuses = array( 'active', 'inactive' );
foreach ( $service_statuses as $status ) {
$count = self::count_services_by_status( $status );
$services_gauge->set( $count, array( $status ) );
}
}
/**
* Collect booking metrics.
*
* @param object $collector The wp-prometheus collector instance.
* @return void
*/
private static function collect_booking_metrics( $collector ): void {
// Bookings by status.
$bookings_gauge = $collector->register_gauge(
'wp_bnb_bookings_total',
'Total number of bookings by status',
array( 'status' )
);
$booking_statuses = array( 'pending', 'confirmed', 'checked_in', 'checked_out', 'cancelled' );
foreach ( $booking_statuses as $status ) {
$count = self::count_bookings_by_status( $status );
$bookings_gauge->set( $count, array( $status ) );
}
// Today's check-ins.
$checkins_gauge = $collector->register_gauge(
'wp_bnb_checkins_today',
'Number of check-ins scheduled for today',
array()
);
$checkins_gauge->set( self::count_todays_checkins(), array() );
// Today's check-outs.
$checkouts_gauge = $collector->register_gauge(
'wp_bnb_checkouts_today',
'Number of check-outs scheduled for today',
array()
);
$checkouts_gauge->set( self::count_todays_checkouts(), array() );
// Upcoming bookings (next 7 days).
$upcoming_gauge = $collector->register_gauge(
'wp_bnb_bookings_upcoming_7days',
'Number of bookings starting in the next 7 days',
array()
);
$upcoming_gauge->set( self::count_upcoming_bookings( 7 ), array() );
// Average booking duration (nights).
$avg_duration = $collector->register_gauge(
'wp_bnb_booking_avg_duration_nights',
'Average booking duration in nights',
array()
);
$avg_duration->set( self::get_average_booking_duration(), array() );
}
/**
* Collect guest metrics.
*
* @param object $collector The wp-prometheus collector instance.
* @return void
*/
private static function collect_guest_metrics( $collector ): void {
// Total guests.
$guests_total = wp_count_posts( Guest::POST_TYPE );
$guests_gauge = $collector->register_gauge(
'wp_bnb_guests_total',
'Total number of registered guests',
array()
);
$guests_gauge->set( (int) $guests_total->publish, array() );
// Guests by status.
$guests_status_gauge = $collector->register_gauge(
'wp_bnb_guests_by_status',
'Number of guests by status',
array( 'status' )
);
$guest_statuses = array( 'active', 'blocked', 'vip' );
foreach ( $guest_statuses as $status ) {
$count = self::count_guests_by_status( $status );
$guests_status_gauge->set( $count, array( $status ) );
}
// Repeat guests (guests with more than one booking).
$repeat_gauge = $collector->register_gauge(
'wp_bnb_guests_repeat',
'Number of guests with more than one booking',
array()
);
$repeat_gauge->set( self::count_repeat_guests(), array() );
// New guests this month.
$new_guests_gauge = $collector->register_gauge(
'wp_bnb_guests_new_this_month',
'Number of new guests registered this month',
array()
);
$new_guests_gauge->set( self::count_new_guests_this_month(), array() );
}
/**
* Collect occupancy metrics.
*
* @param object $collector The wp-prometheus collector instance.
* @return void
*/
private static function collect_occupancy_metrics( $collector ): void {
// Current occupancy rate (percentage).
$occupancy_gauge = $collector->register_gauge(
'wp_bnb_occupancy_rate_current',
'Current room occupancy rate (percentage)',
array()
);
$occupancy_gauge->set( self::get_current_occupancy_rate(), array() );
// Occupancy rate this month.
$occupancy_month_gauge = $collector->register_gauge(
'wp_bnb_occupancy_rate_this_month',
'Room occupancy rate for the current month (percentage)',
array()
);
$occupancy_month_gauge->set( self::get_monthly_occupancy_rate(), array() );
// Rooms currently occupied.
$occupied_gauge = $collector->register_gauge(
'wp_bnb_rooms_currently_occupied',
'Number of rooms currently occupied',
array()
);
$occupied_gauge->set( self::count_currently_occupied_rooms(), array() );
// Total room capacity (beds).
$capacity_gauge = $collector->register_gauge(
'wp_bnb_total_capacity_beds',
'Total bed capacity across all rooms',
array()
);
$capacity_gauge->set( self::get_total_bed_capacity(), array() );
}
/**
* Collect revenue metrics.
*
* @param object $collector The wp-prometheus collector instance.
* @return void
*/
private static function collect_revenue_metrics( $collector ): void {
$currency = get_option( 'wp_bnb_currency', 'CHF' );
// Revenue this month.
$revenue_month_gauge = $collector->register_gauge(
'wp_bnb_revenue_this_month',
'Total revenue for the current month',
array( 'currency' )
);
$revenue_month_gauge->set( self::get_revenue_this_month(), array( $currency ) );
// Revenue year to date.
$revenue_ytd_gauge = $collector->register_gauge(
'wp_bnb_revenue_ytd',
'Total revenue year to date',
array( 'currency' )
);
$revenue_ytd_gauge->set( self::get_revenue_ytd(), array( $currency ) );
// Average booking value.
$avg_value_gauge = $collector->register_gauge(
'wp_bnb_booking_avg_value',
'Average booking value',
array( 'currency' )
);
$avg_value_gauge->set( self::get_average_booking_value(), array( $currency ) );
// Revenue from services this month.
$services_revenue_gauge = $collector->register_gauge(
'wp_bnb_services_revenue_this_month',
'Revenue from additional services this month',
array( 'currency' )
);
$services_revenue_gauge->set( self::get_services_revenue_this_month(), array( $currency ) );
}
/**
* Register Grafana dashboards.
*
* @param object $provider The wp-prometheus dashboard provider instance.
* @return void
*/
public static function register_dashboards( $provider ): void {
$dashboard_file = WP_BNB_PATH . 'assets/grafana/wp-bnb-dashboard.json';
if ( file_exists( $dashboard_file ) ) {
$provider->register_dashboard(
'wp-bnb',
array(
'title' => __( 'WP BnB Dashboard', 'wp-bnb' ),
'description' => __( 'Monitor occupancy, bookings, revenue, and guest statistics for your B&B.', 'wp-bnb' ),
'icon' => 'dashicons-building',
'file' => $dashboard_file,
'plugin' => 'WP BnB Manager',
)
);
}
}
// =========================================================================
// Helper Methods - Inventory
// =========================================================================
/**
* Count rooms by status.
*
* @param string $status Room status.
* @return int
*/
private static function count_rooms_by_status( string $status ): int {
global $wpdb;
return (int) $wpdb->get_var(
$wpdb->prepare(
"SELECT COUNT(DISTINCT p.ID)
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm ON p.ID = pm.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm.meta_key = '_bnb_room_status'
AND pm.meta_value = %s",
Room::POST_TYPE,
$status
)
);
}
/**
* Count services by status.
*
* @param string $status Service status.
* @return int
*/
private static function count_services_by_status( string $status ): int {
global $wpdb;
return (int) $wpdb->get_var(
$wpdb->prepare(
"SELECT COUNT(DISTINCT p.ID)
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm ON p.ID = pm.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm.meta_key = '_bnb_service_status'
AND pm.meta_value = %s",
Service::POST_TYPE,
$status
)
);
}
// =========================================================================
// Helper Methods - Bookings
// =========================================================================
/**
* Count bookings by status.
*
* @param string $status Booking status.
* @return int
*/
private static function count_bookings_by_status( string $status ): int {
global $wpdb;
return (int) $wpdb->get_var(
$wpdb->prepare(
"SELECT COUNT(DISTINCT p.ID)
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm ON p.ID = pm.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm.meta_key = '_bnb_booking_status'
AND pm.meta_value = %s",
Booking::POST_TYPE,
$status
)
);
}
/**
* Count today's check-ins.
*
* @return int
*/
private static function count_todays_checkins(): int {
global $wpdb;
$today = gmdate( 'Y-m-d' );
return (int) $wpdb->get_var(
$wpdb->prepare(
"SELECT COUNT(DISTINCT p.ID)
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm_date ON p.ID = pm_date.post_id
INNER JOIN {$wpdb->postmeta} pm_status ON p.ID = pm_status.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm_date.meta_key = '_bnb_booking_check_in'
AND pm_date.meta_value = %s
AND pm_status.meta_key = '_bnb_booking_status'
AND pm_status.meta_value IN ('confirmed', 'pending')",
Booking::POST_TYPE,
$today
)
);
}
/**
* Count today's check-outs.
*
* @return int
*/
private static function count_todays_checkouts(): int {
global $wpdb;
$today = gmdate( 'Y-m-d' );
return (int) $wpdb->get_var(
$wpdb->prepare(
"SELECT COUNT(DISTINCT p.ID)
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm_date ON p.ID = pm_date.post_id
INNER JOIN {$wpdb->postmeta} pm_status ON p.ID = pm_status.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm_date.meta_key = '_bnb_booking_check_out'
AND pm_date.meta_value = %s
AND pm_status.meta_key = '_bnb_booking_status'
AND pm_status.meta_value = 'checked_in'",
Booking::POST_TYPE,
$today
)
);
}
/**
* Count upcoming bookings within given days.
*
* @param int $days Number of days to look ahead.
* @return int
*/
private static function count_upcoming_bookings( int $days ): int {
global $wpdb;
$today = gmdate( 'Y-m-d' );
$end_date = gmdate( 'Y-m-d', strtotime( "+{$days} days" ) );
return (int) $wpdb->get_var(
$wpdb->prepare(
"SELECT COUNT(DISTINCT p.ID)
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm_date ON p.ID = pm_date.post_id
INNER JOIN {$wpdb->postmeta} pm_status ON p.ID = pm_status.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm_date.meta_key = '_bnb_booking_check_in'
AND pm_date.meta_value >= %s
AND pm_date.meta_value <= %s
AND pm_status.meta_key = '_bnb_booking_status'
AND pm_status.meta_value IN ('confirmed', 'pending')",
Booking::POST_TYPE,
$today,
$end_date
)
);
}
/**
* Get average booking duration in nights.
*
* @return float
*/
private static function get_average_booking_duration(): float {
global $wpdb;
$result = $wpdb->get_var(
$wpdb->prepare(
"SELECT AVG(DATEDIFF(pm_out.meta_value, pm_in.meta_value))
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm_in ON p.ID = pm_in.post_id
INNER JOIN {$wpdb->postmeta} pm_out ON p.ID = pm_out.post_id
INNER JOIN {$wpdb->postmeta} pm_status ON p.ID = pm_status.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm_in.meta_key = '_bnb_booking_check_in'
AND pm_out.meta_key = '_bnb_booking_check_out'
AND pm_status.meta_key = '_bnb_booking_status'
AND pm_status.meta_value NOT IN ('cancelled')",
Booking::POST_TYPE
)
);
return round( (float) $result, 1 );
}
// =========================================================================
// Helper Methods - Guests
// =========================================================================
/**
* Count guests by status.
*
* @param string $status Guest status.
* @return int
*/
private static function count_guests_by_status( string $status ): int {
global $wpdb;
return (int) $wpdb->get_var(
$wpdb->prepare(
"SELECT COUNT(DISTINCT p.ID)
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm ON p.ID = pm.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm.meta_key = '_bnb_guest_status'
AND pm.meta_value = %s",
Guest::POST_TYPE,
$status
)
);
}
/**
* Count repeat guests (more than one booking).
*
* @return int
*/
private static function count_repeat_guests(): int {
global $wpdb;
return (int) $wpdb->get_var(
$wpdb->prepare(
"SELECT COUNT(DISTINCT pm.meta_value)
FROM {$wpdb->postmeta} pm
INNER JOIN {$wpdb->posts} p ON pm.post_id = p.ID
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm.meta_key = '_bnb_booking_guest_id'
AND pm.meta_value != ''
GROUP BY pm.meta_value
HAVING COUNT(*) > 1",
Booking::POST_TYPE
)
);
}
/**
* Count new guests registered this month.
*
* @return int
*/
private static function count_new_guests_this_month(): int {
global $wpdb;
$first_of_month = gmdate( 'Y-m-01 00:00:00' );
return (int) $wpdb->get_var(
$wpdb->prepare(
"SELECT COUNT(*)
FROM {$wpdb->posts}
WHERE post_type = %s
AND post_status = 'publish'
AND post_date >= %s",
Guest::POST_TYPE,
$first_of_month
)
);
}
// =========================================================================
// Helper Methods - Occupancy
// =========================================================================
/**
* Get current occupancy rate (percentage of rooms occupied today).
*
* @return float
*/
private static function get_current_occupancy_rate(): float {
$total_rooms = self::count_available_rooms();
if ( $total_rooms <= 0 ) {
return 0.0;
}
$occupied = self::count_currently_occupied_rooms();
return round( ( $occupied / $total_rooms ) * 100, 1 );
}
/**
* Get monthly occupancy rate.
*
* @return float
*/
private static function get_monthly_occupancy_rate(): float {
global $wpdb;
$total_rooms = self::count_available_rooms();
if ( $total_rooms <= 0 ) {
return 0.0;
}
$first_of_month = gmdate( 'Y-m-01' );
$today = gmdate( 'Y-m-d' );
$days_so_far = (int) gmdate( 'd' );
$total_room_nights = $total_rooms * $days_so_far;
// Count booked nights this month (simplified: count bookings that overlap with this month).
$booked_nights = (int) $wpdb->get_var(
$wpdb->prepare(
"SELECT SUM(
DATEDIFF(
LEAST(pm_out.meta_value, %s),
GREATEST(pm_in.meta_value, %s)
)
)
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm_in ON p.ID = pm_in.post_id
INNER JOIN {$wpdb->postmeta} pm_out ON p.ID = pm_out.post_id
INNER JOIN {$wpdb->postmeta} pm_status ON p.ID = pm_status.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm_in.meta_key = '_bnb_booking_check_in'
AND pm_out.meta_key = '_bnb_booking_check_out'
AND pm_status.meta_key = '_bnb_booking_status'
AND pm_status.meta_value IN ('confirmed', 'checked_in', 'checked_out')
AND pm_in.meta_value <= %s
AND pm_out.meta_value >= %s",
$today,
$first_of_month,
Booking::POST_TYPE,
$today,
$first_of_month
)
);
if ( $total_room_nights <= 0 ) {
return 0.0;
}
return round( ( $booked_nights / $total_room_nights ) * 100, 1 );
}
/**
* Count currently occupied rooms.
*
* @return int
*/
private static function count_currently_occupied_rooms(): int {
global $wpdb;
$today = gmdate( 'Y-m-d' );
return (int) $wpdb->get_var(
$wpdb->prepare(
"SELECT COUNT(DISTINCT pm_room.meta_value)
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm_room ON p.ID = pm_room.post_id
INNER JOIN {$wpdb->postmeta} pm_in ON p.ID = pm_in.post_id
INNER JOIN {$wpdb->postmeta} pm_out ON p.ID = pm_out.post_id
INNER JOIN {$wpdb->postmeta} pm_status ON p.ID = pm_status.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm_room.meta_key = '_bnb_booking_room_id'
AND pm_in.meta_key = '_bnb_booking_check_in'
AND pm_out.meta_key = '_bnb_booking_check_out'
AND pm_status.meta_key = '_bnb_booking_status'
AND pm_status.meta_value IN ('confirmed', 'checked_in')
AND pm_in.meta_value <= %s
AND pm_out.meta_value > %s",
Booking::POST_TYPE,
$today,
$today
)
);
}
/**
* Count available rooms (not in maintenance/inactive).
*
* @return int
*/
private static function count_available_rooms(): int {
global $wpdb;
return (int) $wpdb->get_var(
$wpdb->prepare(
"SELECT COUNT(DISTINCT p.ID)
FROM {$wpdb->posts} p
LEFT JOIN {$wpdb->postmeta} pm ON p.ID = pm.post_id AND pm.meta_key = '_bnb_room_status'
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND (pm.meta_value IS NULL OR pm.meta_value IN ('available', 'occupied'))",
Room::POST_TYPE
)
);
}
/**
* Get total bed capacity.
*
* @return int
*/
private static function get_total_bed_capacity(): int {
global $wpdb;
$result = $wpdb->get_var(
$wpdb->prepare(
"SELECT SUM(CAST(pm.meta_value AS UNSIGNED))
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm ON p.ID = pm.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm.meta_key = '_bnb_room_beds'",
Room::POST_TYPE
)
);
return (int) $result;
}
// =========================================================================
// Helper Methods - Revenue
// =========================================================================
/**
* Get revenue for the current month.
*
* @return float
*/
private static function get_revenue_this_month(): float {
global $wpdb;
$first_of_month = gmdate( 'Y-m-01' );
$result = $wpdb->get_var(
$wpdb->prepare(
"SELECT SUM(CAST(pm_price.meta_value AS DECIMAL(10,2)))
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm_price ON p.ID = pm_price.post_id
INNER JOIN {$wpdb->postmeta} pm_in ON p.ID = pm_in.post_id
INNER JOIN {$wpdb->postmeta} pm_status ON p.ID = pm_status.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm_price.meta_key = '_bnb_booking_total_price'
AND pm_in.meta_key = '_bnb_booking_check_in'
AND pm_in.meta_value >= %s
AND pm_status.meta_key = '_bnb_booking_status'
AND pm_status.meta_value IN ('confirmed', 'checked_in', 'checked_out')",
Booking::POST_TYPE,
$first_of_month
)
);
return round( (float) $result, 2 );
}
/**
* Get revenue year to date.
*
* @return float
*/
private static function get_revenue_ytd(): float {
global $wpdb;
$first_of_year = gmdate( 'Y-01-01' );
$result = $wpdb->get_var(
$wpdb->prepare(
"SELECT SUM(CAST(pm_price.meta_value AS DECIMAL(10,2)))
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm_price ON p.ID = pm_price.post_id
INNER JOIN {$wpdb->postmeta} pm_in ON p.ID = pm_in.post_id
INNER JOIN {$wpdb->postmeta} pm_status ON p.ID = pm_status.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm_price.meta_key = '_bnb_booking_total_price'
AND pm_in.meta_key = '_bnb_booking_check_in'
AND pm_in.meta_value >= %s
AND pm_status.meta_key = '_bnb_booking_status'
AND pm_status.meta_value IN ('confirmed', 'checked_in', 'checked_out')",
Booking::POST_TYPE,
$first_of_year
)
);
return round( (float) $result, 2 );
}
/**
* Get average booking value.
*
* @return float
*/
private static function get_average_booking_value(): float {
global $wpdb;
$result = $wpdb->get_var(
$wpdb->prepare(
"SELECT AVG(CAST(pm_price.meta_value AS DECIMAL(10,2)))
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm_price ON p.ID = pm_price.post_id
INNER JOIN {$wpdb->postmeta} pm_status ON p.ID = pm_status.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm_price.meta_key = '_bnb_booking_total_price'
AND pm_status.meta_key = '_bnb_booking_status'
AND pm_status.meta_value IN ('confirmed', 'checked_in', 'checked_out')",
Booking::POST_TYPE
)
);
return round( (float) $result, 2 );
}
/**
* Get revenue from services this month.
*
* @return float
*/
private static function get_services_revenue_this_month(): float {
global $wpdb;
$first_of_month = gmdate( 'Y-m-01' );
$result = $wpdb->get_var(
$wpdb->prepare(
"SELECT SUM(CAST(pm_services.meta_value AS DECIMAL(10,2)))
FROM {$wpdb->posts} p
INNER JOIN {$wpdb->postmeta} pm_services ON p.ID = pm_services.post_id
INNER JOIN {$wpdb->postmeta} pm_in ON p.ID = pm_in.post_id
INNER JOIN {$wpdb->postmeta} pm_status ON p.ID = pm_status.post_id
WHERE p.post_type = %s
AND p.post_status = 'publish'
AND pm_services.meta_key = '_bnb_booking_services_total'
AND pm_in.meta_key = '_bnb_booking_check_in'
AND pm_in.meta_value >= %s
AND pm_status.meta_key = '_bnb_booking_status'
AND pm_status.meta_value IN ('confirmed', 'checked_in', 'checked_out')",
Booking::POST_TYPE,
$first_of_month
)
);
return round( (float) $result, 2 );
}
}

View File

@@ -10,12 +10,16 @@ declare( strict_types=1 );
namespace Magdev\WpBnb; namespace Magdev\WpBnb;
use Magdev\WpBnb\Admin\Calendar as CalendarAdmin; use Magdev\WpBnb\Admin\Calendar as CalendarAdmin;
use Magdev\WpBnb\Admin\Dashboard as DashboardAdmin;
use Magdev\WpBnb\Admin\Reports as ReportsAdmin;
use Magdev\WpBnb\Admin\Seasons as SeasonsAdmin; use Magdev\WpBnb\Admin\Seasons as SeasonsAdmin;
use Magdev\WpBnb\Blocks\BlockRegistrar; use Magdev\WpBnb\Blocks\BlockRegistrar;
use Magdev\WpBnb\Booking\Availability; use Magdev\WpBnb\Booking\Availability;
use Magdev\WpBnb\Booking\EmailNotifier; use Magdev\WpBnb\Booking\EmailNotifier;
use Magdev\WpBnb\Frontend\Search; use Magdev\WpBnb\Frontend\Search;
use Magdev\WpBnb\Frontend\Shortcodes; use Magdev\WpBnb\Frontend\Shortcodes;
use Magdev\WpBnb\Integration\CF7;
use Magdev\WpBnb\Integration\Prometheus;
use Magdev\WpBnb\Frontend\Widgets\AvailabilityCalendar; use Magdev\WpBnb\Frontend\Widgets\AvailabilityCalendar;
use Magdev\WpBnb\Frontend\Widgets\BuildingRooms; use Magdev\WpBnb\Frontend\Widgets\BuildingRooms;
use Magdev\WpBnb\Frontend\Widgets\SimilarRooms; use Magdev\WpBnb\Frontend\Widgets\SimilarRooms;
@@ -133,6 +137,15 @@ final class Plugin {
// Initialize auto-updater (requires license configuration). // Initialize auto-updater (requires license configuration).
$this->init_updater(); $this->init_updater();
// Initialize Contact Form 7 integration if CF7 is active.
// This runs in both admin (for tag generators) and frontend (for form rendering).
if ( class_exists( 'WPCF7' ) ) {
CF7::init();
}
// Initialize Prometheus metrics integration.
Prometheus::init();
// Initialize admin components. // Initialize admin components.
if ( is_admin() ) { if ( is_admin() ) {
$this->init_admin(); $this->init_admin();
@@ -241,6 +254,7 @@ final class Plugin {
$is_plugin_page = strpos( $hook_suffix, 'wp-bnb' ) !== false; $is_plugin_page = strpos( $hook_suffix, 'wp-bnb' ) !== false;
$is_our_post_type = in_array( $post_type, array( Building::POST_TYPE, Room::POST_TYPE, Booking::POST_TYPE, Guest::POST_TYPE, Service::POST_TYPE ), true ); $is_our_post_type = in_array( $post_type, array( Building::POST_TYPE, Room::POST_TYPE, Booking::POST_TYPE, Guest::POST_TYPE, Service::POST_TYPE ), true );
$is_edit_screen = in_array( $hook_suffix, array( 'post.php', 'post-new.php' ), true ); $is_edit_screen = in_array( $hook_suffix, array( 'post.php', 'post-new.php' ), true );
$is_dashboard = 'toplevel_page_wp-bnb' === $hook_suffix;
if ( ! $is_plugin_page && ! ( $is_our_post_type && $is_edit_screen ) ) { if ( ! $is_plugin_page && ! ( $is_our_post_type && $is_edit_screen ) ) {
return; return;
@@ -261,6 +275,18 @@ final class Plugin {
$script_deps[] = 'jquery-ui-sortable'; $script_deps[] = 'jquery-ui-sortable';
} }
// Add Chart.js for dashboard.
if ( $is_dashboard ) {
wp_enqueue_script(
'chartjs',
'https://cdn.jsdelivr.net/npm/chart.js@4.4.1/dist/chart.umd.min.js',
array(),
'4.4.1',
true
);
$script_deps[] = 'chartjs';
}
wp_enqueue_script( wp_enqueue_script(
'wp-bnb-admin', 'wp-bnb-admin',
WP_BNB_URL . 'assets/js/admin.js', WP_BNB_URL . 'assets/js/admin.js',
@@ -269,43 +295,53 @@ final class Plugin {
true true
); );
wp_localize_script( // Build localize data.
'wp-bnb-admin', $localize_data = array(
'wpBnbAdmin', 'ajaxUrl' => admin_url( 'admin-ajax.php' ),
array( 'nonce' => wp_create_nonce( 'wp_bnb_admin_nonce' ),
'ajaxUrl' => admin_url( 'admin-ajax.php' ), 'postType' => $post_type,
'nonce' => wp_create_nonce( 'wp_bnb_admin_nonce' ), 'isDashboard' => $is_dashboard,
'postType' => $post_type, 'i18n' => array(
'i18n' => array( 'validating' => __( 'Validating...', 'wp-bnb' ),
'validating' => __( 'Validating...', 'wp-bnb' ), 'activating' => __( 'Activating...', 'wp-bnb' ),
'activating' => __( 'Activating...', 'wp-bnb' ), 'error' => __( 'An error occurred. Please try again.', 'wp-bnb' ),
'error' => __( 'An error occurred. Please try again.', 'wp-bnb' ), 'selectImages' => __( 'Select Images', 'wp-bnb' ),
'selectImages' => __( 'Select Images', 'wp-bnb' ), 'addToGallery' => __( 'Add to Gallery', 'wp-bnb' ),
'addToGallery' => __( 'Add to Gallery', 'wp-bnb' ), 'confirmRemove' => __( 'Are you sure you want to remove this image?', 'wp-bnb' ),
'confirmRemove' => __( 'Are you sure you want to remove this image?', 'wp-bnb' ), 'increase' => __( 'increase', 'wp-bnb' ),
'increase' => __( 'increase', 'wp-bnb' ), 'discount' => __( 'discount', 'wp-bnb' ),
'discount' => __( 'discount', 'wp-bnb' ), 'normalPrice' => __( 'Normal price', 'wp-bnb' ),
'normalPrice' => __( 'Normal price', 'wp-bnb' ), 'checking' => __( 'Checking availability...', 'wp-bnb' ),
'checking' => __( 'Checking availability...', 'wp-bnb' ), 'available' => __( 'Available', 'wp-bnb' ),
'available' => __( 'Available', 'wp-bnb' ), 'notAvailable' => __( 'Not available - conflicts with existing booking', 'wp-bnb' ),
'notAvailable' => __( 'Not available - conflicts with existing booking', 'wp-bnb' ), 'selectRoomAndDates' => __( 'Select room and dates to check availability', 'wp-bnb' ),
'selectRoomAndDates' => __( 'Select room and dates to check availability', 'wp-bnb' ), 'nights' => __( 'nights', 'wp-bnb' ),
'nights' => __( 'nights', 'wp-bnb' ), 'night' => __( 'night', 'wp-bnb' ),
'night' => __( 'night', 'wp-bnb' ), 'calculating' => __( 'Calculating price...', 'wp-bnb' ),
'calculating' => __( 'Calculating price...', 'wp-bnb' ), 'searchingGuests' => __( 'Searching...', 'wp-bnb' ),
'searchingGuests' => __( 'Searching...', 'wp-bnb' ), 'noGuestsFound' => __( 'No guests found', 'wp-bnb' ),
'noGuestsFound' => __( 'No guests found', 'wp-bnb' ), 'selectGuest' => __( 'Select', 'wp-bnb' ),
'selectGuest' => __( 'Select', 'wp-bnb' ), 'guestBlocked' => __( 'Blocked', 'wp-bnb' ),
'guestBlocked' => __( 'Blocked', 'wp-bnb' ), 'perNightDescription' => __( 'This price will be charged per night of the stay.', 'wp-bnb' ),
'perNightDescription' => __( 'This price will be charged per night of the stay.', 'wp-bnb' ), 'perBookingDescription' => __( 'This price will be charged once for the booking.', 'wp-bnb' ),
'perBookingDescription' => __( 'This price will be charged once for the booking.', 'wp-bnb' ), 'justNow' => __( 'Just now', 'wp-bnb' ),
'justNow' => __( 'Just now', 'wp-bnb' ), 'updateAvailable' => __( 'Update available!', 'wp-bnb' ),
'updateAvailable' => __( 'Update available!', 'wp-bnb' ), 'upToDate' => __( '(You are up to date)', 'wp-bnb' ),
'upToDate' => __( '(You are up to date)', 'wp-bnb' ), 'checkingUpdates' => __( 'Checking for updates...', 'wp-bnb' ),
'checkingUpdates' => __( 'Checking for updates...', 'wp-bnb' ), 'occupancy' => __( 'Occupancy %', 'wp-bnb' ),
), 'revenue' => __( 'Revenue', 'wp-bnb' ),
) ),
); );
// Add chart data for dashboard.
if ( $is_dashboard ) {
$localize_data['chartData'] = array(
'occupancy' => DashboardAdmin::get_occupancy_trend_data( 30 ),
'revenue' => DashboardAdmin::get_revenue_trend_data( 6 ),
);
}
wp_localize_script( 'wp-bnb-admin', 'wpBnbAdmin', $localize_data );
} }
/** /**
@@ -362,6 +398,43 @@ final class Plugin {
), ),
) )
); );
// Load CF7 integration assets if CF7 is active.
if ( class_exists( 'WPCF7' ) ) {
wp_enqueue_style(
'wp-bnb-cf7',
WP_BNB_URL . 'assets/css/cf7-integration.css',
array( 'contact-form-7' ),
WP_BNB_VERSION
);
wp_enqueue_script(
'wp-bnb-cf7',
WP_BNB_URL . 'assets/js/cf7-integration.js',
array( 'contact-form-7' ),
WP_BNB_VERSION,
true
);
wp_localize_script(
'wp-bnb-cf7',
'wpBnbCF7',
array(
'ajaxUrl' => admin_url( 'admin-ajax.php' ),
'nonce' => wp_create_nonce( 'wp_bnb_frontend_nonce' ),
'i18n' => array(
'selectRoom' => __( '-- Select Room --', 'wp-bnb' ),
'checking' => __( 'Checking availability...', 'wp-bnb' ),
'available' => __( 'Room is available!', 'wp-bnb' ),
'unavailable' => __( 'Room is not available for these dates', 'wp-bnb' ),
'invalidDateRange' => __( 'Check-out must be after check-in', 'wp-bnb' ),
'capacityExceeded' => __( 'Maximum %d guests for this room', 'wp-bnb' ),
'estimatedTotal' => __( 'Estimated Total', 'wp-bnb' ),
'nights' => __( 'nights', 'wp-bnb' ),
),
)
);
}
} }
/** /**
@@ -404,6 +477,16 @@ final class Plugin {
array( $this, 'render_dashboard_page' ) array( $this, 'render_dashboard_page' )
); );
// Reports submenu.
add_submenu_page(
'wp-bnb',
__( 'Reports', 'wp-bnb' ),
__( 'Reports', 'wp-bnb' ),
'manage_options',
'wp-bnb-reports',
array( $this, 'render_reports_page' )
);
// Settings submenu. // Settings submenu.
add_submenu_page( add_submenu_page(
'wp-bnb', 'wp-bnb',
@@ -432,15 +515,16 @@ final class Plugin {
// Define the desired order of menu slugs. // Define the desired order of menu slugs.
$desired_order = array( $desired_order = array(
'wp-bnb', // Dashboard. 'wp-bnb', // Dashboard.
'edit.php?post_type=bnb_building', // Buildings. 'edit.php?post_type=bnb_building', // Buildings.
'edit.php?post_type=bnb_room', // Rooms. 'edit.php?post_type=bnb_room', // Rooms.
'edit.php?post_type=bnb_booking', // Bookings. 'edit.php?post_type=bnb_booking', // Bookings.
'edit.php?post_type=bnb_guest', // Guests. 'edit.php?post_type=bnb_guest', // Guests.
'edit.php?post_type=bnb_service', // Services. 'edit.php?post_type=bnb_service', // Services.
'wp-bnb-calendar', // Calendar. 'wp-bnb-calendar', // Calendar.
'wp-bnb-seasons', // Seasons. 'wp-bnb-reports', // Reports.
'wp-bnb-settings', // Settings (always last). 'wp-bnb-seasons', // Seasons.
'wp-bnb-settings', // Settings (always last).
); );
$current_menu = $submenu['wp-bnb']; $current_menu = $submenu['wp-bnb'];
@@ -484,39 +568,16 @@ final class Plugin {
* @return void * @return void
*/ */
public function render_dashboard_page(): void { public function render_dashboard_page(): void {
$license_valid = LicenseManager::is_license_valid(); DashboardAdmin::render();
$is_localhost = LicenseManager::is_localhost(); }
?>
<div class="wrap">
<h1><?php esc_html_e( 'WP BnB Dashboard', 'wp-bnb' ); ?></h1>
<?php if ( $is_localhost ) : ?> /**
<div class="notice notice-info"> * Render reports page.
<p> *
<span class="dashicons dashicons-info" style="color: #72aee6;"></span> * @return void
<strong><?php esc_html_e( 'Development Mode', 'wp-bnb' ); ?></strong> */
<?php esc_html_e( 'You are running on a local development environment. All features are enabled.', 'wp-bnb' ); ?> public function render_reports_page(): void {
</p> ReportsAdmin::render();
</div>
<?php elseif ( ! $license_valid ) : ?>
<div class="notice notice-warning">
<p>
<?php
printf(
/* translators: %s: Link to settings page */
esc_html__( 'Your license is not active. Please %s to unlock all features.', 'wp-bnb' ),
'<a href="' . esc_url( admin_url( 'admin.php?page=wp-bnb-settings&tab=license' ) ) . '">' . esc_html__( 'activate your license', 'wp-bnb' ) . '</a>'
);
?>
</p>
</div>
<?php endif; ?>
<div class="wp-bnb-dashboard">
<p><?php esc_html_e( 'Welcome to WP BnB Management. Use the menu on the left to manage your buildings, rooms, bookings, and guests.', 'wp-bnb' ); ?></p>
</div>
</div>
<?php
} }
/** /**
@@ -553,6 +614,10 @@ final class Plugin {
class="nav-tab <?php echo 'updates' === $active_tab ? 'nav-tab-active' : ''; ?>"> class="nav-tab <?php echo 'updates' === $active_tab ? 'nav-tab-active' : ''; ?>">
<?php esc_html_e( 'Updates', 'wp-bnb' ); ?> <?php esc_html_e( 'Updates', 'wp-bnb' ); ?>
</a> </a>
<a href="<?php echo esc_url( admin_url( 'admin.php?page=wp-bnb-settings&tab=metrics' ) ); ?>"
class="nav-tab <?php echo 'metrics' === $active_tab ? 'nav-tab-active' : ''; ?>">
<?php esc_html_e( 'Metrics', 'wp-bnb' ); ?>
</a>
</nav> </nav>
<div class="tab-content"> <div class="tab-content">
@@ -567,6 +632,9 @@ final class Plugin {
case 'updates': case 'updates':
$this->render_updates_settings(); $this->render_updates_settings();
break; break;
case 'metrics':
$this->render_metrics_settings();
break;
default: default:
$this->render_general_settings(); $this->render_general_settings();
break; break;
@@ -1208,6 +1276,163 @@ final class Plugin {
<?php <?php
} }
/**
* Render metrics settings tab.
*
* @return void
*/
private function render_metrics_settings(): void {
$metrics_enabled = Prometheus::is_enabled();
$prometheus_active = class_exists( '\Magdev\WpPrometheus\Plugin' ) || defined( 'WP_PROMETHEUS_VERSION' );
$dashboard_file = WP_BNB_PATH . 'assets/grafana/wp-bnb-dashboard.json';
$dashboard_available = file_exists( $dashboard_file );
?>
<form method="post" action="">
<?php wp_nonce_field( 'wp_bnb_save_settings', 'wp_bnb_settings_nonce' ); ?>
<h2><?php esc_html_e( 'Prometheus Metrics', 'wp-bnb' ); ?></h2>
<?php if ( ! $prometheus_active ) : ?>
<div class="notice notice-warning inline" style="margin: 0 0 20px 0;">
<p>
<span class="dashicons dashicons-warning" style="color: #dba617;"></span>
<strong><?php esc_html_e( 'WP Prometheus not detected', 'wp-bnb' ); ?></strong><br>
<?php
printf(
/* translators: %s: Plugin URL */
esc_html__( 'The WP Prometheus plugin is required to expose metrics. Please install and activate it from %s.', 'wp-bnb' ),
'<a href="https://src.bundespruefstelle.ch/magdev/wp-prometheus" target="_blank">wp-prometheus</a>'
);
?>
</p>
</div>
<?php else : ?>
<div class="notice notice-success inline" style="margin: 0 0 20px 0;">
<p>
<span class="dashicons dashicons-yes-alt" style="color: #00a32a;"></span>
<strong><?php esc_html_e( 'WP Prometheus is active', 'wp-bnb' ); ?></strong>
<?php esc_html_e( 'Metrics will be exposed via the /metrics/ endpoint.', 'wp-bnb' ); ?>
</p>
</div>
<?php endif; ?>
<table class="form-table" role="presentation">
<tr>
<th scope="row"><?php esc_html_e( 'Enable Metrics', 'wp-bnb' ); ?></th>
<td>
<label>
<input type="checkbox" name="wp_bnb_metrics_enabled"
value="yes" <?php checked( $metrics_enabled ); ?>>
<?php esc_html_e( 'Expose BnB metrics via Prometheus', 'wp-bnb' ); ?>
</label>
<p class="description">
<?php esc_html_e( 'When enabled, occupancy, booking, revenue, and guest metrics will be available for Prometheus scraping.', 'wp-bnb' ); ?>
</p>
</td>
</tr>
</table>
<h2><?php esc_html_e( 'Available Metrics', 'wp-bnb' ); ?></h2>
<p class="description"><?php esc_html_e( 'The following metrics are exposed when enabled:', 'wp-bnb' ); ?></p>
<table class="widefat striped" style="max-width: 800px; margin-top: 10px;">
<thead>
<tr>
<th><?php esc_html_e( 'Metric', 'wp-bnb' ); ?></th>
<th><?php esc_html_e( 'Type', 'wp-bnb' ); ?></th>
<th><?php esc_html_e( 'Description', 'wp-bnb' ); ?></th>
</tr>
</thead>
<tbody>
<tr>
<td><code>wp_bnb_buildings_total</code></td>
<td><?php esc_html_e( 'Gauge', 'wp-bnb' ); ?></td>
<td><?php esc_html_e( 'Total number of buildings', 'wp-bnb' ); ?></td>
</tr>
<tr>
<td><code>wp_bnb_rooms_total</code></td>
<td><?php esc_html_e( 'Gauge', 'wp-bnb' ); ?></td>
<td><?php esc_html_e( 'Total rooms by status (available, occupied, maintenance, inactive)', 'wp-bnb' ); ?></td>
</tr>
<tr>
<td><code>wp_bnb_bookings_total</code></td>
<td><?php esc_html_e( 'Gauge', 'wp-bnb' ); ?></td>
<td><?php esc_html_e( 'Total bookings by status (pending, confirmed, checked_in, checked_out, cancelled)', 'wp-bnb' ); ?></td>
</tr>
<tr>
<td><code>wp_bnb_occupancy_rate_current</code></td>
<td><?php esc_html_e( 'Gauge', 'wp-bnb' ); ?></td>
<td><?php esc_html_e( 'Current room occupancy rate (percentage)', 'wp-bnb' ); ?></td>
</tr>
<tr>
<td><code>wp_bnb_occupancy_rate_this_month</code></td>
<td><?php esc_html_e( 'Gauge', 'wp-bnb' ); ?></td>
<td><?php esc_html_e( 'Room occupancy rate for current month (percentage)', 'wp-bnb' ); ?></td>
</tr>
<tr>
<td><code>wp_bnb_checkins_today</code></td>
<td><?php esc_html_e( 'Gauge', 'wp-bnb' ); ?></td>
<td><?php esc_html_e( 'Number of check-ins scheduled for today', 'wp-bnb' ); ?></td>
</tr>
<tr>
<td><code>wp_bnb_checkouts_today</code></td>
<td><?php esc_html_e( 'Gauge', 'wp-bnb' ); ?></td>
<td><?php esc_html_e( 'Number of check-outs scheduled for today', 'wp-bnb' ); ?></td>
</tr>
<tr>
<td><code>wp_bnb_revenue_this_month</code></td>
<td><?php esc_html_e( 'Gauge', 'wp-bnb' ); ?></td>
<td><?php esc_html_e( 'Total revenue for current month', 'wp-bnb' ); ?></td>
</tr>
<tr>
<td><code>wp_bnb_revenue_ytd</code></td>
<td><?php esc_html_e( 'Gauge', 'wp-bnb' ); ?></td>
<td><?php esc_html_e( 'Total revenue year to date', 'wp-bnb' ); ?></td>
</tr>
<tr>
<td><code>wp_bnb_booking_avg_value</code></td>
<td><?php esc_html_e( 'Gauge', 'wp-bnb' ); ?></td>
<td><?php esc_html_e( 'Average booking value', 'wp-bnb' ); ?></td>
</tr>
<tr>
<td><code>wp_bnb_guests_total</code></td>
<td><?php esc_html_e( 'Gauge', 'wp-bnb' ); ?></td>
<td><?php esc_html_e( 'Total number of registered guests', 'wp-bnb' ); ?></td>
</tr>
<tr>
<td><code>wp_bnb_guests_repeat</code></td>
<td><?php esc_html_e( 'Gauge', 'wp-bnb' ); ?></td>
<td><?php esc_html_e( 'Number of repeat guests (more than one booking)', 'wp-bnb' ); ?></td>
</tr>
</tbody>
</table>
<h2 style="margin-top: 30px;"><?php esc_html_e( 'Grafana Dashboard', 'wp-bnb' ); ?></h2>
<?php if ( $dashboard_available ) : ?>
<p>
<?php esc_html_e( 'A pre-configured Grafana dashboard is available for visualizing WP BnB metrics.', 'wp-bnb' ); ?>
</p>
<p>
<strong><?php esc_html_e( 'Dashboard file:', 'wp-bnb' ); ?></strong>
<code>assets/grafana/wp-bnb-dashboard.json</code>
</p>
<p class="description">
<?php esc_html_e( 'If WP Prometheus is installed, this dashboard will be automatically registered and available for export in the Prometheus settings.', 'wp-bnb' ); ?>
</p>
<?php else : ?>
<div class="notice notice-warning inline">
<p><?php esc_html_e( 'Grafana dashboard file not found.', 'wp-bnb' ); ?></p>
</div>
<?php endif; ?>
<p class="submit">
<?php submit_button( __( 'Save Metrics Settings', 'wp-bnb' ), 'primary', 'submit', false ); ?>
</p>
</form>
<?php
}
/** /**
* Render license status badge. * Render license status badge.
* *
@@ -1279,6 +1504,9 @@ final class Plugin {
case 'updates': case 'updates':
$this->save_updates_settings(); $this->save_updates_settings();
break; break;
case 'metrics':
$this->save_metrics_settings();
break;
default: default:
$this->save_general_settings(); $this->save_general_settings();
break; break;
@@ -1408,6 +1636,19 @@ final class Plugin {
settings_errors( 'wp_bnb_settings' ); settings_errors( 'wp_bnb_settings' );
} }
/**
* Save metrics settings.
*
* @return void
*/
private function save_metrics_settings(): void {
$metrics_enabled = isset( $_POST['wp_bnb_metrics_enabled'] ) ? 'yes' : 'no';
update_option( Prometheus::OPTION_ENABLED, $metrics_enabled );
add_settings_error( 'wp_bnb_settings', 'settings_saved', __( 'Metrics settings saved.', 'wp-bnb' ), 'success' );
settings_errors( 'wp_bnb_settings' );
}
/** /**
* AJAX handler for checking room availability. * AJAX handler for checking room availability.
* *

View File

@@ -3,7 +3,7 @@
* Plugin Name: WP BnB Management * Plugin Name: WP BnB Management
* Plugin URI: https://src.bundespruefstelle.ch/magdev/wp-bnb * Plugin URI: https://src.bundespruefstelle.ch/magdev/wp-bnb
* Description: A comprehensive Bed & Breakfast management system for WordPress. Manage buildings, rooms, bookings, and guests. * Description: A comprehensive Bed & Breakfast management system for WordPress. Manage buildings, rooms, bookings, and guests.
* Version: 0.6.1 * Version: 0.9.0
* Requires at least: 6.0 * Requires at least: 6.0
* Requires PHP: 8.3 * Requires PHP: 8.3
* Author: Marco Graetsch * Author: Marco Graetsch
@@ -24,7 +24,7 @@ if ( ! defined( 'ABSPATH' ) ) {
} }
// Plugin version constant - MUST match Version in header above. // Plugin version constant - MUST match Version in header above.
define( 'WP_BNB_VERSION', '0.6.1' ); define( 'WP_BNB_VERSION', '0.9.0' );
// Plugin path constants. // Plugin path constants.
define( 'WP_BNB_PATH', plugin_dir_path( __FILE__ ) ); define( 'WP_BNB_PATH', plugin_dir_path( __FILE__ ) );