=== Yamandu Native AI Content Creator – AI Writer, Image Generator & Alt Text ===
Contributors: redepiabanha
Tags: ai content, ai writer, image generator, alt text, openai
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI writer, image generator, and alt text generator for WordPress with Gemini, OpenAI, Media Library workflows, SEO and accessibility.

== Description ==

Yamandu Native AI Content Creator adds practical AI writing, image generation, image titles, and alt text generation to native WordPress workflows. It is built for publishers, agencies, marketing teams, and site owners who want faster content production without moving editorial work into a separate platform.

Use Yamandu to generate post text in the editor, create images from prompts, improve image alt text for accessibility and image SEO, and organize media with useful attachment titles. The plugin works inside familiar WordPress screens: Gutenberg, Classic Editor, the Media Library, attachment edit screens, row actions, bulk actions, and the Yamandu settings page.

Yamandu 1.1.2 supports the WordPress AI Client and Connectors when available. That means compatible sites can use AI providers configured in `Settings -> Connectors`, including Google/Gemini and OpenAI through their connector integrations. For older WordPress environments or sites not using connectors, the legacy direct Gemini API integration remains available as a fallback.

= AI content creation inside WordPress =

Yamandu focuses on the editorial tasks that WordPress teams repeat every day:

* Generate AI post text from editorial prompts.
* Insert generated text into Gutenberg or Classic Editor workflows.
* Create AI-generated images and save them to the WordPress Media Library.
* Generate image alt text for accessibility and image SEO.
* Generate image attachment titles for cleaner media organization.
* Process selected images with Media Library bulk actions.
* Regenerate metadata intentionally when a replacement is needed.

= Why Yamandu is different =

Many WordPress AI plugins focus only on chat, only on alt text, only on filename-based image attributes, or only on a separate content platform. Yamandu combines AI writing, AI image generation, and native image metadata workflows in a focused plugin designed for professional publishing.

Core advantages:

* Native WordPress integration instead of a separate writing dashboard.
* AI writer tools for the post editor.
* AI image generator for the Media Library.
* AI alt text generator for existing image attachments.
* Image title generation for better media organization.
* Bulk image metadata generation from the Media Library list view.
* Model preferences for text, titles, excerpts, image metadata, and image generation.
* WordPress Connectors support when available.
* Legacy Gemini API fallback for older environments.
* Explicit administrator consent before external AI requests are allowed.
* Generated metadata stored in native WordPress fields.
* Focused SEO and accessibility benefits without replacing a full SEO plugin.

= Supported AI provider workflows =

When WordPress AI Client and Connectors are available, Yamandu can use compatible providers configured in WordPress:

* Gemini for text generation and image understanding.
* Google Imagen and Nano Banana image models for image generation.
* OpenAI GPT models for text generation and image understanding when available through Connectors.
* OpenAI image models for image generation when available through Connectors.

When Connectors are not available or not configured, Yamandu can continue using the legacy direct Gemini API integration configured in `Settings -> Yamandu`.

= Model preferences =

Yamandu lets administrators choose model preferences for the main generation tasks:

* Editorial text model.
* Title model.
* Excerpt model.
* Image metadata model.
* Image generation model.

The available options depend on the providers connected in WordPress. If a compatible model is not selected, Yamandu can use the automatic recommended option.

= Built for control =

Yamandu does not treat AI as invisible background automation. Administrators control whether third-party requests are enabled, which provider path is used, which model preferences are selected, and when metadata should be generated or regenerated.

This matters for real editorial operations. AI can speed up drafting, image creation, alt text, and media organization, but teams still need human review, predictable settings, and clear control over external processing.

== Installation ==

1. Install and activate Yamandu Native AI Content Creator.
2. Open `Settings -> Yamandu`.
3. Enable third-party requests only if the site administrator agrees to send selected content to the configured AI provider.
4. If your site has WordPress AI Client and Connectors, configure a compatible provider in `Settings -> Connectors`.
5. Return to `Settings -> Yamandu`, choose model preferences if available, and save changes.
6. If Connectors are not available, create a Gemini API key, enter it in the legacy API settings, save, validate the key, and choose the legacy Gemini model options.
7. Use the post editor or Media Library actions to generate text, images, image titles, and alt text.

== External Services ==

Yamandu connects to external AI services only after an administrator enables third-party requests in the plugin settings and configures either a WordPress AI connector or the legacy Gemini API key.

Depending on the enabled workflow, data sent to an AI provider may include text prompts, selected post text, draft instructions, image prompts, selected image file content, image URLs or file data, filenames, existing image metadata, site language information, and generation settings.

Requests are made only when an authorized administrator or editor triggers generation through the post editor, Media Library, attachment edit screen, row actions, bulk actions, or image creation interface.

Services that may be used depending on configuration:

* Google Gemini API and related Google AI services: https://ai.google.dev/
* Google AI terms: https://ai.google.dev/gemini-api/terms
* Google Privacy Policy: https://policies.google.com/privacy
* OpenAI API, when configured through WordPress Connectors: https://platform.openai.com/docs
* OpenAI Terms of Use: https://openai.com/policies/terms-of-use
* OpenAI Privacy Policy: https://openai.com/policies/privacy-policy

When Yamandu uses WordPress AI Client and Connectors, provider credentials are managed by WordPress and the corresponding connector/provider plugin. When Yamandu uses the legacy fallback, the Gemini API key is entered directly in `Settings -> Yamandu`.

== Frequently Asked Questions ==

= What does Yamandu Native AI Content Creator do? =

Yamandu helps WordPress teams generate AI post text, create images, and produce image titles and alt text from native WordPress workflows.

= Does Yamandu work with Gutenberg? =

Yes. Yamandu includes prompt-based AI writing support for Gutenberg and also supports Classic Editor workflows.

= Can Yamandu generate images inside WordPress? =

Yes. The plugin can create images from prompts and save the generated files directly to the WordPress Media Library.

= Can Yamandu generate alt text for existing images? =

Yes. Yamandu can generate image alt text for WordPress image attachments to support accessibility and image SEO.

= Can Yamandu generate media titles? =

Yes. The plugin can generate attachment titles to improve media organization and metadata quality.

= Does Yamandu support bulk processing? =

Yes. Selected images can be processed through Media Library bulk actions, which helps teams improve metadata across multiple attachments more efficiently.

= Will Yamandu overwrite existing metadata? =

Standard generation can respect existing fields. AI buttons and explicit regeneration actions are intentional replacement workflows and may overwrite eligible fields according to the selected behavior.

= Does Yamandu require WordPress 7.0? =

No. Yamandu keeps compatibility with older WordPress environments through the legacy Gemini API fallback. WordPress AI Client and Connectors are used when available.

= Does Yamandu support OpenAI? =

Yes, when OpenAI is available through WordPress AI Client and Connectors. Yamandu does not add a separate OpenAI API key screen; provider credentials are managed through WordPress Connectors.

= Does Yamandu support Gemini? =

Yes. Yamandu supports Google AI Studio API for Gemini through WordPress Connectors when available and also keeps the legacy direct Gemini API fallback.

= Does Yamandu replace a full SEO plugin? =

No. Yamandu focuses on AI-assisted content creation, image generation, image titles, and alt text. It is designed to complement SEO plugins rather than replace broader SEO, schema, analytics, or technical optimization tools.

= What happens when the plugin is uninstalled? =

By default, uninstall preserves plugin data. Administrators can enable data removal on uninstall in the settings page.

== Changelog ==

= 1.1.2 =
* Added packaged translation files and refreshed translation templates.

= 1.1.1 =
* Added WordPress AI Client and Connectors support as the preferred integration path when available.
* Added connector-based model preferences for editorial text, titles, excerpts, image metadata, and image generation.
* Added connector-compatible support for Google AI Studio and OpenAI providers while preserving the legacy Gemini API fallback.
* Improved model lists for connected providers and image generation workflows.

= 1.0.3 =
* Reduced background activity in the post editor to improve Classic Editor and Gutenberg responsiveness.
* Kept the text and image generators available without running Media Library watchers on regular writing screens.
* Improved compatibility behavior when Yamandu Pro is active.

= 1.0.2 =
* Certified compatibility metadata for WordPress 7.0.
* Saved AI-generated images as WebP files in the Media Library without changing the image prompt sent to the AI provider.
* Improved Classic Editor and Gutenberg reliability for text generation, image prompt generation, and long-running AI requests.
* Added a WordPress.org-friendly request for honest feedback after real plugin use.

= 1.0.1 =
* Removed the legacy external visual-analysis API requirement from image metadata generation.
* Updated image understanding to use Gemini directly when generating title and alt text.
* Updated Google AI model names and available model options to match current official Gemini and Imagen model IDs.
* Hardened post editor behavior to avoid unnecessary background activity while preserving WordPress Heartbeat and autosave.

= 1.0.0 =
* Initial release.
