=== TonioWeb AI Content Generator ===
Contributors: toply
Tags: ai, alt text, seo, translation, accessibility
Requires at least: 7.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Bring your own OpenAI, Claude or Gemini key and bulk-generate alt text, SEO meta, translations and excerpts via WordPress 7.0 Connectors.

== Description ==

TonioWeb AI Content Generator lets you use your own OpenAI, Anthropic (Claude) or Google Gemini API key to automatically generate content in bulk across your WordPress site — alt text for images, SEO meta descriptions, translations, and post excerpts. The plugin itself is free. You only pay your AI provider directly for what you use.

= How It Works =

1. Get an API key from OpenAI, Anthropic or Google (all offer pay-as-you-go, no monthly subscription required)
2. Add the key in **WordPress Settings → Connectors** — this is a built-in WordPress 7.0 feature for managing AI provider credentials
3. Open **TonioWeb AI Content Generator** from the admin menu
4. Choose a feature (Alt Text, SEO Meta, Translate or Excerpt), preview the results and run the bulk job

That's it. No separate account, no credit card for this plugin, no data sent to our servers — everything goes directly between your site and the AI provider you chose.

= Features =

**🖼️ Bulk AI Alt Text Generator**
Scan your entire Media Library and generate accessible alt text for every image using AI vision. WCAG-friendly, multilingual, SEO-optimized. Skip images that already have alt text, or force-regenerate. Preview before saving. Undo per-image or in bulk.

**📝 AI SEO Meta Description Generator**
Generate compelling 155-character SEO meta descriptions for posts, pages, products, and custom post types. Works alongside Yoast, Rank Math, All in One SEO, SEOPress, and any other SEO plugin. Bulk-process by category, tag, date range, or author.

**🌍 AI Auto-Translate**
Translate posts, pages, products, taxonomies, and custom fields into 100+ languages. Multi-pass quality: AI translates, then refines tone for natural reading. Compatible with Polylang, WPML, TranslatePress workflows.

**✂️ AI Excerpt Generator**
Replace empty or auto-truncated excerpts with engaging 1–3 sentence summaries. Detect content type and adapt tone (news, e-commerce, blog, tutorial, etc.). Bulk-fill missing excerpts site-wide.

**🔌 WordPress 7.0 Connector Native**
Zero configuration. If you've added an OpenAI, Claude, or Gemini key in Settings → Connectors, TonioWeb AI Content Generator finds it instantly. Per-feature provider routing (e.g., use Gemini for alt text, Claude for translations).

= Who Should Use This Plugin? =

* **Content site owners** with hundreds or thousands of legacy posts missing meta descriptions or excerpts
* **WooCommerce stores** with large catalogs that need alt text and product descriptions
* **Agencies & freelancers** managing multiple client sites, each with their own AI keys
* **Multilingual sites** that need automated translation without subscribing to a translation service
* **Accessibility-focused publishers** who must comply with WCAG and EAA requirements

= Supported AI Providers =

TonioWeb AI Content Generator reads provider credentials from the WordPress 7.0 Connectors registry. Currently supported via native Connectors:

* **OpenAI** — GPT-4o, GPT-4.5, GPT-5 and Vision models for alt text
* **Anthropic Claude** — Claude 4.x for translations and long-form excerpts
* **Google Gemini** — Gemini 2.x for cost-efficient bulk processing

Additional providers will be added as WordPress 7.x ships new Connector packages.

= Privacy & Data Handling =

TonioWeb AI Content Generator is a thin orchestration layer. It sends your content directly from your WordPress site to the AI provider you selected, using YOUR API key. **We never see, store, or proxy your data.** No telemetry. No analytics. No phone-home.

= Source Code =

The plugin PHP source code is located in the `src/` directory. The React admin UI source (JSX/JS) is located in the `admin/src/` directory. The compiled admin bundle (`admin/build/`) is generated from those source files using `@wordpress/scripts` (webpack). To rebuild: `npm install && npm run build`.

== Installation ==

= Automatic Installation =

1. Log into your WordPress admin
2. Navigate to **Plugins → Add New**
3. Search for **"TonioWeb AI Content Generator"**
4. Click **Install Now**, then **Activate**
5. Make sure you have at least one provider key in **Settings → Connectors** (OpenAI, Claude, or Gemini)
6. Go to **TonioWeb AI Content Generator** in the admin menu and run your first bulk task

= Manual Installation =

1. Download the `tonioweb-ai-content-generator.zip` file
2. Go to **Plugins → Add New → Upload Plugin**
3. Select the zip file and click **Install Now**
4. Click **Activate**

= First-Time Setup (60 seconds) =

1. Open **Settings → Connectors** in WordPress 7.0
2. Add at least one provider: OpenAI, Anthropic, or Google
3. Paste your API key from that provider (get one at platform.openai.com, console.anthropic.com, or aistudio.google.com)
4. Go to **TonioWeb AI Content Generator → Dashboard**
5. Pick a feature (Alt Text, SEO Meta, Translate, or Excerpt) and click **Scan & Preview**

That's it. No account creation, no email signup, no credit card required from us — only the key you already manage with your AI provider.

== Frequently Asked Questions ==

= Do I need a paid OpenAI/Claude/Gemini account to use TonioWeb AI Content Generator? =

You need at least one provider API key. All three (OpenAI, Anthropic, Google) offer pay-as-you-go pricing with no monthly minimum. You'll typically spend $0.001–$0.005 per item processed (e.g., 1000 alt text generations = ~$1–$5 total).

= Does TonioWeb AI Content Generator work with WordPress 6.x? =

No. TonioWeb AI Content Generator requires the Connector API introduced in WordPress 7.0. The plugin will not activate on older WordPress versions. If you're on 6.x, please upgrade to 7.0 first.

= Does it conflict with Yoast SEO, Rank Math, All in One SEO, or SEOPress? =

No. TonioWeb AI Content Generator writes to the standard WordPress post meta fields that all major SEO plugins read from. You can keep your current SEO plugin and use TonioWeb AI Content Generator to fill in missing data faster.

= Will TonioWeb AI Content Generator overwrite my existing alt text or meta descriptions? =

By default, no. TonioWeb AI Content Generator skips items that already have content unless you explicitly enable **"Force regenerate"** in the bulk dialog. Every bulk operation also has a per-item Undo and a global rollback for the last 7 days.

= Can I use different providers for different features? =

Yes. The Routing tab lets you set, for example, Gemini for alt text (cheapest), Claude for translations (best quality), and GPT-4o for excerpts. You can also set fallback providers if your primary one is rate-limited.

= How does TonioWeb AI Content Generator handle rate limits and large libraries? =

Bulk operations run through the WordPress Action Scheduler queue. Items are processed in background batches with automatic backoff when the provider returns 429. You can pause, resume, or cancel any running job from the Dashboard.

= Is my content sent anywhere besides my chosen AI provider? =

No. TonioWeb AI Content Generator is a direct client between your WordPress site and the AI provider you configured. We have no server, no proxy, no telemetry endpoint. The plugin is 100% self-contained.

= Does it support multilingual translation for WooCommerce products? =

Yes. TonioWeb AI Content Generator translates product titles, short descriptions, long descriptions, attribute labels, and custom fields. It plays nicely with Polylang and WPML by writing to the correct language slugs.

= Can I use TonioWeb AI Content Generator on a client site I don't own? =

Yes. The site owner just needs to add their own provider key to Settings → Connectors. TonioWeb AI Content Generator never stores keys outside the standard WordPress Connector registry, so you can audit and remove access at any time.

= Is there a Pro version? =

A Pro tier is planned for future releases with features like: per-feature scheduled re-runs, custom prompt templates, brand-voice profiles, CSV import/export of bulk job results, and multi-site network manager. The core features listed above will always remain in the free plugin.

= What if a new AI provider launches? =

When the WordPress core team or a third party ships a new Connector package, TonioWeb AI Content Generator will auto-detect it. We do not lock you to a specific provider — the plugin uses the abstract Connector API, so any new provider with a Connector becomes immediately usable.

= Does this work for accessibility compliance (WCAG, EAA)? =

The alt text generator produces descriptive, contextual alt text aligned with WCAG 2.2 success criterion 1.1.1 and EAA accessibility requirements. The output is a draft — you remain responsible for the final review per WCAG best practices. TonioWeb AI Content Generator dramatically lowers the time cost of bringing a large site into compliance.

= What happens to my data if I uninstall the plugin? =

When you delete TonioWeb AI Content Generator from the WordPress admin, the uninstall routine removes everything the plugin created: the three custom database tables (jobs, job items, rollback log), all plugin options, and any scheduled background tasks. Your actual content — alt text, meta descriptions, excerpts, translations — is written to standard WordPress fields and stays on your site permanently, regardless of whether the plugin is active.

= Is the plugin GPL-compatible / can I fork it? =

Yes. TonioWeb AI Content Generator is GPLv2 or later. You can audit, modify, fork, or rebrand the code subject to GPL terms.

== Screenshots ==

1. The TonioWeb AI Content Generator Dashboard — see all available features, last-run status, and queue activity at a glance.
2. Bulk Alt Text Generator — scan results with per-image preview and per-item approve/reject controls.
3. AI SEO Meta Generator — bulk-process posts filtered by category, with side-by-side preview of current vs proposed meta description.
4. Auto-Translate — language selector, source/target post pairing, and Polylang/WPML detection.
5. Excerpt Generator — content-type aware excerpt generation with adjustable tone and length.
6. Provider Routing — assign OpenAI, Claude, or Gemini to each feature with cost estimates per 1000 items.
7. WordPress 7.0 Connectors integration — read directly from Settings → Connectors. Zero key management inside the plugin.

== Changelog ==

= 1.0.2 =
* Fixed text domain updated from `ai-multitool` to `tonioweb-ai-content-generator` across all PHP files to match the plugin slug.
* Removed WordPress.org directory assets from the plugin package — uploaded separately via SVN.

= 1.0.1 =
* Plugin renamed to TonioWeb AI Content Generator; slug changed to `tonioweb-ai-content-generator`.
* Admin menu slugs and REST API namespace updated to `tonioweb-ai-content-generator`.
* Readme expanded with a "How It Works" section and clearer Connectors description.

= 1.0.0 =
* Initial release.
* Bulk AI Alt Text Generator with Vision API support across OpenAI, Anthropic, and Google providers.
* AI SEO Meta Description Generator compatible with Yoast, Rank Math, All in One SEO, and SEOPress meta fields.
* AI Auto-Translate for posts, pages, products, taxonomies, and custom fields in 100+ languages.
* AI Excerpt Generator with content-type detection and tone adaptation.
* Native WordPress 7.0 Connector API integration — no key storage inside the plugin.
* Per-feature provider routing with fallback chain.
* Action Scheduler bundled as a production dependency — bulk processing works without WooCommerce.
* Per-item Undo and 7-day global rollback for every bulk operation.
* Per-feature dry-run preview before any write.
* Improved security and input validation throughout the plugin.
* WP-CLI commands for headless use: `wp aim alt-text bulk`, `wp aim seo-meta bulk`, `wp aim translate bulk`, `wp aim excerpt bulk`.

== Upgrade Notice ==

= 1.0.2 =
Text domain corrected to match plugin slug. No functional changes.

= 1.0.0 =
Initial release of TonioWeb AI Content Generator. Requires WordPress 7.0 and at least one Connector API provider configured in Settings → Connectors.
