Woo Insights Pro

# Changelog All notable changes to Woo Insights Pro will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [1.2.0] - 2026-07-27 ### Added - **Licence enforcement.** The analytics dashboard and its 24 AJAX actions now require a valid licence. What happens on expiry and when unlicensed is configured per product in the store, not baked into the plugin: an expired licence keeps the plugin running and only stops updates, while an install with no valid licence works through a grace window and then locks with a purchase link. - Locked screen linking to the licence page and the product page. ### Fixed - **Bundled SDK version.** `vendor/forge-sdk/version.php` returned the plugin version (`1.1.9`). The SDK loader picks the highest registered version across the whole site, so this copy outranked correct `1.0.0` copies and forced its stale code onto every other Forge-licensed plugin installed alongside it. It now returns the SDK contract version. - The bundled SDK was missing `Notices.php` entirely and shipped stale `Client`, `LicensePage` and `UpdateChecker` copies. All eight files are now in sync and tracked in git. - Licensing no longer fails open: a missing SDK client used to report every feature as available. ### Removed - `Premium_Helper` and `Plan_Feature_Gate`. Both were free/pro/enterprise scaffolding hardwired to always answer "pro", so they gated nothing while competing with the real licence check. ## [1.1.9] - 2026-07-20 ### Added - **Visible Data Point Markers:** Set `pointRadius: 4` with white fill and dataset border color on line charts in the **Динамика на Продажбите** section. - **Column-Wide Hover Interaction:** Configured `interaction: { mode: 'index', intersect: false }` for instant tooltip display along the vertical axis of any date. - **Bulgarian Chart Legend Labels:** Translated legend dataset labels to **"Текущ период"** and **"Предишен период"**. ## [1.1.8] - 2026-07-20 ### Fixed - **500 AJAX Error Fix:** Resolved `500 Internal Server Error` on `admin-ajax.php` when selecting "Всички Статуси" (All Statuses) by returning an array of all registered WooCommerce order statuses (`Orders::all_wc_statuses()`) instead of string `'any'`. - **All Statuses Volume & Sales:** Updated metrics calculation for "Всички Статуси" to aggregate total sales, total orders, AOV, and chart trends across all orders for the period. ## [1.1.7] - 2026-07-20 ### Fixed - **404 Asset Error Fix:** Created `assets/css/admin.css` fallback stylesheet to resolve `404 (Not Found)` error in WordPress admin. - **AJAX Error Handler:** Enhanced `Dashboard_Ajax.php` catch block to log full error messages with file line numbers to PHP `error_log` and include diagnostic details in response payload. ## [1.1.6] - 2026-07-20 ### Fixed - **PHP Warning Fix:** Fixed undefined variable `$statuses` in `Product_Metrics.php`. - **PHP TypeError Fix:** Ensured `in_array()` second argument is always an array by separating `$query_statuses` (`'any'` or `array`) for DB queries from `$revenue_statuses` (`array`) for status filtering. ## [1.1.5] - 2026-07-20 ### Added - **Order Status Breakdown Banner:** Added dynamic status distribution badges (`Приключена`, `В обработка`, `Задържана`, `В очакване`, `Отказана`, `Възстановена`, `Неуспешна`) displaying exact order counts per status for the active period. ### Changed - **All Statuses Metrics Logic:** When no status filter is selected ("Всички Статуси"), **Общо Поръчки** counts all orders across all statuses, while **Общо Продажби** aggregates revenue from realized orders (`completed` & `processing`). ## [1.1.4] - 2026-07-20 ### Changed - **Default Status Filtering:** Default dashboard view ("Всички Статуси") now strictly counts positive realized orders (`completed` & `processing`). - **Dynamic Specific Status Metrics:** Selecting a specific status filter (e.g. `cancelled`, `on-hold`, `pending`, `refunded`, `failed`) now fetches and displays actual order totals and metrics for that specific status. ## [1.1.3] - 2026-07-20 ### Fixed - **Filter Reset Date Input Visibility:** Fixed issue where `#wip-custom-start` and `#wip-custom-end` inputs were hidden on clicking "Изчисти" (Clear). Date inputs now stay visible in the filter card grid while resetting values to default. ## [1.1.2] - 2026-07-20 ### Added - **Explicit Apply/Clear Filter Workflow:** Added dedicated button handlers for "Приложи Филтри" (Apply) and "Изчисти" (Clear). - **Comprehensive Filter Reset:** "Изчисти" (Clear) now resets all UI fields (period pills to "Този месец", custom start/end dates, customer, coupon, status, traffic origin, categories, country, state) to their default values and reloads the default dashboard metrics. ## [1.1.1] - 2026-07-20 ### Fixed - **Order Status Filtering:** Resolved status comparison mismatch (`wc-completed` vs `completed`) and hardcoded allowed status restrictions across metrics services. - **Filter Event Listeners:** Added change event handlers to status, channel, customer, and coupon dropdowns for auto reloading. ## [1.1.0] - 2026-07-20 ### Added - **Cohort Retention Matrix:** Track customer repeat purchase rates and cohort revenue retention across M0 to M5. - **Customer Lifetime Value (CLV/LTV):** Compute average lifetime value per customer and average days between purchases. - **Frequently Bought Together (Bundles):** Matrix tracking of co-purchased product pairs in single orders. - **Acquisition vs. Loyalty Products:** Identify initial acquisition items vs repeat products. - **UTM Campaign Performance:** Aggregated revenue and order metrics by `utm_campaign`, `utm_source`, and `utm_medium`. - **Units Per Transaction (UPT):** Calculate average items per order and coupon dependency rate. ## [1.0.1] - 2026-07-20 ### Fixed - Fixed missing `includes/Autoloader.php` issue by standardizing top-level ZIP directory layout (`woo-insights-pro/`). - Fixed Select2 element doubling and native dropdown visibility on third-party admin themes. - Fixed dashboard alignment shift by removing negative wrapper margins. ## [1.0.0] - 2026-07-19 ### Added - Initial release of Woo Insights Pro. - WooCommerce Analytics Dashboard with key metrics (Sales, Orders, AOV, Top Products, Traffic Attribution). - Enhanced filtering by date ranges, customers, and coupons. - Data export in CSV and PDF formats with automatic printable fallback. - Architecture with Service Container and Event Manager.