=== ShopAltAI ===
Contributors: shopaltai
Tags: woocommerce, alt text, product descriptions, seo
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate product listings and image alt text with ShopAltAI, without leaving wp-admin.

== Description ==

ShopAltAI is a thin API client for the ShopAltAI SaaS — no AI generation
runs inside WordPress. This plugin pulls your live WooCommerce products
and Media Library images, sends them to ShopAltAI's API for generation,
and writes the result back into WordPress only after you review and
accept it.

**Product Generator** — select WooCommerce products and generate a full
listing (title, description, SKU, price suggestion, attributes, tags,
SEO fields) from the product's existing image.

**Alt Text Generator** — select images from the Media Library and
generate accurate alt text.

Every screen is manual-trigger only — nothing is generated or written
back automatically. Generation consumes your ShopAltAI account's credit
balance (or your BYOK key, if configured on the dashboard), shown in the
plugin's admin header.

= Requirements =

* A ShopAltAI account and API key (Settings → WordPress plugin on the
  ShopAltAI dashboard).
* WooCommerce, active, for the Product Generator screen only.

= v1 scope =

* WordPress only — no other CMS.
* No webhooks or automatic generation on new content.

= External service =

This plugin is a client for ShopAltAI, a third-party AI content service
at shopaltai.com. No AI generation happens inside WordPress — the
plugin sends content to ShopAltAI's API and writes the result back into
WordPress only after you review it in the plugin's panel and click
Accept. A ShopAltAI account and API key are required; without one, the
plugin's screens load but generation is disabled.

Data is sent only when you manually click "Auto Generate" on the
Product Generator or Alt Text Generator screen, for the specific
items you've selected. Nothing is sent automatically, on a schedule,
or when content is created, edited, or saved elsewhere in WordPress.

What is sent, per generation:

* **Both generators** — the image itself. If the file is readable
  directly off local disk, its actual bytes are sent (base64-encoded);
  if not (for example, a media-offload plugin storing files on S3),
  the image's public URL is sent instead and ShopAltAI fetches it.
* **Product Generator** — additionally, the product's title and its
  WooCommerce category names, as context for the generated listing.
  The product's existing description is not sent.
* **Every request** — your ShopAltAI API key, sent as a bearer token
  to authenticate the request. It is stored in this site's WordPress
  options table and never transmitted anywhere except to
  shopaltai.com.

No data is sent to any service other than ShopAltAI's own API
(shopaltai.com). The plugin does not use any analytics, advertising,
or third-party tracking service.

Service: https://shopaltai.com
Terms of use: https://shopaltai.com/terms
Privacy policy: https://shopaltai.com/privacy

== Installation ==

1. Upload the `shopaltai` folder to `/wp-content/plugins/`, or install the
   zip via Plugins → Add New → Upload Plugin.
2. Activate the plugin.
3. Go to ShopAltAI → Settings, paste your API key, and click
   "Test connection".

== Frequently Asked Questions ==

= Do I need a paid ShopAltAI account? =

No. A free ShopAltAI account works — sign up at shopaltai.com to get an
API key, then paste it into ShopAltAI → Settings in wp-admin. Free
accounts include a limited monthly allowance; paid plans and
bring-your-own-key (BYOK) unlock higher or unlimited usage. Either way,
an account and API key are required — the plugin does nothing without
one.

= Does it work without WooCommerce? =

Yes, partially. The Alt Text Generator and Settings screens work on any
WordPress site. The Product Generator screen requires WooCommerce —
without it active, that screen shows a notice explaining this instead
of a product list, and nothing else in the plugin is affected.

= Does anything publish or generate automatically? =

No. Every generation is started manually, by clicking "Auto Generate"
on a screen after selecting specific products or images. Nothing runs
on a schedule, on content save, or via a webhook. Generated content is
shown in a review panel and is only written into WordPress after you
click Accept.

= Where does my data go? =

Only to ShopAltAI's own API at shopaltai.com — see "External service"
above for exactly what's sent and when. The plugin doesn't use any
other third-party service.

= What happens to my existing content if I don't accept a generation? =

Nothing. Generated fields are shown for review only; declining or
navigating away without clicking Accept leaves your product or image
exactly as it was.

== Screenshots ==

1. Settings screen — connect your ShopAltAI API key and test the connection.
2. Product Generator — select WooCommerce products to generate listings for.
3. Alt Text Generator — select Media Library images to generate alt text for.
4. Review panel — generated fields shown for review before you accept them.

== Changelog ==

Version numbers below start at 1.0.0 because that's when this plugin
was first built, not when it joined the WordPress.org directory —
2.3.0 was already the current version, distributed directly from
shopaltai.com, before this listing existed. Kept as-is (rather than
restarting numbering at 1.0.0 for the directory debut) so that anyone
who installed a prior direct-download build gets a proper update
through the directory instead of what WordPress would read as a
downgrade.

= 2.3.0 =
* Removed Content Generator — content generation is now web-app only,
  available at shopaltai.com. Product Generator and Alt Text Generator
  are unaffected.

= 1.0.0 =
* Initial release: Product Generator, Alt Text Generator, Content
  Generator (Pages), Settings with API key + connection test.

== Upgrade Notice ==

= 2.3.0 =
Content Generator has been removed from this plugin (it's now web-app
only at shopaltai.com). Product Generator and Alt Text Generator are
unaffected — no action needed.
