=== Virtevo Insights — Store Analytics & Churn Prevention ===
Contributors: ehristov
Tags: analytics, churn prevention, sales dashboard, reports, rfm
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Store analytics dashboard with RFM churn prediction, period comparison, and automated PDF/Excel reports for WooCommerce.

== Description ==

**Stop wasting hours on manual WooCommerce reports.**

Virtevo Insights gives you a clear analytics dashboard, predicts which customers are about to leave using RFM analysis, and automatically sends reports to your inbox — in 14 languages.

A complete analytics toolkit for your WooCommerce store.

= What's Included =

* **KPI Dashboard** — Revenue, Orders, AOV, Net Revenue, Refunds with charts and a sales heatmap
* **Product Performance** — See what's selling and how categories compare
* **RFM Churn Engine** — Identify which customers are at risk of leaving
* **Customer Profiles** — Full purchase history, segments and churn scores
* **Period Comparison** — Month-over-Month, Quarter, Year-over-Year and YTD
* **Advanced Analytics** — CLV, revenue forecast, product affinity, coupon ROI, repeat-rate and inventory velocity
* **Automated Reports** — Scheduled PDF and Excel reports by email
* **14 Languages** — English, Bulgarian, Portuguese, Chinese, Russian, Spanish, French, German, Italian, Dutch, Hindi, Polish, Turkish, Arabic

= 🔮 RFM Churn Prediction =

Our proprietary RFM engine scores every customer from 0-100% churn risk based on:

* **Recency** — How recently they purchased
* **Frequency** — How often they buy
* **Monetary** — How much they spend

Customers are automatically segmented into: **Champions**, **Loyal**, **At Risk**, **Lost**.

= 📊 Period Comparison =

Compare any two periods side by side:

* Month over Month (MoM)
* Quarter over Quarter (QoQ)
* Year over Year (YoY)
* Year to Date (YTD)
* vs Previous Period (automatic same-length comparison)

Visual overlay charts + detailed comparison table with % change and trend sparklines.

= 📧 Automated Reports =

Set it up once, receive reports forever:

* Choose daily, weekly, or monthly
* PDF + Excel attached automatically
* Sent from your own store email — not from us
* Branded with your store name

= 🌍 14 Languages =

English · Bulgarian · Portuguese (Brazil) · Chinese (Simplified) · Russian · Spanish · French · German · Italian · Dutch · Hindi · Polish · Turkish · Arabic

= Privacy =

Virtevo Insights processes only WooCommerce order data that already exists in your database. No data is sent to external servers. All reports are generated and stored locally.

== Installation ==

1. Upload the plugin to `/wp-content/plugins/virtevo-insights`
2. Activate the plugin through the **Plugins** menu
3. Navigate to **Virtevo Insights** in your WordPress admin sidebar
4. The free dashboard is ready immediately — no configuration needed
5. That's it — all features are available immediately

= Requirements =

* WordPress 6.0+
* WooCommerce 7.0+
* PHP 8.0+
* At least 10 completed WooCommerce orders for churn prediction



== Frequently Asked Questions ==

= Is it really free? =

Yes, completely free. All features are included — the full KPI dashboard, RFM churn prediction, period comparison, advanced analytics, and PDF/Excel reports. No credit card, no limits.

= Does this replace my SMTP plugin? =

No. Virtevo Insights uses WordPress's built-in `wp_mail()` function. Emails are sent through whatever SMTP or email service you already have configured (WP Mail SMTP, Mailchimp, etc.).

= Where is my data stored? =

All data stays in your WordPress database. No data is sent to external servers.

= Does it work with WooCommerce HPOS? =

Yes. Virtevo Insights is fully compatible with WooCommerce High-Performance Order Storage (custom order tables).

= How accurate is the churn prediction? =

The RFM model is based on proven research. It calculates each customer's typical purchase cycle and measures how overdue they are. For best results, you need at least 10 completed orders.

== Screenshots ==

1. **Main Dashboard** — KPI cards, revenue chart and sales heatmap
2. **Period Comparison** — Month over Month overlay chart and comparison table
3. **Customer Profiles** — RFM segments and churn scores
4. **Churn Risk Dashboard** — At-risk customers with revenue at risk
5. **Export Page** — Excel and PDF export options
6. **Settings Page** — Configure email reports and preferences
7. **Advanced Analytics** — CLV, revenue forecast and product affinity
8. **PDF Report** — Branded PDF report with charts and data
9. **Email Report** — Branded HTML email with KPI cards

== Changelog ==

= 1.0.7 =
* Final cleanup of internal handles and identifiers

= 1.0.6 =
* Fixed a fatal error on the Customers and Churn pages caused by an incorrect date method call

= 1.0.5 =
* Cleaned up readme and descriptions to accurately reflect the free feature set
* Simplified internal code (removed unused plan/pricing scaffolding)

= 1.0.4 =
* Updated Chart.js to 4.5.1 (latest stable)
* Renamed all internal identifiers to use the unique "virtevo_insights" prefix (4+ chars)
* Additional output escaping
* Documented PDF template inline styles

= 1.0.3 =
* Tested up to WordPress 7.0
* Improved output escaping and prefixing for WordPress.org compliance
* Code quality improvements


= 1.0.0 =
* Initial release
* KPI Dashboard with 6 cards and 4 charts
* RFM Churn Prediction engine
* Customer Profiles with segments
* Period Comparison (MoM, QoQ, YoY, YTD, vs Previous)
* Email Scheduler (daily/weekly/monthly)
* PDF Reports (HTML-based, printable)
* Excel Export (6 data sheets)
* 14 languages
* Dark/Light theme
* HPOS compatibility

== Upgrade Notice ==

= 1.0.0 =
Initial release. Install and activate — free dashboard is ready immediately.
