PUQ Mautic

Product Analytics WHMCS Addon

WHMCS addon module providing detailed analytics and reports for products, product groups, clients, and orders. Includes dashboard overview, revenue analysis, churn tracking, client lifetime value, and order statistics with multi-currency support.

Description

Product Analytics addon WHMCS

Order now | Download | Community

PUQ Product Analytics — WHMCS Addon

PUQ Product Analytics is an addon module for WHMCS that provides comprehensive analytics and reports for your products, product groups, clients, and orders. Gain instant insights into your business performance with interactive dashboards, revenue breakdowns, churn analysis, and client lifetime value reports.

Key Features

System Requirements

Requirement Minimum
WHMCS 8.x, 9.x
PHP 8.1, 8.2+
ionCube Loader v13 or newer (v14, v15)

Changelog

Product Analytics addon WHMCS

Order now | Download | Community

v1.1 — 2026-07-15

Release of version 1.1 with standards compliance improvements, and client/product navigation integrations.

New Features

Bug Fixes and Compliance

v1.0 — 2026-02-15

First release.

New Features

Installation and Configuration

Detailed guide on installing, activating, configuring, updating, and deactivating the PUQ Product Analytics addon module for WHMCS.

Installation and Configuration

WHMCS Module Installation and Update

PUQ Product Analytics module WHMCS

Order now | Download | Community

System Requirements

Requirement Minimum
WHMCS 8.x or higher
PHP 8.1 or 8.2
ionCube Loader v13 or newer

Note: The module is encrypted with ionCube. Ensure that the correct ionCube Loader version is active on your web server.

Download

The module is distributed as a single ZIP archive. A separate build is published for each supported PHP major version.

All versions and historical builds are available in the index:

Direct "latest" downloads

PHP 8.2

wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/php82/PUQ_WHMCS-Product-Analytics-latest.zip

PHP 8.1

wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/php81/PUQ_WHMCS-Product-Analytics-latest.zip

Not sure which PHP version your WHMCS runs on? Check Utilities > System > PHP Info in the WHMCS admin area.

Installation

Step 1: Unzip the Archive

On your WHMCS server (or locally):

unzip PUQ_WHMCS-Product-Analytics-latest.zip

Step 2: Copy the Module Files

Copy the extracted module directory directly to your WHMCS directory:

cp -r PUQ_WHMCS-Product-Analytics/puq_product_analytics /var/www/html/whmcs/modules/addons/

Step 3: Activate and Configure the Addon Module

  1. Log in to the WHMCS admin area.
  2. Navigate to System Settings > Addon Modules (or Setup > Addon Modules).
  3. Find PUQ Product Analytics in the list and click Activate.
  4. Click Configure, enter your License Key, and select the admin groups allowed to access the module.
  5. Click Save Changes.

File Structure

Structure of files after a successful installation:

whmcs/
└── modules/
    └── addons/
        └── puq_product_analytics/   # Addon files

Update Procedure

To update the module to a newer version:

  1. Deactivate the addon module in Setup > Addon Modules.
  2. Make a backup of your WHMCS files and database.
  3. Download the latest version for your PHP version.
  4. Extract the ZIP and overwrite the existing files in the modules/ directories.
  5. Reactivate the addon module in Setup > Addon Modules (this will trigger database migrations). All settings and client data are safe during this process.
Installation and Configuration

Initial Setup and Access Control

Product Analytics addon WHMCS

Order now | Download | Community

After uploading the module files, you need to activate the module and configure roles and permissions inside WHMCS.

1. Activate the Addon

  1. Log in to your WHMCS admin area.
  2. Navigate to System Settings > Addon Modules (or Setup > Addon Modules in older versions).
  3. Find PUQ Product Analytics in the list.
  4. Click Activate.

2. Configure Settings & Permissions

  1. Click Configure next to PUQ Product Analytics.
  2. Enter your license key in the License key field.
  3. In Access Control, check the administrator role groups that are allowed to access and view the analytics (e.g., Full Administrator, Sales Operator, Support Operator, test).
  4. Click Save Changes.

3. Verify Activation

Once settings are saved, the license validation status will display directly below the license key field:

PUQ Product Analytics Activation and Access Control Configuration 01-addon-config-license.png

Admin Area

Detailed guide on using the administrator interface: dashboard, product reports, group reports, client metrics, and order statistics.

Admin Area

Dashboard

Product Analytics addon WHMCS

Order now | Download | Community

The Dashboard is the home page of the module, available at: Addons > PUQ Product Analytics > Home

It provides a complete overview of your WHMCS business at a glance — key metrics, revenue, service status, subscription trends, and top-performing products and groups.

Dashboard — full overview with key metrics, charts, and rankings 02-dashboard.png

Key Metrics

The top row displays summary cards with the most important numbers:

Metric Description
Total Products Number of products configured in WHMCS
Total Groups Number of product groups
Total Clients Number of registered clients
Active Services Services with Active status
Total Services Total number of services across all statuses
Retention Rate Percentage of services that remain active (color-coded: green >= 70%, yellow >= 40%, red < 40%)

Services by Status

A donut chart showing the distribution of all services by their current status:

Recurring Revenue

Displays estimated recurring revenue broken down by currency:

Orders (Last 30 Days)

Summary of recent order activity per currency, showing the number of orders and their total amount.

New Subscriptions (12 mo)

A bar chart showing the number of new service subscriptions per month over the last 12 months, helping you identify growth trends.

Top Products by Active Services

A horizontal bar chart ranking products by the number of currently active services.

Top Groups by Services

A horizontal bar chart ranking product groups by total service count, with the number of active services shown in parentheses.

Admin Area

Products Overview

Product Analytics addon WHMCS

Order now | Download | Community

The Products Overview page is available at: Addons > PUQ Product Analytics > Products > Products Overview

Summary of all products configured in WHMCS with active and total services count.

Products Overview — summary cards and full product table with service counts 03-products-overview.png

Summary Cards

The top section displays four key metrics:

Metric Description
Total Products Total number of products configured in WHMCS
Product Groups Number of product groups
Active Services Total services with Active status across all products
Total Services Total number of services across all statuses

Products Table

A sortable and searchable table listing every product with the following columns:

Column Description
# Product ID in WHMCS
Product Name Name of the product (clickable link)
Type Product type (hostingaccount, server, other, etc.)
Group Product group the product belongs to
Active Number of active services (green badge)
Suspended Number of suspended services (yellow badge)
Terminated/Cancelled Number of terminated and cancelled services (red badge)
Total Total number of services for this product

The table supports real-time search filtering and column sorting.

Admin Area

Revenue by Product

Product Analytics addon WHMCS

Order now | Download | Community

The Revenue by Product page is available at: Addons > PUQ Product Analytics > Products > Revenue by Product

Recurring revenue breakdown per product, normalized to annual and monthly estimates.

Revenue by Product — revenue summary cards and detailed product revenue table 04-revenue-by-product.png

Revenue Summary

The top section shows total revenue cards for each currency configured in WHMCS:

Metric Description
Annual Revenue Total estimated annual recurring revenue
Monthly Revenue Normalized monthly revenue estimate
Services Number of active services contributing to this revenue

Each currency (e.g., EUR, USD, PLN) is displayed as a separate card.

Revenue Table

A sortable and searchable table with per-product revenue breakdown:

Column Description
# Product ID
Product Name Name of the product
Group Product group
Currency Currency badge (color-coded)
Active Number of active services
Annual Revenue Estimated annual revenue from this product in this currency
Monthly Revenue Estimated monthly revenue

Note: Revenue is calculated from the recurring amount of active services. Products with multiple currencies appear as separate rows.

Admin Area

Product Popularity

Product Analytics addon WHMCS

Order now | Download | Community

The Product Popularity page is available at: Addons > PUQ Product Analytics > Products > Product Popularity

Product performance for the selected period — new subscriptions, retention, and actual revenue from paid invoices.

Product Popularity — subscription stats by currency with monthly charts 05-product-popularity.png

Date Range Filter

At the top of the page, a set of period buttons allows you to select the analysis timeframe:

Subscription Statistics

For each currency, four key metrics are displayed:

Metric Description
New Subscriptions Number of new services created in the selected period
Still Active How many of those new services are still active
Churned How many of those new services have been terminated or cancelled
Revenue in Period Actual revenue from paid invoices in the selected period

Monthly Charts

Below the statistics, two charts are displayed per currency:

These charts help identify seasonal trends and growth patterns in product performance.

Admin Area

Product Churn

Product Analytics addon WHMCS

Order now | Download | Community

The Product Churn page is available at: Addons > PUQ Product Analytics > Products > Product Churn

Churn and retention analysis per product — identify which products lose the most customers.

Product Churn — churn rate summary and per-product churn table with visual bars 06-product-churn.png

Summary Cards

The top section displays four key churn metrics:

Metric Description
Churn Rate Overall percentage of services that have been terminated or cancelled
Retention Rate Overall percentage of services that remain active
Churned Services Total number of terminated and cancelled services
At Risk (Suspended) Number of currently suspended services that may churn

Churn by Product

A sortable and searchable table showing churn analysis per product:

Column Description
Product Name Name of the product
Total Total number of services (all statuses)
Active Number of active services (green badge)
Suspended Number of suspended services (yellow badge)
Churned Number of terminated/cancelled services (red badge)
Churn Rate Percentage of churned services with color-coded visual bar (green to red)
Retention Rate Percentage of active services with color-coded visual bar (red to green)

Tip: Products with high churn rate and many total services should be investigated first — they represent the biggest potential for improvement.

Admin Area

Groups Overview

Product Analytics addon WHMCS

Order now | Download | Community

The Groups Overview page is available at: Addons > PUQ Product Analytics > Groups > Groups Overview

Summary of all product groups with services count.

Groups Overview — summary cards and groups table with service counts 07-groups-overview.png

Summary Cards

The top section displays four key metrics:

Metric Description
Total Groups Number of product groups configured in WHMCS
Total Products Total number of products across all groups
Active Services Total services with Active status
Total Services Total number of services across all statuses

Groups Table

A sortable and searchable table listing every product group:

Column Description
# Group ID in WHMCS
Group Name Name of the product group (clickable link)
Products Number of products in this group
Active Number of active services (green badge)
Suspended Number of suspended services (yellow badge)
Terminated/Cancelled Number of terminated and cancelled services (red badge)
Total Total number of services in this group

The table supports real-time search filtering and column sorting.

Admin Area

Revenue by Group

Product Analytics addon WHMCS

Order now | Download | Community

The Revenue by Group page is available at: Addons > PUQ Product Analytics > Groups > Revenue by Group

Recurring revenue breakdown per product group, normalized to annual and monthly estimates.

Revenue by Group — revenue summary cards and detailed group revenue table 08-revenue-by-group.png

Revenue Summary

The top section shows total revenue cards for each currency:

Metric Description
Annual Revenue Total estimated annual recurring revenue
Monthly Revenue Normalized monthly revenue estimate
Services Number of active services contributing to this revenue

Each currency (e.g., EUR, USD, PLN) is displayed as a separate card.

Revenue Table

A sortable and searchable table with per-group revenue breakdown:

Column Description
# Group ID
Group Name Name of the product group
Products Number of products in this group
Currency Currency badge (color-coded)
Active Number of active services
Annual Revenue Estimated annual revenue from this group in this currency
Monthly Revenue Estimated monthly revenue

Note: Groups with products in multiple currencies appear as separate rows per currency.

Admin Area

Group Distribution

Product Analytics addon WHMCS

Order now | Download | Community

The Group Distribution page is available at: Addons > PUQ Product Analytics > Groups > Group Distribution

Distribution of services across product groups — see which groups have the most services.

Group Distribution — summary cards and donut chart with all groups 09-group-distribution.png

Summary Cards

The top section displays four key metrics:

Metric Description
Total Groups Number of product groups
Total Services Total number of services across all groups
Active Services Services with Active status
Ungrouped Services belonging to products without a group

Services Distribution

A large donut chart visualizing how services are distributed across all product groups. Each segment represents a group with:

The chart includes all groups, even those with zero services, providing a complete picture of your product portfolio distribution.

Admin Area

Clients Overview

Product Analytics addon WHMCS

Order now | Download | Community

The Clients Overview page is available at: Addons > PUQ Product Analytics > Clients > Clients Overview

Summary of all clients — status breakdown, age distribution, and new registrations.

Clients Overview — client stats, status donut chart, and age distribution 10-clients-overview.png

Summary Cards

The top section displays four key client metrics:

Metric Description
Total Clients Total number of registered clients
Paying Clients Clients who have at least one paid invoice
Non-Paying Clients with no paid invoices
Avg Lifetime Average client lifetime in months

Clients by Status

A donut chart showing the distribution of clients by their current status:

Client Age Distribution

A horizontal bar chart showing how long clients have been registered:

New Clients per Month

A bar chart showing the number of new client registrations per month, helping you identify growth trends.

Admin Area

Client Lifetime Value

Product Analytics addon WHMCS

Order now | Download | Community

The Client Lifetime Value page is available at: Addons > PUQ Product Analytics > Clients > Client Lifetime Value

Average revenue per client, revenue distribution, and top clients by lifetime value.

Client Lifetime Value — LTV stats per currency, revenue distribution, and top clients 11-client-lifetime-value.png

LTV Statistics

For each currency, five key metrics are displayed:

Metric Description
Average LTV Average lifetime revenue per paying client
Total Revenue Total revenue from all paid invoices
Avg Monthly Value Average monthly revenue per paying client
Paying Clients Number of paying clients (shown as paying / total)
Avg Lifetime Average client lifetime in months

Each currency (e.g., USD, EUR, PLN, UAH) is displayed as a separate row of cards.

Revenue Distribution

A horizontal bar chart per currency showing how clients are distributed across revenue brackets:

Top Clients by Revenue

A horizontal bar chart per currency showing the highest-revenue clients, ranked by total paid amount.

Admin Area

Client Revenue

Product Analytics addon WHMCS

Order now | Download | Community

The Client Revenue page is available at: Addons > PUQ Product Analytics > Clients > Client Revenue

Detailed revenue breakdown per client with lifetime and monthly value.

Client Revenue — revenue summary per currency and detailed client table 12-client-revenue.png

Revenue Summary

For each currency, three key metrics are displayed:

Metric Description
Total Revenue Total revenue from paid invoices in this currency
Total Clients Number of clients with invoices in this currency
Paying Clients Number of clients who have actually paid

Each currency is displayed as a separate row of cards.

Client Revenue Table

A sortable and searchable table per currency with detailed client data:

Column Description
Client Name Name of the client
Active Client status badge (Active / Inactive)
Client Since Registration date
Lifetime How long the client has been registered (in months)
Invoices Paid Total number of paid invoices
Total Revenue Lifetime revenue from this client
Monthly Value Average monthly revenue from this client

The table supports real-time search filtering and column sorting.

Admin Area

Orders Overview

Product Analytics addon WHMCS

Order now | Download | Community

The Orders Overview page is available at: Addons > PUQ Product Analytics > Orders > Orders Overview

Summary of all orders with status breakdown, monthly chart, and recent activity.

Orders Overview — order stats by currency with monthly order and revenue charts 13-orders-overview.png

Date Range Filter

At the top of the page, a set of period buttons allows you to select the analysis timeframe:

Order Statistics

For each currency, four key metrics are displayed:

Metric Description
Total Orders Total number of orders with the total amount
Active Number of orders with Active status and their total amount
Pending Number of orders with Pending status
Cancelled / Fraud Number of cancelled or fraudulent orders

Each currency (e.g., PLN, EUR, UAH, USD) is displayed as a separate row of cards.

Monthly Charts

Below the statistics, two charts are displayed per currency:

These charts help identify order trends and seasonal patterns in sales activity.

Admin Area

Orders by Product

Product Analytics addon WHMCS

Order now | Download | Community

The Orders by Product page is available at: Addons > PUQ Product Analytics > Orders > Orders by Product

Ranking of products by number of orders and total revenue.

Orders by Product — order summary per currency and top products ranking 14-orders-by-product.png

Date Range Filter

At the top of the page, a set of period buttons allows you to select the analysis timeframe:

Order Statistics

For each currency, three key metrics are displayed:

Metric Description
Total Orders Total number of orders in the selected period
Total Amount Total revenue from orders
Products Ordered Number of unique products that received orders

Each currency is displayed as a separate row of cards.

Top Products

A horizontal bar chart per currency ranking products by the number of orders received in the selected period. This helps identify your best-selling products and understand which products drive the most order volume.

Client Area

Information about the client-side area.

Client Area

Client Actions

Product Analytics addon WHMCS

Order now | Download | Community

The PUQ Product Analytics addon is an administrative tool only. It does not provide any functionality, pages, or interface components in the client area.