DOCUMENTATION

Documentation
Browse Docs

Installation

Installation

This guide shows how to install and activate WPMC Behavior & Heatmap, and what database tables are created automatically. You’ll be up and tracking in a few minutes.

Before you start: You need WordPress admin access and permission to install plugins. If your host restricts plugin uploads, use the manual FTP method.

1) Install the ZIP plugin

Option A — WordPress Admin Upload (recommended)

  1. Go to WP Admin → Plugins → Add New.
  2. Click Upload Plugin.
  3. Select the plugin ZIP file on your computer.
  4. Click Install Now.

After installation completes, WordPress will show an Activate Plugin button.

Option B — Manual Upload (FTP / File Manager)

  1. Unzip the plugin archive on your computer.
  2. Upload the plugin folder to /wp-content/plugins/.
  3. Go to WP Admin → Plugins and find the plugin in the list.
  4. Click Activate.

Manual upload is useful when your hosting blocks ZIP uploads in the WP dashboard.

2) Activate the plugin

Once activated, the plugin will add a new admin menu item: “WPMC Behavior & Heatmap”. The first activation also runs a database setup routine to create the required tables.

Recommended first checks

  • Open WPMC Behavior & Heatmap → Settings and confirm the tracked post types.
  • If you want click heatmaps, make sure BH Clicks Tracker is enabled.
  • Visit your site on the frontend and make a few clicks/scrolls, then check Statistics.

3) Database tables created on activation

The plugin stores tracking data in custom WordPress database tables. These tables are created automatically during activation (using the standard WordPress database upgrade mechanism).

Table name What it stores
{prefix}wpmc_views Page views with session linkage, URL, referrer, device type, plus aggregated fields like duration and scroll depth.
{prefix}wpmc_sessions Session records (created time, end time, last activity), device and referrer context, and user agent info.
{prefix}wpmc_mouse_trails Mouse trail data for supported views (stored as a compact trail payload with screen/window context).
{prefix}wpmc_bh_clicks Click heatmap events for the BH Engine (coordinates, viewport size, device bucket, action type, optional navigation target, and metadata).

Note: {prefix} means your WordPress table prefix (commonly wp_), but it may be different on your site.

Common installation issues

I don’t see any tables created

  • Confirm the plugin is Active in WP Admin → Plugins.
  • Check your database user has permission to CREATE tables.
  • Temporarily disable caching/minification plugins and try activation again.

Tracking doesn’t start after installation

  • Enable the relevant post types in Settings.
  • If you want click heatmaps, enable BH Clicks Tracker.
  • Visit the site as a normal user (some installs skip tracking for admins).
Login / Register

Plugin Features

Reviews ·•• Real cases

Suggestions ·UpNext 

Q&A ·•• Real Talk

WP Help Desk

Documentation

WPMC ACCOUNT