=== ALTification: AI Alt Text for SEO & Accessibility ===
Contributors: robskinn
Tags: alt text, accessibility, seo, ai, images
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered alt text generator that finds and fixes image SEO gaps in WordPress.

== Description ==

ALTification is a service created and operated by A Fine Studio (afinestudio.com). This is the official WordPress plugin for that service.

ALTification uses AI to generate keyword-aware alt text, captions, and descriptions for your images — directly from your SEO plugin's focus keyphrase and page context.

**Features:**

* Bulk generate alt text across your entire site with the Site Scan
* Page-level generation with keyword context from Yoast SEO, Rank Math, AIOSEO, SEOPress, and The SEO Framework
* Generate captions and descriptions alongside alt text
* Media Library column showing SEO health badges for every image
* Post editor metabox for inline generation
* Detect and fix SEO gaps where alt text doesn't reflect the page keyword
* Mark decorative images to suppress alt text (WCAG compliant)
* Supports WooCommerce products, ACF image fields and shared images
* Before & After report for agency workflows (Agency plan)

ALTification connects to the ALTification platform API to generate content. An API key is required.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate the plugin through the Plugins screen in WordPress.
3. Go to **ALTification → Settings** and enter your API key from [altification.ai](https://altification.ai).
4. Run the **Site Scan** to assess your images, then generate alt text in bulk or page by page.

== Frequently Asked Questions ==

= Do I need an API key? =

Yes. You only need an ALTification API key — get yours from [altification.ai/dashboard](https://altification.ai/dashboard). You do not need to manage your own Anthropic or other AI provider key; generation is handled on the ALTification server. See the External Services section below for details on how data is processed.

= Which SEO plugins are supported for keyword context? =

Yoast SEO, Rank Math, All in One SEO, SEOPress, and The SEO Framework are all supported. The focus keyphrase is read automatically when you load a page in the scanner.

= Can I generate alt text for WooCommerce products? =

Yes. Product images use the product's focus keyword and the WooCommerce product context is included in the prompt.

= Does it support ACF image fields? =

Yes. ALTification scans for ACF image fields and prompts you to add any newly discovered fields to your settings.

= Is the generated alt text saved automatically? =

Optionally. You can enable "Save on generation" in the Site Scan to save automatically, or review and save manually.

== Screenshots ==

1. Site Scan — bulk generate alt text across your entire site, with SEO gap detection and WooCommerce product context
2. Site Scan — shared image handling, with product priority and site-wide keyword fallback
3. Page Scan — select a page, post, or custom post type and load images with SEO keyword context
4. Page Scan — generate contextual alt text per image, with filename intelligence and smart shared image handling
5. Preview & Refine — test tone, length, and keyword balance for free before spending any credits
6. About Your Business — automatically reads your site so the AI understands your business context from day one

== External Services ==

This plugin connects to the ALTification API to generate alt text, captions and descriptions for your images. It will only contact the API when you actively trigger a scan, generation, credit check or site analysis — never on a schedule or in the background.

= ALTification API =

Endpoint: https://altification.ai/wp-json/altification/v1/

When you generate, the plugin sends:

* Your image (as a URL or base64-encoded data)
* The page's SEO context (focus keyword, meta title, meta description, where available from your SEO plugin)
* Your site's context (site name, language, WooCommerce product/category data if relevant, a short excerpt of your homepage text, ACF field content if you have configured ACF support)
* A non-identifying site fingerprint (an MD5 hash of WordPress's COOKIEHASH and site URL, used to lock your API key to one site)
* Your ALTification API key

The API returns the generated text, your remaining credit balance and your account status.

ALTification does not store the image after the response is returned.

* ALTification Privacy Policy: https://altification.ai/privacy-policy/
* ALTification Terms of Service: https://altification.ai/terms/

= Anthropic (Claude) =

To produce the generated text, ALTification's server forwards the image and prompt to Anthropic's Claude API (model: Claude Haiku). This happens on ALTification's server — the plugin does not call Anthropic directly and you do not need an Anthropic account or key. Anthropic does not retain inputs or outputs for model training under their commercial API terms.

* Anthropic Privacy Policy: https://www.anthropic.com/legal/privacy
* Anthropic Commercial Terms: https://www.anthropic.com/legal/commercial-terms

Use of this plugin requires an ALTification account and API key, available at https://altification.ai.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
