WP Manifestindependent plugin directory
manifest / analytics / plugin-metricswizard

Metrics Wizard

A WordPress plugin that tracks clicks on specific page elements using CSS selectors, without modifying your HTML.

by inbrackets · github.com/marceloquinze/plugin-metricswizard · website

0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/marceloquinze/plugin-metricswizard/archive/refs/heads/main.zip

MetricsWizard – Smart Click Tracker

Track clicks on specific page elements using CSS selectors, without modifying your HTML.

Description

MetricsWizard – Smart Click Tracker allows site administrators to track user interactions with specific page elements using CSS selectors.

The plugin works entirely via JavaScript and the WordPress REST API, meaning no HTML markup changes are required. You simply define trackers using CSS selectors, and MetricsWizard handles the rest.

Key benefits include element-level analytics, click timelines, page-based filtering, and a privacy-conscious approach with hashed IP addresses.

This plugin is ideal for UX analysis, conversion tracking, and behavioral insights on WordPress websites.

Features

  • Track clicks using CSS selectors
  • Unlimited number of trackers
  • No HTML or theme changes required
  • Admin dashboard with filters
  • Click analytics by date and page
  • Visual charts for interaction trends
  • Uses WordPress REST API
  • GDPR-friendly (IP addresses are hashed)

Installation

  1. Upload the plugin files to the /wp-content/plugins/metricswizard directory, or install the plugin through the WordPress Plugins screen.
  2. Activate the plugin through the Plugins menu in WordPress.
  3. Navigate to MetricsWizard → Trackers to add your first tracker.

Usage

  1. Go to MetricsWizard → Trackers.
  2. Add a new tracker by providing:
    • A tracker name
    • A valid CSS selector
  3. Clicks on matching elements will be tracked automatically.
  4. View analytics in MetricsWizard → Analytics.

Frequently Asked Questions

Does this plugin modify my HTML?

No. All tracking is handled via JavaScript using CSS selectors.

Is the user IP address stored?

The IP address is hashed before storage to help protect user privacy.

Can I track multiple elements?

Yes. You can create as many trackers as needed.

Is this plugin GDPR compliant?

The plugin hashes IP addresses and does not use cookies by default. Compliance depends on how you use the collected data.

Screenshots

  1. Trackers management screen
  2. Analytics dashboard with charts
  3. Date and page filtering options

Changelog

1.0.0

  • Initial release
  • Click tracking via CSS selectors
  • Admin analytics dashboard
  • Charts and filters

1.1.0

  • Added method to dynamicly get the plugin's version
  • Small security adjustments

Upgrade Notice

1.0.0

Initial release.