=== VoxFill — AI Voice Descriptions for WooCommerce ===
Contributors:      apqrinu, omarabdayem
Tags:              woocommerce, ai, voice, product-description, chatgpt
Requires at least: 6.0
Tested up to:      7.0
Requires PHP:      7.4
Stable tag:        1.0.0
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Speak about your product; VoxFill transcribes and auto-fills titles, descriptions, features, SEO meta, and tags.

== Description ==

VoxFill adds a voice-recording toolbar to the WooCommerce product editor. Speak naturally about your product; the plugin transcribes the audio, sends the transcript to your chosen AI provider (Anthropic Claude, OpenAI, or Groq), and fills in:

* Product title
* Short description
* Full description
* Key features list
* SEO meta description (Yoast SEO, RankMath, or AIOSEO)
* Product tags

You bring your own API key from Anthropic, OpenAI, or Groq. Groq offers a generous free tier — no credit card needed to start. There is no premium tier and no usage limit imposed by VoxFill — only a self-managed daily budget you can configure or disable.

= Why VoxFill =

* **Native WooCommerce workflow.** The toolbar lives inside the product editor meta box. Click record, talk, generate — fields fill in instantly.
* **Bring your own key.** Pay your AI provider directly. No middlemen, no markup.
* **Multilingual.** Speak in any of 10 supported languages, including Arabic and English. The transcript is sent to the AI in the same language as your store.
* **Free in-browser transcription.** Uses the built-in Web Speech API in Chrome, Edge, and Safari — no extra account, no extra API calls.
* **No tracking.** Nothing is transmitted until you click Generate. No analytics, no pixels, no offloaded assets.

= How it works =

1. Install VoxFill and activate it. Open VoxFill Settings under WooCommerce.
2. Paste your Anthropic or OpenAI API key. Pick a tone, language, and which fields to fill.
3. Open any product. The VoxFill toolbar sits inside the product editor. Click the microphone, describe your product, and click Generate.
4. Review the AI-generated copy and publish.

= AI disclaimer =

AI-generated content may require editing. VoxFill does not guarantee accuracy, uniqueness, or legal compliance of generated text. Always review output before publishing.

== Installation ==

1. Upload the plugin to `wp-content/plugins/voxfill/`, or install from the WordPress plugin directory.
2. Activate VoxFill through the **Plugins** menu in WordPress.
3. Go to **WooCommerce → VoxFill** and add your Anthropic, OpenAI, or Groq API key.
4. Open any product. The VoxFill toolbar appears inside the product editor.

== Frequently Asked Questions ==

= Do I need a paid plan? =

No. VoxFill is free and fully open-source. You pay your chosen AI provider directly. The daily limit in settings is a self-managed budget to help you control your own costs — it can be set to 0 (unlimited).

= Which AI providers are supported? =

Anthropic Claude, OpenAI, and Groq. Choose one in Settings and paste the matching API key. Groq offers a free tier with generous rate limits — get a key at console.groq.com/keys without a credit card. Groq runs open-source models (Llama 3.x, GPT-OSS) on fast inference hardware.

= Does it work with the Block Editor? =

Yes. VoxFill writes into both the Classic Editor (TinyMCE) and the Block Editor (Gutenberg) automatically.

= Does it integrate with my SEO plugin? =

Yes. The SEO meta description is written into Yoast SEO, RankMath, or All in One SEO when one of them is active.

= Is my API key safe? =

Your API key is stored in your own WordPress database (`wp_options`) just like keys for WooCommerce or Yoast. It is sent only to the provider you select (Anthropic, OpenAI, or Groq) when you click Generate.

= What languages are supported? =

English, Arabic, Spanish, French, German, Italian, Portuguese, Dutch, Japanese, and Chinese. More can be added by filtering `voxfill_ai_prompt`.

= Is it compatible with WPML and Polylang? =

Yes. The plugin ships a `wpml-config.xml` so WPML's String Translation picks up the brand context automatically. For Polylang, the brand context is registered with `pll_register_string()` as soon as you save a value. A `voxfill_brand_context` filter is also exposed for custom multilingual setups.

= Does the plugin send data automatically? =

No. Data is transmitted to the AI provider only when you explicitly click the Generate button. Nothing is sent on activation, on page load, or via background events.

= How do I uninstall? =

Deactivate, then delete. If you enabled "Delete data on uninstall" in Settings, all VoxFill options and counters are removed. Otherwise your saved API key and preferences remain so you can reinstall later without re-entering them.

== Third-Party Services ==

This plugin connects to the following external services to generate product descriptions.
Data is only sent when a logged-in user with edit_products capability clicks
"Generate Description" in the product editor.

= Anthropic Claude =
* Purpose: AI-powered product description generation
* Data sent: the product transcript you record or type (plain text, no personal data)
* Service terms: https://www.anthropic.com/legal/commercial-terms
* Privacy policy: https://www.anthropic.com/legal/privacy

= OpenAI =
* Purpose: AI-powered product description generation (optional, selected in settings)
* Data sent: the product transcript you record or type (plain text, no personal data)
* Service terms: https://openai.com/policies/usage-policies
* Privacy policy: https://openai.com/policies/privacy-policy

= Groq =
* Purpose: AI-powered product description generation (optional, selected in settings)
* Data sent: the product transcript you record or type (plain text, no personal data)
* Service terms: https://groq.com/terms-of-use/
* Privacy policy: https://groq.com/privacy-policy/
* Note: Groq runs open-source models (Llama 3.x, GPT-OSS) and offers a free developer tier. Review Groq's terms regarding data handling on the free tier before sending product copy.

No data is transmitted on plugin activation, page load, or at any time other than
when you explicitly click the Generate button. Speech-to-text runs locally in the
browser using the Web Speech API — audio never leaves the device. Your API key is
stored in your own WordPress database and is never transmitted to any party other
than the selected provider.

== Screenshots ==

1. The VoxFill toolbar inside the WooCommerce product editor — mic button, waveform, transcript, and Generate.
2. Generated copy appearing in the product fields (title, short description, full description, tags).
3. The VoxFill settings page under WooCommerce — provider, API key, tone, language, fields to fill.

== Changelog ==

= 1.0.0 =
* Initial release.
* Voice-to-text via the browser's Web Speech API (Chrome, Edge, Safari) — audio never leaves the device.
* AI generation via Anthropic Claude, OpenAI, or Groq (free developer tier with Llama 3.x and GPT-OSS models).
* Writes to product title, short description, full description, key features, SEO meta (Yoast SEO, RankMath, AIOSEO), and product tags.
* WPML and Polylang support via `wpml-config.xml` and the `voxfill_brand_context` filter.
* Self-managed daily generation budget (configurable, can be set to 0 for unlimited).
* Suggested privacy policy text registered via `wp_add_privacy_policy_content()`.

== Upgrade Notice ==

= 1.0.0 =
First public release.
