=== AI Flash Tune – WooCommerce Sales Leak Detector & Conversion Assistant ===
Contributors: rbill
Tags: woocommerce, conversion optimization, funnel analytics, abandoned cart, ai
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find WooCommerce sales leaks, understand funnel drop-offs, and get safer conversion guidance with local insights plus optional AI.

== Description ==

AI Flash Tune helps WooCommerce store owners understand where shoppers are leaving, what needs attention first, and which conversion changes should be reviewed carefully before being applied.

Most WooCommerce stores can see orders, revenue, and abandoned carts. The harder question is what those numbers actually mean.

AI Flash Tune looks at practical store signals such as product views, add-to-cart activity, checkout starts, purchases, abandoned carts, checkout friction, product performance, tracking health, and page-speed warnings. It then turns those signals into clear, confidence-aware guidance.

The core plugin works with local store data. Optional AI modes can add deeper explanations and action plans through OpenAI or Zywrap when the site owner enables and configures them.

AI Flash Tune is built around one principle:

*Do not guess. Use store signals. Show confidence. Recommend safe, reversible improvements.*

= What AI Flash Tune helps you answer =

* Where are shoppers dropping off?
* Which products get attention but do not convert?
* Which products are most often abandoned?
* Is checkout creating unnecessary friction?
* Is tracking working correctly?
* Is there enough data to trust the insight?
* What should be checked first?
* What should not be changed yet?
* Which improvements should be reviewed before applying?

= Built for practical WooCommerce decisions =

AI Flash Tune is useful for:

* WooCommerce store owners
* WordPress agencies
* Ecommerce teams
* Digital product sellers
* Plugin and theme shops
* Small and growing online stores
* Teams that want plain-language conversion guidance without complex analytics setup

It is not only an analytics dashboard. It is a sales-leak detector, tracking-health checker, product-performance reviewer, checkout-friction scanner, abandoned-cart visibility tool, and optional AI conversion assistant.

== Core Features ==

= Dashboard Overview =

The dashboard gives a quick view of the store's current conversion health, recent funnel activity, tracking status, product signals, abandoned-cart signals, checkout drop-off, page-speed warnings, and the next checks that deserve attention.

Instead of overwhelming store owners with raw analytics only, the dashboard focuses on what can be reviewed next.

= Store Health Score =

AI Flash Tune summarizes key store signals into a store-health view covering funnel, product, cart, checkout, tracking, and performance indicators.

When there is not enough reliable activity yet, the plugin shows a waiting-for-data or low-confidence state instead of presenting unsupported scores.

= Data Confidence =

Not every signal deserves the same level of trust.

AI Flash Tune highlights whether the current data is early, limited, directional, or more reliable. This helps store owners avoid changing product pages, checkout settings, recovery emails, pricing, or offers too quickly.

Examples of confidence states include:

* Waiting for data
* Low confidence
* Medium confidence
* High confidence

= What to Check First =

AI Flash Tune prioritizes practical next checks so the store owner does not have to guess where to start.

Examples include:

* Confirm product tracking is working
* Review product views without cart adds
* Review checkout starts without purchases
* Check checkout field count
* Review abandoned products
* Check slow key funnel pages
* Confirm purchase tracking after test orders

= Tracking Health =

Reliable conversion guidance starts with reliable tracking.

AI Flash Tune helps verify important tracking and system signals such as:

* WooCommerce active
* Tracking enabled
* Funnel table available
* Behavior table available
* Recent events found
* Product events found
* Cart events found
* Checkout events found
* Purchase events found

= Funnel Analysis =

Track the standard WooCommerce shopping journey:

* Landing / store entry
* Product interest
* Added to cart
* Cart activity
* Checkout page
* Purchase complete

The funnel view helps identify the biggest visible drop-off point before changing checkout, product copy, offers, recovery emails, or store layout.

= Product Performance =

Review product-level performance signals such as:

* Product views
* Add-to-cart activity
* Sales
* Conversion rate
* Product status
* Data readiness

Products with limited activity are marked carefully instead of being judged too early.

= Product Detail Analysis =

Product detail screens help review individual product behavior more clearly.

Depending on available data and installed modules, product detail analysis can include:

* Product-level metrics
* Product funnel flow
* Device breakdown
* Visual noise checks
* Behavior signals
* Product Optimizer connection
* Product copy review guidance
* Product copy revision history where supported

= Product Optimizer =

The Product Optimizer helps review weak product pages, diagnose missing product information, and generate safer product-copy guidance from confirmed product facts.

It is designed to avoid invented claims. When product data is incomplete, the plugin highlights what should be confirmed before applying copy changes.

Useful checks can include:

* Offer clarity
* Benefit clarity
* Product description quality
* Call-to-action strength
* Decision-supporting details
* Missing objections or trust signals
* Product copy changes that should be reviewed before applying

= Abandoned Cart Visibility =

AI Flash Tune helps store owners understand cart abandonment signals.

Depending on available data and installed modules, abandoned-cart views can include:

* Total abandoned carts
* Estimated lost revenue
* Customer type
* Products left behind
* Top abandoned products
* Cart contents
* Recovery readiness
* Restore-link checks
* Recovery email safety checks

= Cart Recovery & Abandonment Intelligence =

Cart Recovery & Abandonment Intelligence helps review abandoned carts and plan safer recovery actions.

The goal is to confirm recovery plumbing before changing discounts, urgency, or email copy.

Useful checks can include:

* Whether recovery tokens are being created
* Whether cart restore links work
* Which products are commonly abandoned
* Whether recovery emails are safe to send
* Which recovery messages need review
* Whether recovery metrics update after successful orders

= Checkout Optimizer =

Checkout Optimizer helps review possible checkout friction.

Depending on available data and installed modules, checkout checks can include:

* Visible checkout field count
* Field overload warnings
* Guest checkout checks
* Payment clarity
* Shipping clarity
* Reassurance text opportunities
* Safe checkout improvement suggestions

Recommendations are intended to be reviewed first, applied one at a time, and measured before making more changes.

= Checkout Field Detector =

AI Flash Tune can detect visible checkout fields and highlight possible friction caused by long or confusing checkout forms.

This helps store owners review checkout complexity without immediately changing checkout behavior.

= Alert Center =

Alert Center scans local conversion signals for important risks and opportunities.

Examples include:

* Checkout friction
* Cart recovery opportunity
* Slow key pages
* Product performance issues
* Tracking issues
* Low-confidence warnings
* Funnel drop-off signals

Alert Center can use local stored data and does not require an external AI request.

= Advanced Segmentation =

Advanced Segmentation helps compare aggregate behavior by segment, such as desktop versus mobile or other available store segments.

The plugin is designed to avoid strong segment recommendations when a segment does not have enough data.

= Reports & Exports =

Reports help store owners, teams, and agencies review store performance in a cleaner format.

Depending on installed modules, reports can include:

* Funnel summaries
* Product performance summaries
* Checkout friction summaries
* Abandoned-cart summaries
* Store health summaries
* AI-generated action plans
* CSV exports for QA evidence

Exports are designed to focus on local funnel and performance data and avoid customer contact details.

= Page Speed Alerts =

AI Flash Tune can highlight slow key funnel pages where available.

Slow product, cart, checkout, or landing pages can affect conversion. Page-speed alerts help store owners decide which pages deserve review.

= Privacy Tools =

AI Flash Tune includes privacy-focused settings and tools such as:

* IP anonymization
* Data retention controls
* Delete data on uninstall option
* Excluded roles
* Excluded IPs
* Privacy export support
* Privacy deletion support

= Help & QA Center =

The built-in Help & QA Center helps verify whether important plugin areas are working correctly.

It can help review:

* Tracking status
* Purchase/conversion indicators
* Cart recovery readiness
* AI registry status
* AI usage logs
* System health
* Developer QA checks

== Optional AI Modes ==

AI Flash Tune supports local insights and optional external AI modes where available.

= Local Mode =

Local Mode uses private, rule-based insights from data stored on the site.

No OpenAI or Zywrap request is made in Local Mode.

This keeps the base plugin useful even when the store owner does not want to connect an external AI provider.

= OpenAI Mode =

OpenAI Mode uses the site owner's configured OpenAI API key to generate AI explanations, summaries, and recommendations from sanitized store signals.

OpenAI Mode can help with:

* Funnel explanations
* Store action plans
* Product diagnosis
* Checkout analysis
* Cart recovery guidance
* Weekly summaries
* Conversion alert prioritization

= Zywrap Mode =

Zywrap Mode uses configured Zywrap access and predefined Zywrap wrappers to generate structured WooCommerce conversion guidance from sanitized aggregate store signals.

Zywrap Mode can help with:

* Next-best-action prioritization
* Product copy conversion optimization
* Checkout friction audits
* Cart recovery sequence planning
* Abandoned cart reason analysis
* Store performance summaries
* Structured ecommerce conversion reports

Zywrap requests include the selected AI response language when configured.

== AI Response Language ==

AI Flash Tune includes an AI Response Language setting for OpenAI and Zywrap output.

By default, AI response language can follow the WordPress/admin language. Store owners can choose a specific response language in settings when they want reports, summaries, and AI guidance in another language.

Product names, metrics, URLs, code values, WooCommerce paths, and admin screen names should remain unchanged where appropriate.

== Addons ==

The AI Flash Tune base plugin can be extended with optional addon modules.

Available addon areas include:

* AI Action Center
* Product Optimizer
* Cart Recovery & Abandonment Intelligence
* Checkout Optimizer
* Advanced Segmentation
* Alert Center
* Reports & Exports

Addons require the AI Flash Tune base plugin. Some addon features may require a valid license or plan.

== Privacy and Data Safety ==

AI Flash Tune is designed to use local and aggregate store signals wherever possible.

Before external AI calls, payloads are intended to be sanitized and limited to the information needed for the selected AI action.

Examples of data that can be used for AI guidance:

* Total sessions
* Product views
* Cart count
* Checkout count
* Purchase count
* Abandoned cart count
* Checkout field count
* Page-speed signals
* Product performance summary
* Anonymous segment comparison
* Store configuration signals relevant to the selected action

Examples of data that should not be sent to AI providers by default:

* Customer names
* Customer emails
* Phone numbers
* Billing addresses
* Shipping addresses
* IP addresses
* Payment details
* Private order notes
* Passwords
* Tokens
* API keys
* Unnecessary personal data

AI Flash Tune recommendations should be reviewed before applying changes.

Checkout settings, product copy, recovery emails, pricing, payment providers, shipping promises, discounts, trust badges, urgency tactics, and other conversion-sensitive changes should not be changed unless the store owner has reviewed the recommendation and the available data supports that action.

== External Services ==

AI Flash Tune can connect to external AI services only when configured and enabled by the site owner.

If external AI features are not configured, local insights can continue to work without OpenAI or Zywrap.

= OpenAI =

OpenAI Mode may send sanitized store signals and prompt context to OpenAI's API for AI-generated explanations, summaries, and recommendations.

Used for features such as:

* Funnel explanations
* Action plans
* Product diagnosis
* Checkout analysis
* Cart recovery guidance
* Weekly summaries
* AI report generation

Data sent may include:

* Sanitized store metrics
* Aggregate funnel, product, cart, checkout, and performance signals
* Selected report/action context
* User-provided prompt/context if the user enters one

OpenAI terms and privacy information:

* https://openai.com/policies/
* https://openai.com/policies/privacy-policy/

= Zywrap =

Zywrap Mode may send sanitized store signals, wrapper codes, selected language, structured variables, and optional user-provided prompt context to the Zywrap proxy endpoint.

Used for predefined AI Flash Tune ecommerce conversion workflows such as:

* Next-best-action prioritization
* Product copy optimization
* Checkout friction audit
* Cart recovery sequence planning
* Abandoned cart reason analysis
* Store performance summaries
* Structured ecommerce conversion guidance

Data sent may include:

* Sanitized store metrics
* Aggregate funnel, product, cart, checkout, and performance signals
* Selected wrapper/action payload
* Selected AI response language
* Structured variables required for the selected action
* User-provided prompt/context if the user enters one

Zywrap service information:

* Website: https://www.zywrap.com
* Terms: https://www.zywrap.com/terms
* Privacy: https://www.zywrap.com/privacy

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate AI Flash Tune from the WordPress Plugins screen.
3. Make sure WooCommerce is installed and active.
4. Open `AI Flash Tune > Dashboard`.
5. Confirm tracking status.
6. Visit the store as a non-admin visitor to generate test activity.
7. Refresh the dashboard and reports.

== First-Time Setup Checklist ==

After activation, check:

* WooCommerce is active.
* Tracking is enabled.
* Admin and shop manager traffic is excluded where needed.
* Product page tracking works.
* Add-to-cart tracking works.
* Cart and checkout events are recorded.
* Purchase tracking works after a test order.
* Abandoned carts are detected only when a cart is left without purchase.
* Privacy settings match the store owner's requirements.
* Data retention is configured.
* AI mode is selected only if AI features will be used.
* AI response language is configured if needed.

== Testing Tracking ==

To test tracking:

1. Open the store in an incognito/private browser window.
2. Visit a product page.
3. Add a product to cart.
4. Visit the cart page.
5. Visit checkout.
6. Place a test order using a test payment method.
7. Return to AI Flash Tune and refresh the dashboard.

Expected result:

* Product view is tracked.
* Add-to-cart event is tracked.
* Cart state is tracked.
* Checkout start is tracked.
* Purchase is tracked.
* Conversion rate updates.
* Product sales data updates after completed purchase tracking.
* Abandoned carts appear only when carts are left without purchase.

== Recommended Review Workflow ==

AI Flash Tune is designed to support safer conversion work.

A good workflow is:

1. Confirm tracking health.
2. Wait for enough data.
3. Review the biggest funnel leak.
4. Check product and checkout context.
5. Use local or AI guidance to understand possible causes.
6. Apply one reviewed change at a time.
7. Measure the result before making another change.

This helps reduce random conversion changes and makes store optimization easier to explain to clients, teams, or stakeholders.

== Frequently Asked Questions ==

= Is AI Flash Tune only an AI plugin? =

No. AI Flash Tune is a WooCommerce conversion and sales-leak tool first. Local insights and tracking can work without external AI.

= Does it require OpenAI? =

No. OpenAI is optional. OpenAI Mode is only used when the site owner configures and enables it.

= Does it require Zywrap? =

No. Zywrap is optional. Zywrap Mode is only used when configured and enabled.

= What does "low confidence" mean? =

It means the store does not yet have enough data for strong conclusions. The plugin may still show directional guidance, but the store owner should review and measure carefully.

= What does "Needs Data" mean? =

It means the product, funnel step, or report area does not have enough tracked activity yet for reliable analysis.

= Why does the plugin say to review before acting? =

Conversion changes can affect revenue. AI Flash Tune encourages safe, reversible changes and recommends measuring results before making more changes.

= Does AI Flash Tune send customer contact data to AI providers? =

AI Flash Tune is designed to use sanitized aggregate store signals for AI features and avoid sending customer contact data by default. Site owners should review AI settings, provider settings, and consent requirements before enabling external AI providers.

= Will this slow my store? =

AI Flash Tune is designed to keep frontend tracking lightweight. Heavier reporting and analysis should run in admin views, cached summaries, or scheduled tasks where possible.

= Can agencies use AI Flash Tune? =

Yes. Agencies can use it to review store health, funnel issues, checkout friction, abandoned carts, product opportunities, tracking quality, and client-facing reports.

= Can AI Flash Tune apply changes automatically? =

AI Flash Tune is designed around review-first optimization. Addon features may support controlled workflows, but conversion-sensitive changes should be reviewed before being applied.

= Can I use it without external AI? =

Yes. Local Mode and local tracking can provide useful store signals without connecting OpenAI or Zywrap.

== Upgrade Notice ==

= 1.0.1 =

Includes the 1.0.1 database upgrade path, improved reporting and sales counting, AI response language support, Zywrap language parameter support, improved AI output rendering, translation loading improvements, and safer privacy guidance.

== Changelog ==

= 1.0.1 =
* Added missing behavior-data page URL support used by frontend behavior tracking.
* Creates or upgrades plugin-owned AI usage, AI report, license activation, change log, product revision, and A/B test tables during update where applicable.
* Improved dashboard, funnel, product, cart, checkout, alert, segmentation, and report screens.
* Improved provider-safe AI behavior for local, OpenAI, and Zywrap modes.
* Added AI response language setting.
* Improved report metrics and sales counting from funnel and order data.
* Improved privacy and review-before-acting guidance.
* Improved cleanup of plugin-owned tables and options on uninstall when data deletion is enabled.

= 1.0.0 =
* Initial release foundation.
* WooCommerce funnel tracking.
* Product performance reporting.
* Abandoned cart tracking.
* Checkout field detector.
* Store health and data confidence.
* Tracking health and local insights.
* Optional AI action architecture.
* Privacy and QA tools.
