=== AltoScribe – AI Product Descriptions for WooCommerce ===
Contributors: reallyusefulappco
Tags: woocommerce, product descriptions, ai, ecommerce, seo
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Write accurate WooCommerce product descriptions with AI. No API key, we host the AI. Review before saving; existing copy is never overwritten.

== Description ==

**No API key. No account. No setup.** Unlike almost every other AI product-description plugin, which makes you sign up for OpenAI or Anthropic and paste in your own paid API key, AltoScribe runs the AI on our hosted service. Activate the plugin and it just works, with 10 free descriptions every month. Paid plans add higher monthly allowances for larger catalogues, plus one-off credit top-ups for big imports.

AltoScribe reads a product's own **name, attributes and categories** and writes a short description plus a long description for it. You **review and edit before anything is saved**, and AltoScribe **never overwrites an existing description unless you tick "Replace"** so it is safe to run across a live store.

Do one product from the product editor, or generate for **many products at once** from the bulk screen: filter by category, stock status, or "missing description only", generate to a staging area, then accept, skip or edit each result. A big run can be paused and resumed.

* No API key or third-party account. The AI runs on our service.
* One click to generate a short and long description from the product editor.
* Bulk generation with a filtered, resumable queue and a review grid.
* Review, edit and accept before anything is written to the product.
* Never overwrites existing copy unless you ask, and one-click undo of the last apply.
* Tone and length presets, plus optional keywords to weave in.
* Privacy-friendly: only the product's name, attributes and categories (plus a non-identifying, hashed site ID) are ever sent.
* 10 free descriptions every month; paid plans add higher monthly allowances, plus credit top-ups for big imports.

**AI-generated content can be inaccurate.** AltoScribe writes from the product's own name, attributes and categories, and shows you every description to review before it is saved. Always check descriptions for accuracy before publishing.

== External services ==

This plugin connects to the **Really Useful App Company API** to generate product descriptions. It is required for the plugin's core feature.

* **What is sent and when:** when you click "Generate description" on a product, or run a bulk generation, the plugin sends the **product name**, its **attributes** and its **categories** to the API. A non-identifying **site ID** (a hash of your site URL) is sent for usage counting.
* **Where it goes:** the API (default `https://api.thereallyusefulappcompany.com`), which uses **Anthropic** as an AI subprocessor to generate the text.
* **Terms / privacy:** https://www.thereallyusefulappcompany.com/altoscribe/terms , https://www.thereallyusefulappcompany.com/altoscribe/privacy , https://www.anthropic.com/legal/privacy

No data is sent until you click generate or run a bulk generation.

== Installation ==

1. Install and activate AltoScribe. WooCommerce must be installed and active.
2. Go to **Settings → AltoScribe**, review the external-service notice, and set your default tone, length and keywords.
3. Edit a product and click **Generate description** in the AltoScribe box, review it, then click **Apply to product**.
4. For many products at once, go to **Products → AltoScribe Bulk**.
5. (Optional) Enter a paid-plan licence key to raise your monthly allowance.

== Frequently Asked Questions ==

= Do I need an AI API key? =
No. The AI runs on our service. There is nothing to sign up for and no key to paste in.

= Is it free? =
You get 10 free descriptions every month. Paid plans add higher monthly allowances for larger catalogues, plus one-off credit top-ups for big one-time imports.

= Will it overwrite my existing descriptions? =
No. AltoScribe never overwrites a description that already has content unless you tick "Replace existing". You can also undo the last apply.

= Does it change my products automatically? =
No. Every description is shown to you to review and edit, and nothing is written to a product until you accept it.

= Does it work with my product attributes? =
Yes. AltoScribe reads the product's name, its WooCommerce attributes and its categories, and writes from those facts.

= What does it send? =
Only the product's name, attributes and categories, plus a non-identifying hashed site ID for usage counting. See the External Services section.

== Screenshots ==

1. The AltoScribe box on a product: generate a short and long description, choose tone and length, review and edit, then apply. Existing copy is never overwritten unless you ask.
2. The bulk screen: filter your catalogue, generate descriptions for many products at once, and accept, skip or edit each result in the review grid.

== Changelog ==

= 1.0.1 =
* Added a usage panel on the settings screen showing your monthly allowance, any credits, and a quick link to upgrade.
* Added an optional, dismissible prompt inviting an honest review after you've generated a few times. No tracking; dismiss any time.

= 1.0.0 =
* Initial release: single-product and bulk AI product descriptions, review-before-save with never-overwrite and undo, tone/length presets and keywords, hosted AI with no API key.
