=== NexaFlow Intelligence for WooCommerce ===
Contributors: salauddinahmedbhuiyan
Tags: woocommerce, analytics, customer analytics, ecommerce, conversion funnel, customer insights, sales analytics
Requires at least: 6.2
Requires PHP: 7.4
Tested up to: 7.1
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WooCommerce analytics, business intelligence, customer insights, product performance, conversion funnels and store reporting.

== Description ==

NexaFlow Intelligence for WooCommerce is a first-party WooCommerce business intelligence and analytics platform designed to help store owners understand store performance, customer behavior, products, acquisition and conversion activity from within WordPress.

The plugin turns WooCommerce store data and optional first-party analytics events into practical reporting across commerce, customers, marketing, behavior, conversion and performance.

The plugin works with WooCommerce data and stores its analytics data in the site's WordPress database. Analytics tracking is optional and requires explicit visitor consent when enabled.

== Features ==

* Executive and business intelligence dashboards with KPI and trend reporting.
* WooCommerce revenue, orders, average order value, products, customers and payment-method analytics.
* Conversion funnel and checkout intelligence with observed checkout and payment signals.
* Customer Intelligence with repeat behavior, purchase intervals, category preference and explainable customer health signals.
* Customer Journey and customer-level behavioral reporting.
* Cohorts and retention analysis.
* Customer Segments and RFM analysis.
* Acquisition, campaigns, referrals and traffic-source reporting.
* Marketing intelligence and attribution reporting.
* Geography, devices, site search and behavior analytics.
* Real-time event reporting with privacy-conscious first-party tracking.
* True Profit reporting with recorded product and order costs, refunds, shipping and payment-related costs where available.
* Goals, conversions and A/B testing reporting.
* Performance and speed-readiness diagnostics for the WordPress and WooCommerce environment.
* Local Business Copilot and rule-based business insights without requiring an external AI service.
* WooCommerce-compatible floating cart controls and a WooCommerce-backed fallback drawer.
* Export tools for report data in CSV, JSON and print/PDF workflows.

== Dashboard ==

The main dashboard provides an overview of store performance in one place.

It includes:

* Total sales.
* Orders.
* Average order value.
* Conversion rate.
* Sales trends.
* Top products.
* Product recommendations.
* Customer behavior insights.
* Abandoned cart recovery insights.
* Recent orders.

== Analytics ==

The Analytics module provides a broader view of website and store activity.

It includes reporting for:

* Visitors.
* Sessions.
* Page views.
* Bounce rate.
* Average session duration.
* Events.
* Traffic channel breakdown.
* Top pages.
* Top products.
* Device breakdown.
* Store performance insights.

== Traffic Sources ==

Traffic Sources helps store owners understand where visitors and sessions originate and how different channels perform.

It provides:

* Total sessions.
* Total users.
* Attributed revenue.
* Conversion rate.
* Average order value.
* Traffic source trends.
* Traffic source distribution.
* Source and medium details.
* Revenue by source.
* Conversion rate by source.
* Acquisition insights.

Supported reporting can include direct traffic, organic search, referrals, social, email and paid search when corresponding data is available.

== Product Intelligence ==

Product Intelligence focuses on product-level performance and conversion behavior.

It provides:

* Total products.
* Product views.
* Add-to-cart activity.
* Purchases.
* Product revenue.
* Product conversion rate.
* Product views over time.
* Top products by revenue.
* Top-performing product tables.
* Product performance by category.
* Product insights.

== Checkout Intelligence ==

Checkout Intelligence helps store owners understand checkout activity and identify drop-off points.

It provides reporting for:

* Started checkout.
* Reached checkout.
* Completed orders.
* Checkout conversion rate.
* Checkout abandonment rate.
* Checkout funnel stages.
* Abandonment by checkout step.
* Abandonment reasons where survey data is available.
* Checkout performance over time.
* Checkout optimization reporting.
* Checkout insights.

== Customer Journey ==

Customer Journey provides reporting about how customers interact with the store across multiple stages.

It can show:

* Total customers.
* Journey starts.
* Products viewed.
* Add-to-cart activity.
* Orders.
* Journey conversion rate.
* Customer journey flow.
* Common journey paths.
* Entry pages.
* Journey health.
* Journey performance by device.
* Customer journey insights.
* Cohort-based journey timelines.

== Site Search ==

Site Search provides reporting for searches performed on the store.

It includes:

* Total searches.
* Total clicks.
* Click-through rate.
* Searches with no results.
* Top search terms.
* Search volume.
* Search clicks.
* Search click-through rate.
* No-result counts.
* Search performance reporting.

== Alerts ==

Alerts provides a central view of important store and system events.

It can report:

* Total alerts.
* Critical alerts.
* Warning alerts.
* Resolved alerts.
* Alert history.
* Alert severity.
* Alert source.
* Alert message.
* Alert date and time.
* Alert status.
* Available alert actions.

== Requirements ==

* WordPress 6.2 or later.
* WooCommerce is required.
* PHP 7.4 or later.

== Installation ==

1. Install and activate WooCommerce.
2. In WordPress, go to Plugins > Add New > Upload Plugin.
3. Upload the NexaFlow Intelligence for WooCommerce ZIP file.
4. Activate the plugin.
5. Open NexaFlow Intelligence for WooCommerce in the WordPress admin and configure the available settings.
6. If analytics is enabled, configure the consent experience before collecting analytics events.

== Usage ==

After activation, open NexaFlow Intelligence for WooCommerce in wp-admin to access the available intelligence modules.

Reports use the store's WooCommerce data and the plugin's first-party analytics events where consent has been provided.

NexaFlow Intelligence for WooCommerce uses WooCommerce as the source of truth for cart and order data. The floating cart interface can use the active theme/WooCommerce cart drawer when available and provides a WooCommerce-backed fallback when a compatible native drawer opener cannot be detected.

== Privacy ==

Analytics is optional and disabled by default.

When analytics is enabled, NexaFlow Intelligence for WooCommerce asks visitors for explicit analytics consent before creating its analytics visitor cookie or recording analytics events.

Analytics data is stored in the site's WordPress database. The plugin does not send analytics data to an external analytics or AI server. The plugin does not require registration with an external analytics service.

Analytics events may include event type, product or order identifiers, pseudonymous visitor/session identifiers, device information, event value, page information and timestamps, depending on the enabled tracking features.

The plugin provides WordPress personal-data export and erasure callbacks for analytics data associated with registered WordPress users or their WooCommerce billing email where available.

For site owners, WordPress privacy tools can be used to review and manage personal data stored by the site.

== Data Retention and Uninstall ==

NexaFlow Intelligence for WooCommerce stores its analytics data in plugin-owned WordPress database tables.

Deactivating the plugin does not delete stored analytics data.

Uninstalling the plugin removes its plugin-owned analytics tables and plugin settings.

== External Services ==

NexaFlow Intelligence for WooCommerce does not require or use an external analytics, tracking or AI service to provide its core functionality.

The plugin's analytics and intelligence processing are performed locally on the WordPress site.

The plugin documentation references the GNU General Public License URL:
https://www.gnu.org/licenses/gpl-2.0.html

== Source Code ==

All JavaScript and CSS distributed with NexaFlow Intelligence for WooCommerce are shipped in human-readable source form within the plugin package.

In particular, the administrative JavaScript source is available at assets/admin-review.js, and the readable CSS sources are available in assets/.

No compiled or minified source is required to run the distributed plugin.

Development and source-file details are documented in docs/SOURCE-CODE.md.

== Quick Links ==

GitHub: https://github.com/Salauddin-Ahmed

== Support ==

For support, use the WordPress.org support forum for NexaFlow Intelligence for WooCommerce after the plugin is published.

When reporting an issue, include:

* WordPress version.
* WooCommerce version.
* PHP version.
* A description of the affected module or admin page.
* Any relevant error message or reproduction steps.

== Screenshots ==

1. NexaFlow Intelligence for WooCommerce dashboard showing sales, orders, average order value, conversion rate, sales trends, top products, customer behavior, product recommendations, abandoned cart recovery and recent orders.
2. Analytics dashboard showing visitors, sessions, page views, bounce rate, session duration, event count, traffic channels, top pages, top products and device breakdown.
3. Traffic Sources dashboard showing sessions, users, attributed revenue, conversion rate, traffic source distribution, source performance, revenue and acquisition insights.
4. Product Intelligence dashboard showing product views, add-to-cart activity, purchases, revenue, conversion rate, top products, product performance by category and product insights.
5. Checkout Intelligence dashboard showing checkout funnel performance, checkout abandonment by step, abandonment reasons, conversion trends, checkout optimizations and checkout insights.
6. Customer Journey dashboard showing customer journey starts, product views, add-to-cart activity, checkout and purchase conversion, along with journey paths, device breakdown, journey health and customer insights.
7. Site Search dashboard showing total searches, clicks, click-through rate, searches with no results and detailed search terms with search and click performance.
8. Alerts dashboard showing critical, warning and resolved alerts with alert history, severity, source, status, date and available actions.

== License ==

NexaFlow Intelligence for WooCommerce is licensed under the GNU General Public License version 2 or later.

== Changelog ==

= 1.0.3 =
* Added functional report exports for CSV, JSON and print/PDF workflows.
* Hardened analytics, customer intelligence, cohort, RFM, geography and conversion reporting for larger WooCommerce stores.
* Added performance-safe customer analytics processing and aggregation.
* Hardened admin output escaping, SQL preparation, input validation and database operations.
* Added WooCommerce HPOS compatibility declaration.
* Completed Plugin Check hardening with no errors or warnings in the final local check.
* Refined privacy-conscious first-party analytics and consent handling.
* Prepared the release documentation and metadata for WordPress.org submission.
