=== AI Flash Tune ===
Contributors: rbill
Tags: woocommerce, funnel, conversion optimization, analytics, ai, cart abandonment, marketing, woocommerce analytics
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A WordPress plugin to turn WooCommerce drop-offs into conversions with AI-powered funnel analysis and optimization.

== Description ==

Stop guessing why your customers are leaving and start getting actionable insights. AI Flash Tune is an AI-powered tool for WooCommerce that automatically maps your sales funnel, identifies the exact points where users are dropping off, and helps you understand the "why" behind their actions.

The free version provides powerful detection and tracking tools to show you *what* is happening in your store.

**Key Features (Free Version):**

* **Basic Funnel Flow Visualization:** Automatically maps your standard WooCommerce funnel from Landing Page → Product Interest → Cart → Checkout to visualize the user journey.
* **Top Drop-Off Detection:** Pinpoints the precise stage in your funnel where most users abandon their journey, showing you where to focus your efforts.
* **Behavioral Pattern Analyzer:** Detects critical user frustration signals like **rage clicks**, **quick bounces**, and **scroll stops** to help explain *why* users might be leaving.
* **Abandoned Cart Tracker:** See a list of abandoned carts, including the products left behind and the total potential revenue lost.
* **Low-Performing Product Finder:** Flags products that get a lot of traffic but have little to no sales, helping you identify optimization opportunities.
* **Checkout Field Overload Detector:** Analyzes your checkout form and warns you if you have too many fields, which is a common cause of high friction and abandonment.
* **Page Speed Alerts:** Monitors the performance of key funnel pages and alerts you if they are loading slower than the recommended threshold.
* **Visual Noise Checker (Lite):** Scans your product pages for an excessive number of competing buttons or images that could distract users from the main "Add to Cart" action.

== External Services ==

This plugin relies on the **OpenAI API** to generate intelligent insights, analyze your funnel data, and provide optimization suggestions.

* **Service:** OpenAI API (GPT models)
* **Used For:** Analyzing store performance metrics to generate reports, suggestions, and answer user questions about the data.
* **Data Sent:** When you request an analysis, the plugin sends anonymized, aggregated funnel statistics (e.g., total visits, conversion rates) and any text prompts you enter. No personally identifiable information (PII) regarding your customers is sent to OpenAI.
* **Privacy Policy:** [OpenAI Privacy Policy](https://openai.com/policies/privacy-policy)
* **Terms of Service:** [OpenAI Terms of Use](https://openai.com/policies/terms-of-use)

== Copyright ==

AI Flash Tune uses the following third-party resources:

* Flatpickr (js/flatpickr.min.js, css/flatpickr.min.css)
  Source: https://flatpickr.js.org/
  License: MIT

* Font Awesome Free (css/all.min.css, webfonts/*)
  Source: https://fontawesome.com/
  License: CC BY 4.0 License (Icons), MIT License (Code), SIL OFL 1.1 (Fonts)
  
== Installation ==

1.  Upload the `ai-flash-tune` plugin folder to the `/wp-content/plugins/` directory.
2.  Activate the plugin through the 'Plugins' menu in WordPress.
3.  Navigate to the new "AI Flash Tune" menu in your WordPress dashboard to view your analytics.

== Frequently Asked Questions ==

= Does this plugin work with any theme? =

Yes, AI Flash Tune is designed to work with any theme that follows standard WooCommerce hooks and page structure.

= Will this slow down my website? =

We have built the plugin with performance as a top priority. The frontend tracking script is lightweight and loads asynchronously, so it won't affect your site's perceived loading speed for customers. All heavy data analysis happens within your WordPress admin area.

= Do I need an OpenAI API key for the free version? =

No. The limited weekly insight report in the free version is generated without needing your own API key. An API key is only required for the advanced, on-demand AI features.

== Screenshots ==

1.  The main Dashboard, giving you a bird's-eye view of your funnel performance.
2.  The detailed Funnel Analysis page, visualizing each step of the user journey.
3.  The Product Performance table, highlighting low-performing products that need attention.
4.  The Abandoned Carts tracker, showing lost revenue opportunities.
5.  The clean and organized Settings page for configuring the plugin.

== Changelog ==

= 1.0.0 =
* Initial public release.
* Implemented core funnel analysis and drop-off detection.
* Added behavioral tracking for rage clicks, quick bounces, and scroll stops.
* Integrated basic abandoned cart tracking.
