=== AltoGraph – AI Alt Text Generator & SEO Meta Descriptions ===
Contributors: reallyusefulappco
Tags: alt text, alt text generator, image seo, meta description, accessibility
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI alt text generator for images, plus SEO meta descriptions & schema. No API key or setup. Free for 25 items a month.

== Description ==

AltoGraph is an **AI alt text generator** that writes the metadata you never have time for. When you upload an image, it generates accurate, accessible **alt text** by looking at the picture. When you save a post, it can write an SEO **meta description** and add **JSON-LD structured data**. Turn it on once and it keeps your media and content described as your site grows.

Unlike most tools, **you don't need your own AI API key.** The AI runs on the AltoGraph service, so there's nothing to configure. The free plan covers 25 items per month; AltoGraph Pro removes the monthly limit (subject to fair use).

**What it does**

* Generates descriptive alt text for images from the image itself (better accessibility and image SEO).
* Writes concise, on-topic meta descriptions for posts and pages.
* Adds Article JSON-LD structured data for richer search results.
* Backfills alt text for images that are currently missing it.
* Never overwrites alt text you've written yourself.

**Privacy-friendly by design**

Automation is **off until you switch it on**, and AltoGraph only ever sends what it needs to do the job (see the External Services section below). A non-identifying site ID (a hash of your site URL) is used for usage counting; no personal data is required.

== External services ==

This plugin connects to the **AltoGraph API** to generate alt text and metadata. It is required for the plugin's core features.

* **What is sent and when:**
  * *Alt text:* when you upload an image (with automation on), run the backfill action, the plugin sends the **image URL** and **filename** to the AltoGraph API.
  * *Meta descriptions:* when you save a post or page (with automation on), the plugin sends the **post title** and **post content**.
  * *Usage counting:* a non-identifying **site ID** (a hash of your site URL) accompanies each request.
* **Where it goes:** the AltoGraph API (default `https://api.thereallyusefulappcompany.com`), which uses **Anthropic** as an AI subprocessor to generate the text.
* **Service terms and privacy:**
  * AltoGraph Terms: https://thereallyusefulappcompany.com/altograph/terms
  * AltoGraph Privacy Policy: https://thereallyusefulappcompany.com/altograph/privacy
  * Anthropic Privacy Policy: https://www.anthropic.com/legal/privacy

No data is sent until you enable automation, click the backfill button, or save a post while automation is enabled.

== Installation ==

1. Install AltoGraph from the Plugins screen, or upload the `altograph` folder to `/wp-content/plugins/`.
2. Activate the plugin.
3. Go to **Settings → AltoGraph**.
4. Review the external-service notice, then enable "Write alt text automatically" and/or "Write a meta description automatically."
5. (Optional) Enter a AltoGraph Pro licence key to remove the monthly limit.

== Frequently Asked Questions ==

= Do I need an AI API key? =
No. The AI runs on the AltoGraph service, so there's nothing to set up.

= Will it overwrite alt text I've already written? =
No. AltoGraph only fills in alt text that is missing.

= Is anything sent automatically without my knowledge? =
No. Automation is off by default. Data is only sent after you enable it, and exactly what's sent is listed in the External Services section.

= What happens when I hit the free limit? =
Generation pauses for the rest of the month. Upgrade to Pro for unlimited use, or wait for the next month.

== Screenshots ==

1. The AltoGraph settings screen with the external-service notice and automation toggles.
2. Alt text generated automatically for a newly uploaded image.

== Changelog ==

= 1.0.5 =
* Renamed to AltoGraph (capital G) to match the rest of the Really Useful App Company family. Same plugin and settings — display name only.
* Refreshed the plugin icon and banner with the new family look.

= 1.0.4 =
* Added an optional, dismissible prompt on the settings page inviting an honest review after you've generated a few times. No tracking; dismiss any time.
* Added: AltoScribe to the list of our other plugins shown on the settings screen.

= 1.0.3 =
* Added: AltoFAQ to the list of our other plugins shown on the settings screen.

= 1.0.2 =
* Updated: plugin name and listing details so it's easier to find and clearer about what it does.

= 1.0.1 =
* Added: a reminder to review AI-generated content for accuracy before publishing (settings screen and generate actions).
* Added: links to our other Really Useful App Company plugins on the settings screen (dismissible, no tracking).

= 1.0.0 =
* Initial release: automatic alt text, meta descriptions, JSON-LD, and backfill.
