DOCUMENTATION

Documentation
Browse Docs

Dashboard

Dashboard

The Dashboard is the main hub for the plugin. It does not show raw analytics charts by itself — instead, it provides a clean, card-based navigation to all major sections: Statistics, Heatmap Page List, BH Heatmap (visual overlay), Settings, and maintenance tools like Data Cleaning.

Menu location: WP Admin → WPMC Behavior & Heatmap → Dashboard
Capability required: manage_options (typically Administrators).

What the Dashboard is (and isn’t)

It is

  • A hub that links to all plugin tools.
  • A fast way to start: “What should I open right now?”
  • A consistent visual entry point with the same UI theme as other WPMC pages.

It is not

  • Not a full report page with charts and filters (use Statistics for that).
  • Not the visual heatmap viewer itself (use BH Heatmap).

How it is built (from the plugin code)

The Dashboard is rendered by the function wpmc_dashboard_page() in: includes/dashboard.php. It prints a responsive grid of cards and generates links like: admin.php?page=<slug>.

The top-level menu item is registered in: includes/admin-menu.php using: add_menu_page(..., 'wpmc-dashboard', 'wpmc_dashboard_page', ...).

Dashboard cards

Each card is defined in a PHP array inside wpmc_dashboard_page(). Clicking a card simply opens the corresponding admin page.

Card Admin slug What you use it for
Statistics wpmc-statistics Time-range analytics: views, sessions, unique users, engagement, charts, and breakdowns.
Heatmap Page List wpmc-clicks-map Browse tracked pages and open page-level details.
Referrals wpmc-referrals Referral sources page (currently a UI scaffold with date filters while the feature is being expanded). Defined in includes/referrals.php.
Settings wpmc-clicks-settings Tracking scope (post types), BH tracker settings, and other configuration options.
Cleaning wpmc-data-cleaning Database maintenance tools: shows table sizes and allows purging older records (BH clicks, views, sessions). Defined in includes/data-cleaning.php.
Documentation wpmc-about Plugin info and docs entry page.
About Creators wpmc-about-creators A dedicated page about the creators/team. Uses a special wide (200×100) icon variant. Registered in includes/about-creator.php.

UI & layout details

Responsive grid

The Dashboard uses a CSS grid that adapts to screen width:

  • 4 columns on large screens
  • 3 columns below ~1200px
  • 2 columns below ~960px
  • 1 column on small screens

Card styling

  • Soft gradient background + hover lift
  • Inline SVG icons via wpmc_hub_svg()
  • “Open →” CTA button on each card

Menu icon: The admin menu uses a custom icon image assets/img/wpmc-sign_icon.webp and falls back to a WordPress dashicon if the file is missing.

Common questions

Why do I see “Referrals” and “Cleaning” here?

The Dashboard is meant to be a single place to access all tools. Some sections are also registered as submenu pages (so they appear in the left WP menu), but the Dashboard keeps them discoverable in one consistent layout.

Do I need the Dashboard to use the plugin?

Not required — you can open pages directly from the submenu. The Dashboard is simply faster and more user-friendly.

Login / Register

Plugin Features

Reviews ·•• Real cases

Suggestions ·UpNext 

Q&A ·•• Real Talk

WP Help Desk

Documentation

WPMC ACCOUNT