Skip to main content

Dashboard

Version Docs Updated

React SPA (since v4.36.0)

The Dashboard was fully migrated to a React SPA backed by a dedicated REST API in v4.36.0. The page loads without a PHP full-page render — all data is fetched asynchronously via /wp-json/mhm-rentiva/v1/dashboard/* endpoints. No jQuery dependency. Legacy PHP widgets were removed.

The Dashboard is the heart of MHM Rentiva. It lets you see your business's real-time status, financial performance, and pending operational tasks on a single screen. Access it via MHM Rentiva > Dashboard.

This is the first screen you see after installing the plugin, and it presents the critical metrics you need to make data-driven decisions.

🖼️ IMAGE: DASHBOARD AND BOOKING CALENDAR

mhm-rentiva-dashboard-calendar-view

📊 Summary Statistics Cards (Real-time Metrics)​

At the top of the panel, performance data for the current month (or selected period) is displayed as icon cards:

  • Monthly Booked Vehicles: The number of vehicles that received bookings and their total booking count.
  • Inactive Vehicles: The number of vehicles currently closed to rental or in a passive state.
  • Vehicles Under Maintenance: The number of vehicles marked as in technical service or maintenance mode.
  • Avg. Monthly Revenue: Total turnover for the selected month and the growth/decline rate (%) compared to the previous month.

📅 Monthly Booking Calendar​

The interactive calendar at the center of the Dashboard visualizes the occupancy rate of your entire fleet.

  • Vehicle Rows: The left column lists vehicles (Model and Plate).
  • Status Colors (Legend):
    • ● Pending: Bookings not yet confirmed.
    • ● Confirmed: Transactions approved by payment or by an admin.
    • ● In Progress: Transactions where the vehicle is currently with the customer.
    • ● Completed: Bookings where the rental process has successfully concluded.
    • ● Cancelled: Cancelled records.
  • Interactive Navigation: Use the month buttons to quickly jump to past and future periods.

🔍 Booking Details Panel​

Clicking (or hovering over) any booking cell on the calendar opens a detailed pop-up:

  • Customer Information: Name, Email, and Phone.
  • Date and Time: Pickup and return times.
  • Financial Summary: Total booking amount.
  • Quick Access: The "Edit Booking" button takes you directly to the transaction page.

🛠️ Interactive Features​

The Dashboard offers these quick tools for a better user experience:

  • Export: Download statistics or lists in report format.
  • Widget Editing: Use Screen Options to choose which cards are visible.
  • Cache Management: Use "Clear Cache" to get an instant database snapshot.

v4.23.0 Widget Audit and Improvements​

In v4.23.0, a comprehensive audit and improvement of Dashboard widgets was carried out:

Bug Fixes​

  • Timezone consistency: current_time('timestamp') is now used instead of time() in countdown and upcoming operations widgets to align with WordPress timezone settings.
  • Cache invalidation: A cache key prefix mismatch in the statistics widget was fixed (mhm_dashboard_stats → mhm_rentiva_dashboard_stats).
  • Status synchronization: updated_post_meta + added_post_meta hooks were added to ensure status consistency on meta updates.
  • WooCommerce email images: Vehicle images now display correctly in booking confirmation emails.
  • Calendar popup time info: Pickup and return times were added to the booking detail popup.
  • ID mismatch: WooCommerce order ID and booking ID mapping was corrected.

Design Improvements​

  • Statistics cards: Redesigned with a 2×2 grid, icons, and color coding.
  • Revenue chart: Date format localized, cancelled bookings added as a red dashed dataset.
  • Messages widget: Self-contained inline CSS, badge, avatar initials, and "time ago" display.
  • Upcoming operations: Time info, display ID, and clickable link support added.

Lite Restrictions​

  • The Revenue Chart and Upcoming Operations widgets are now Pro-only (Mode::canUseAdvancedReports()).

Section Summary​

  • Monitor your fleet's 30-day projection with the Dashboard.
  • Use Color Codes to instantly see which vehicle is available on which date.
  • Reach booking details in seconds with Customer Cards.

React Components (v4.36.0+)​

ComponentPurpose
DashboardPageRoot layout — fetches all data, manages loading state
StatsCardsFour KPI gradient cards (total bookings, revenue, active vehicles, customers)
RecentBookingsPaginated recent-bookings widget with REST fetch
TransferWidgetUpcoming transfers overview
QuickActionsQuick-link grid to common admin tasks

REST Namespace: GET /wp-json/mhm-rentiva/v1/dashboard/stats, /dashboard/recent-bookings, /dashboard/recent-transfers

Mobile responsive: Dashboard widget rows collapse to a single column at ≤782px (WP admin breakpoint). Quick actions grid reduces to 3 columns.

Changelog​

DateVersionNote
12.05.20264.49.0Dashboard widget rows mobile responsive fix (782px breakpoint).
10.05.20264.36.0Full React SPA migration. Legacy PHP widgets removed. REST API endpoints added.
23.04.20264.27.2Documentation synchronized with the current plugin release.
26.03.20264.23.011 widget bug fixes, timezone consistency, cache fix, design improvements, and Lite gating added.
19.03.20264.6.3Dashboard guide updated with real interface metrics and calendar details.