# Product Analytics WHMCS Addon # Description ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) ## 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 - **Dashboard Overview** — complete business snapshot with key metrics, service status donut chart, recurring revenue, subscription trends, and top products/groups rankings - **Products Overview** — sortable table of all products with active, suspended, terminated, and total service counts - **Revenue by Product** — recurring revenue breakdown per product, normalized to annual and monthly estimates, with multi-currency support - **Product Popularity** — new subscriptions, retention, and actual revenue from paid invoices for a selected period with monthly charts - **Product Churn** — churn and retention rate analysis per product with color-coded visual bars to identify at-risk products - **Groups Overview** — summary of all product groups with service counts and status breakdown - **Revenue by Group** — recurring revenue breakdown per product group with multi-currency support - **Group Distribution** — donut chart visualization of service distribution across all product groups - **Clients Overview** — client status breakdown, age distribution, and new registration trends - **Client Lifetime Value** — average LTV per currency, revenue distribution brackets, and top clients by total revenue - **Client Revenue** — detailed per-client revenue table with lifetime, invoices paid, and monthly value - **Orders Overview** — order statistics by status per currency with monthly order and revenue charts - **Orders by Product** — product ranking by number of orders and total revenue for a selected period - **Multi-currency support** — all reports display data separately per currency - **Date range filters** — flexible period selection on applicable reports (This Month, This Year, Last 30 Days, Last 12 Months, Last 2 Years, All Time) - **Real-time search and sorting** — all tables support instant filtering and column sorting - **License system** — online/offline license verification with graceful degradation (dashboard remains accessible without a license) - **English language interface** - - - - - - ## System Requirements
RequirementMinimum
**WHMCS**8.x, 9.x
**PHP**8.1, 8.2+
**ionCube Loader**v13 or newer (v14, v15)
- - - - - - ## Links - **Product page:** [https://puqcloud.com/](https://puqcloud.com/) - **Documentation:** [https://doc.puq.info/books/product-analytics-whmcs-addon](https://doc.puq.info/books/product-analytics-whmcs-addon) - **Support:** [https://puqcloud.com/submitticket.php](https://puqcloud.com/submitticket.php?step=2&deptid=1) - **Community:** [https://community.puqcloud.com/](https://community.puqcloud.com/)# Changelog ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) ## v1.1 — 2026-07-15 Release of version 1.1 with standards compliance improvements, and client/product navigation integrations. ### New Features - Integrated quick navigation links for all products to the WHMCS product edit page (`configproducts.php?action=edit&id=X`) in all product tables. - Integrated quick navigation links for clients to their WHMCS summaries (`clientssummary.php?userid=Y`) in client tables. - Added automatic Preflight System Requirements checks (PHP version, JSON/Guzzle extensions check) before activation. ### Bug Fixes and Compliance - Aligned module architecture with PUQ WHMCS Standards v3+. - Replaced direct PHP cURL with WHMCS-native `GuzzleHttp\Client`. - Fixed false positive Cyrillic warnings and localized remaining untranslated elements in header and 404 templates. - Replaced ASCII apostrophes with safe typographic apostrophes in French, Catalan, and Italian translation files. - Eliminated redundant `logModuleCall` logging during offline license checks to prevent database bloat. ## v1.0 — 2026-02-15 First release. ### New Features - Dashboard with key metrics overview (products, groups, clients, services, retention rate) - Services by Status donut chart on dashboard - Recurring Revenue cards with multi-currency support - Orders (Last 30 Days) summary on dashboard - New Subscriptions (12 mo) bar chart on dashboard - Top Products by Active Services ranking on dashboard - Top Groups by Services ranking on dashboard - Products Overview report with sortable product table - Revenue by Product report with annual/monthly estimates per currency - Product Popularity report with date range filter, subscription stats, and monthly charts - Product Churn report with churn/retention rates and color-coded visual bars - Groups Overview report with group table and service counts - Revenue by Group report with per-group revenue breakdown - Group Distribution report with donut chart visualization - Clients Overview report with status breakdown, age distribution, and new clients chart - Client Lifetime Value report with LTV stats, revenue distribution, and top clients - Client Revenue report with detailed per-client revenue table - Orders Overview report with order stats by currency and monthly charts - Orders by Product report with product ranking by order volume - Date range filters (This Month, This Year, Last 30 Days, Last 12 Months, Last 2 Years, All Time) - Multi-currency support across all reports - Real-time search and column sorting on all tables - License verification system with online/offline modes - Dashboard accessible without active license, other pages restricted - English language interface# Installation and Configuration Detailed guide on installing, activating, configuring, updating, and deactivating the PUQ Product Analytics addon module for WHMCS. # WHMCS Module Installation and Update ### PUQ Product Analytics module **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) ## 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: - [https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) ### Direct "latest" downloads #### PHP 8.2 ```bash wget https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/php82/PUQ_WHMCS-Product-Analytics-latest.zip ``` #### PHP 8.1 ```bash 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): ```bash unzip PUQ_WHMCS-Product-Analytics-latest.zip ``` ### Step 2: Copy the Module Files Copy the extracted module directory directly to your WHMCS directory: ```bash 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. # Initial Setup and Access Control ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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: - **Success status** (e.g., `success: 2027-02-15T19:41:07+01:00`) indicates that the module successfully validated its license and is ready. ![PUQ Product Analytics Activation and Access Control Configuration](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-ifabal7w.png) *01-addon-config-license.png* # Admin Area Detailed guide on using the administrator interface: dashboard, product reports, group reports, client metrics, and order statistics. # Dashboard ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-gpfmn5xf.png) *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: - **Active** (green) — currently running services - **Suspended** (yellow) — temporarily suspended - **Terminated** (red) — permanently terminated - **Cancelled** (gray) — cancelled by client or admin - **Pending** (blue) — awaiting activation --- ## Recurring Revenue Displays estimated recurring revenue broken down by currency: - **Annual Revenue** — total estimated yearly revenue from active services - **Monthly Revenue** — normalized monthly estimate - Each currency is shown separately (e.g., USD, EUR, PLN) --- ## 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. # Products Overview ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-k7fjbqea.png) *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. # Revenue by Product ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-zwxywq9z.png) *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. # Product Popularity ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-u0po2s9j.png) *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: - **This Month** — current calendar month - **This Year** — current calendar year - **Last 30 Days** — rolling 30-day window - **Last 12 Months** — rolling 12-month window (default) - **Last 2 Years** — rolling 24-month window - **All Time** — entire history --- ## 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: - **New Subscriptions per Month** — bar chart showing the number of new services created each month - **Revenue per Month** — bar chart showing actual paid revenue per month These charts help identify seasonal trends and growth patterns in product performance. # Product Churn ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-z8oqzhwj.png) *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. # Groups Overview ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-u4qqmy7q.png) *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. # Revenue by Group ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-skj5oplr.png) *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. # Group Distribution ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-ocgorfvk.png) *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: - **Group name** — displayed in the legend - **Service count** — total services in the group - **Percentage** — share of total services The chart includes all groups, even those with zero services, providing a complete picture of your product portfolio distribution. # Clients Overview ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-dccuehlv.png) *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: - **Active** (green) — clients with active services - **Inactive** (yellow) — clients without active services --- ## Client Age Distribution A horizontal bar chart showing how long clients have been registered: - **< 1 mo** — registered less than a month ago - **1 - 3 mo** — 1 to 3 months - **3 - 6 mo** — 3 to 6 months - **6 - 12 mo** — 6 months to 1 year - **1 - 2 yr** — 1 to 2 years - **2 - 5 yr** — 2 to 5 years - **5+ yr** — more than 5 years --- ## New Clients per Month A bar chart showing the number of new client registrations per month, helping you identify growth trends. # Client Lifetime Value ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-efr4syt9.png) *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: - **$0** — clients with no revenue - **$0 - $50** — low-value clients - **$50 - $200** — medium-value clients - **$200 - $500** — higher-value clients - **$500 - $1K** — high-value clients - **$1K - $5K** — premium clients - **$5K+** — top-tier clients --- ## Top Clients by Revenue A horizontal bar chart per currency showing the highest-revenue clients, ranked by total paid amount. # Client Revenue ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-qqt5givg.png) *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. # Orders Overview ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-apv4bszg.png) *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: - **This Month** — current calendar month - **This Year** — current calendar year - **Last 30 Days** — rolling 30-day window - **Last 12 Months** — rolling 12-month window (default) - **Last 2 Years** — rolling 24-month window - **All Time** — entire history --- ## 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: - **Orders per Month** — bar chart showing the number of orders placed each month - **Revenue per Month** — bar chart showing order revenue per month These charts help identify order trends and seasonal patterns in sales activity. # Orders by Product ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) 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](https://doc.puq.info/uploads/images/gallery/2026-07/embedded-image-t6e4wvqd.png) *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: - **This Month** — current calendar month - **This Year** — current calendar year - **Last 30 Days** — rolling 30-day window - **Last 12 Months** — rolling 12-month window (default) - **Last 2 Years** — rolling 24-month window - **All Time** — entire history --- ## 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 Actions ### Product Analytics addon **[WHMCS](https://puqcloud.com/link.php?id=77)** ##### [Order now](https://puqcloud.com/store/whmcs-addon-modules) | [Download](https://download.puqcloud.com/WHMCS/addons/PUQ_WHMCS-Product-Analytics/) | [Community](https://community.puqcloud.com/) The PUQ Product Analytics addon is an administrative tool only. It does not provide any functionality, pages, or interface components in the client area.