=== ShopMind AI ===
Contributors: nordicdatatools
Tags: woocommerce, ai, product descriptions, product content, openai
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 8.0
Stable tag: 1.7.9.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered product content tools for WooCommerce — generate descriptions, FAQs, product pairings, frontend recommendations, and competitor-aware pricing guidance without leaving WordPress. Uses your own API account when AI features are enabled.

== Description ==

**ShopMind AI** helps WooCommerce store owners generate and improve product content using AI — directly inside WordPress, without copying and pasting between tabs.

= What it does =

* **Generate short and long product descriptions** from your existing WooCommerce product data
* **Generate buyer FAQs** per product, saved and manageable from a central FAQ Library
* **Suggest upsell and cross-sell products** using AI — review and apply with one click from the Product Pairings queue
* **Bulk process your catalog** — run content generation across many products at once
* **FAQ block for Gutenberg** — display generated FAQs on product pages with accordion or list layout
* **Catalog health scan** — see at a glance which products are missing descriptions or FAQs
* **Frontend revenue widgets** — show recommendation blocks on single product pages and cart pages
* **Revenue Intelligence** — compare live competitor products and get AI-assisted pricing guidance

= How it works =

Open any WooCommerce product, click the ShopMind AI tab, choose tone and length, and click Generate. Review the result in the preview area, then save it to the product. No content is ever saved automatically without your approval.

= Store context and templates =

Tell the AI about your store — target audience, brand tone, claims to emphasise or avoid. Four built-in store profiles (Fashion, Electronics, Home & Interior, Sports) and four writing templates (Neutral, Swedish, Technical, Lifestyle) make it easy to get consistent results without configuring every prompt from scratch.

= Plans =

The free version includes single-product content generation with 50 AI operations per month and frontend revenue widgets. Premium plans (Pro, Business, Agency) are available at nordicdatatools.com and add bulk tools, FAQ generation, competitor-aware market intelligence, unlimited operations, and more.

= Requirements =

* WordPress 6.0 or later
* WooCommerce (active)
* PHP 8.0 or later
* An OpenAI API key (your own account)

== Installation ==

1. Upload the plugin to `/wp-content/plugins/shopmind-ai`, or install via the WordPress plugin screen.
2. Activate the plugin.
3. Make sure WooCommerce is installed and active.
4. Go to **ShopMind AI → Settings** and enter your OpenAI API key.
5. To use competitor lookups, add a SerpApi key under **Revenue & Market Intelligence**.
5. Optionally configure Store Context and a writing Template.
6. Open any WooCommerce product and click the **ShopMind AI** tab in the Product data box.

== Frequently Asked Questions ==

= Does this require WooCommerce? =
Yes. WooCommerce must be active for product features to work.

= Will the AI overwrite my existing descriptions automatically? =
No. All generated content is shown in a preview first. You choose to save or discard it.

= Does this work with the block editor (Gutenberg)? =
Yes. The FAQ block (`shopmind-ai/product-faq`) can be added to any product page to display generated FAQs. Product content generation works in the product data panel, which is available in both the classic and block editor.

= What AI provider does ShopMind AI use? =
OpenAI (Chat Completions). You need your own OpenAI API key. The plugin supports any Chat Completions-compatible model; the default is gpt-4o-mini.

= What counts as one AI operation? =
Each successful generation request (content, FAQ, or product pairing suggestions) counts as one operation. Saving, previewing, accepting, dismissing, or refreshing the license does not consume operations.

= How do upsells work? =
ShopMind AI first looks at your own WooCommerce catalog and finds likely candidate products based on categories, tags, and related catalog context. It then asks the AI to rank those candidates as upsells or cross-sells. Nothing is applied automatically: suggestions are stored for review, and accepted items are written to WooCommerce upsell or cross-sell fields.

= Is my product data sent anywhere other than OpenAI? =
Product data is sent only to OpenAI to generate content. License validation sends your license key and site URL to the NordicDataTools license server. No other data leaves your site.

= Where do I get a premium license? =
At https://nordicdatatools.com/shopmind-ai

== Screenshots ==

1. ShopMind AI tab in the WooCommerce product editor — generate, preview, and save descriptions
2. Dashboard showing catalog health and quick actions
3. Bulk Tools — process multiple products with a live progress bar
4. FAQ Library — review, publish, and manage all generated FAQs
5. Product Pairings — AI-suggested related products pending admin review
6. Templates & Prompts — configure writing rules injected into every AI request
7. Store Context Profiles — multiple brand/audience profiles for Business plan users
8. License page — plan status, feature access matrix

== Changelog ==

= 1.7.9.1 =
* Added onboarding panels on Dashboard, Settings, and Help & Guidance.
* Added placeholders and inline help text for Store Context settings fields.
* Improved first-run setup copy to make configuration clearer and more guided.


= 1.7.8.1 =
* Softened dashboard and insight typography for a more premium admin feel.
* Reworked Revenue Insight summary styling to remove misleading pink success treatment.
* Improved Revenue Intelligence and Help screens with clearer quick-start guidance.
* Synced plugin version and stable tag metadata for release consistency.

= 1.7.7 =
* Added Promotion Intelligence page with campaign guidance, safe markdown hints, protection signals, and category-level promotion opportunities.
* Added optional promotion decision support setting under Revenue & Market Intelligence.
* Added promotion action queue with promote-now, protect, improve-then-promote, push-hero, and price-correction recommendations.

= 1.7.6 =
* Added Inventory Intelligence page with stock-aware action queue and catalog-level inventory signals.
* Added optional inventory-aware decision support setting and inventory note inside Revenue Intelligence.

= 1.7.3.1 =
* Fixed Cost & Margin preview spinner not clearing reliably.
* Fixed Apply suggested price button visibility after a successful preview.
* Persist cost-input values during preview/apply so they stick before full product save.

* Fixed cost & margin field persistence and added economics preview / apply-price workflow.

= 1.7.2 =
* Added Profit-safe Automation with optional Smart Actions, safe price guardrails, scheduled runs, and automation summaries.


= 1.6.0.2 =
* Added active upsell and cross-sell preview inside the product editor panel.
* Added clearer upsell and cross-sell placement guidance in Help & Guidance and Product Pairings.
* Added placement column to Product Pairings so merchants can understand where accepted suggestions are typically shown.

= 1.6.0.1 =
* Improved Help section with clearer setup, product pairing, and revenue guidance
* Renamed upsell review area to Product Pairings for clearer terminology
* Improved product panel guidance for upsell and cross-sell workflow

= 1.6.0 =
* Added frontend single-product recommendations and cart upsell widgets.
* Added Revenue Intelligence page with live competitor lookup via SerpApi Google Shopping.
* Added AI-assisted pricing guidance with cached market snapshots.
* Added revenue and market settings for storefront widgets and competitor research.


= 1.5.0 =
* Added: AccessiMind AI integration layer — product health strip with content and accessibility scores in the WooCommerce product panel.
* Added: Generate accessibility package button (language + preset) — visible when AccessiMind AI is active.
* Added: SMAI_Health class for combined content/accessibility product health payloads.
* Added: SMAI_Integrations — registers ShopMind availability filter and boots AccessiMind bridge conditionally.
* Added: SMAI_Accessibility_Bridge — loose coupling to AccessiMind AI via WordPress filters.
* Added: REST endpoint shopmind/v1/product-health/{id} for external health data reads.
* Added: execute_task() method on SMAI_AI_Manager as groundwork for shared AI task contract.


= 1.4.0 =
* New: FAQ Gutenberg block (`shopmind-ai/product-faq`) — display generated FAQs on product pages with accordion or list layout, configurable via block inspector.
* New: Catalog Health Scanner — daily scheduled scan shows % of products with descriptions and FAQs. Dashboard cards now use cached data for fast page loads.
* New: Dashboard "Scan now" quick action to trigger an on-demand scan.
* Fix: Spinners now show only while AI is working and are hidden immediately on completion.
* Fix: License page — removed confusing "API request allowance" row. Replaced with correct "AI operations / month" (Unlimited for Pro+, 50/month counter for Free).
* Fix: Bulk FAQ generation — resolved JSON parsing issue that prevented FAQs from saving. Parser now handles all response shapes from OpenAI.
* Fix: Upsell suggestion parser made equally robust.
* Improved: Store Context Profiles now include 6 built-in example profiles: Fashion/Scandinavian, Electronics/Tech, Home & interior, Sports & outdoor, Beauty & skincare, B2B/Industrial. All can be cloned and customised.
* WordPress.org: readme.txt rewritten with full description, screenshots list, and accurate FAQ section.

= 1.3.1 =
* Fix: Bulk FAQ generation JSON parsing issue.
* New: 6 built-in store context example profiles.

= 1.3.0 =
* New: Plugin Updater via NDT License Manager.
* New: Templates & Prompts page with 4 built-in starter templates.
* New: Log filters and CSV export.
* Improved: Product panel moved to WooCommerce product data tab.
* Fix: License status color (Active = green, invalid = red, network error = yellow).

= 1.2.2 =
* Fix: License validation reads correct flat NDT LM response fields.

= 1.2.0 =
* New: Smart Upsell / Cross-sell Suggestion Engine.
* New: NDT License Manager v2 integration.
* New: Store Context Profiles (Business+).
* New: FAQ Shortcode [shopmind_faq].
* Improved: Dashboard with catalog statistics.

= 1.1.0 =
* New: Bulk Tools with live progress bar.
* New: FAQ Generator and FAQ Library.
* Fix: Save now correctly updates WooCommerce product fields.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.4.0 =
Deactivate and reactivate to register the FAQ Gutenberg block and schedule the catalog scanner. Existing installations are not affected.
