Over 10 years we help companies reach their financial and branding goals. Engitech is a values-driven technology agency dedicated.

Gallery

Contacts

411 University St, Seattle, USA

engitech@oceanthemes.net

+1 -800-456-478-23

Twitter Facebook-f Pinterest-p Instagram
Charty Analytics – Documentation

Charty Analytics

Modern WooCommerce analytics dashboard with ECharts visualizations.

Dashboard under WooCommerce menu ECharts charts Admin-only analytics Caching supported

Table of Contents

1. Requirements 2. Installation 3. Updating 4. Using the Dashboard 5. What Data is Included 6. Customization 7. Troubleshooting 8. Privacy & Security 9. Credits & Licenses 10. Support

Quick Start

  1. Install the plugin zip in WordPress.
  2. Go to WooCommerce → Charty Analytics.
  3. Select a date range and click Refresh.
  4. If data is empty, create a few test orders in WooCommerce and refresh.
Important: For accurate analytics, ensure WooCommerce orders exist in the selected date range.

1. Requirements

  • WordPress 6.x (recommended latest stable)
  • WooCommerce 8.x or newer (recommended latest stable)
  • PHP 7.4+ (recommended 8.0+)
  • Modern browser (Chrome/Edge/Firefox/Safari)

This plugin is an admin dashboard and does not add any frontend widgets by default.

2. Installation

2.1 Install via WordPress Admin

  1. Go to Plugins → Add New → Upload Plugin.
  2. Select the plugin zip file and click Install Now.
  3. Click Activate.

2.2 Install via FTP

  1. Unzip the plugin archive.
  2. Upload the folder to wp-content/plugins/.
  3. Activate from Plugins screen.

2.3 Where to Find It

Open WooCommerce → Charty Analytics in your WordPress admin menu.

3. Updating

  1. Deactivate the old version (optional but recommended for major updates).
  2. Upload/install the new zip.
  3. Activate again.

After updating, use the dashboard’s Clear Cache button to avoid seeing cached results.

4. Using the Dashboard

4.1 Sidebar Sections

  • Overview – KPI cards and high-level sales/orders trends
  • Orders – Status timelines, payment/shipping breakdown, latest orders table
  • Products – Top products (revenue/quantity), category breakdown, low stock list
  • Customers – New vs returning, repeat purchase rate, top customers
  • Marketing – Discounts trend, coupon usage split, top coupons
  • Finance – Taxes, shipping, refunds trends

4.2 Date Range

Select a range from the top bar and click Refresh. Charts update automatically.

4.3 Cache

Results are cached for performance. Use Clear Cache if you need instant recalculation.

5. What Data is Included

Charty Analytics reads order data from WooCommerce using the WooCommerce API (compatible with modern WooCommerce storage).

5.1 Orders / Sales Metrics

  • Gross sales, net sales
  • Orders count (total, paid)
  • Average order value (AOV)
  • Refund totals
  • Discount totals
  • Taxes and shipping totals

5.2 Customer Metrics

  • Unique customers (by billing email)
  • New vs returning (lookback window)
  • Repeat purchase rate
  • Top customers by spend

5.3 Product Metrics

  • Top products by revenue
  • Top products by quantity
  • Sales by category
  • Low stock list (when stock management enabled)
The dashboard only shows data for the selected date range. If the range has no orders, charts may appear empty.

6. Customization

6.1 Styling

Admin styles are located in:

assets/css/admin.css

6.2 JavaScript / Charts

Dashboard behavior and chart rendering are located in:

assets/js/admin.js

6.3 Data Logic

Server-side data aggregation lives in:

includes/class-woocharty-data.php

6.4 ECharts Asset

ECharts is loaded from:

assets/vendor/echarts/echarts.min.js

Make sure you bundle an official build and keep the license file (see Credits).

7. Troubleshooting

7.1 “No data found” / Empty Dashboard

  • Confirm there are WooCommerce orders within the selected range.
  • Try a larger range (e.g., “Last 90 days”).
  • Click Clear Cache then Refresh.

7.2 “ECharts is missing”

  • Confirm the file exists: assets/vendor/echarts/echarts.min.js
  • Ensure the file is an official ECharts build.
  • Confirm your server can read the file and it is not blocked by security rules.

7.3 Permissions / 401 / Not Allowed

  • Only users with WooCommerce reporting permissions can access analytics.
  • Use an Administrator or Store Manager role.
  • If you use a security/WAF plugin, whitelist /wp-json/ and admin-ajax.php for authenticated admin sessions.

7.4 Performance

  • Use caching (default) to avoid recalculating large datasets.
  • On very large stores, consider narrowing the date range for faster reports.

8. Privacy & Security

  • This plugin is intended for use inside WordPress admin only.
  • Analytics endpoints require an authenticated admin user with appropriate capability.
  • No customer data is exposed publicly by default.

9. Credits & Licenses

9.1 Third-Party Libraries

  • Apache ECharts – charting library used for dashboard charts.

9.2 License Files You Must Include

When bundling third-party assets, include their license files in your package. For ECharts:

  • assets/vendor/echarts/echarts.min.js
  • assets/vendor/echarts/LICENSE (Apache License 2.0)
  • (Optional) assets/vendor/echarts/NOTICE if provided by the upstream distribution

9.3 Links

Official ECharts site and license:

ECharts: https://echarts.apache.org/
Apache License 2.0: https://www.apache.org/licenses/LICENSE-2.0.txt
If you distribute ECharts with your plugin, you must comply with Apache-2.0 requirements (include license/notice).

9.4 Plugin License

Your plugin code should be licensed under a GPL-compatible license (WordPress requirement).

Recommended plugin header: GPLv2 or later.

10. Support

Please include your support channel details here.

  • Support Email: (info@uptixa.com)
  • Response time: (1-3 business days)

© Charty Analytics. All rights reserved.