=== WordAI ===
Contributors: codeapple, softcoy
Plugin URI: https://softcoy.com/products/wordai-pro
Tags: ai writing, ai images, seo scan, search console, ai chat
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 3.4.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI content generation, SEO scan, image generation, Search Console reporting, AI Agent, and chat tools for WordPress.

== Description ==
WordAI is an AI content, SEO, image, AI Agent, and chat assistant plugin for WordPress that helps site owners create stronger posts, pages, titles, excerpts, tags, and AI images directly from wp-admin. It brings OpenAI, Google Gemini, Anthropic Claude, xAI Grok, SEO scanning, Google Search Console reporting, and site-aware AI assistant workflows into one clean publishing dashboard.

Use WordAI to generate complete post or page drafts, suggest better titles from the Posts or Pages list, create excerpts and tags, generate high-quality AI images, scan existing content for SEO opportunities, review Search Console performance signals, and build a front-end AI Chat assistant from selected website knowledge. WordAI Pro unlocks the full premium workflow for advanced SEO generation, WooCommerce content, richer AI Agent automation, premium image controls, private updates, and priority support.

[youtube https://www.youtube.com/watch?v=xWEQwDF7XMY]

[youtube https://youtu.be/b4FggaJ_124]

Learn more about [WordAI Pro](https://softcoy.com/products/wordai-pro) or read the [WordAI documentation](https://softcoy.com/docs/wordai-pro-overview).


== Features ==

= AI content generation workflow =

* OpenAI, Google Gemini, Anthropic Claude, and xAI Grok provider support.
* Provider-specific API Settings with current model families, including OpenAI GPT-5.6 Sol, Terra, and Luna; Claude Sonnet 5, Fable 5, and Opus 4.8; Gemini 3.5 Flash and Gemini 3.1; plus xAI Grok models.
* AI content generation for posts and pages.
* Title, content, excerpt, and tag generation controls.
* Prompt Assistant in the content generation modal with helpful examples, a guided prompt builder, and direct content documentation.
* Step-by-step [WordAI documentation](https://softcoy.com/docs/wordai-pro-overview) for setup, API keys, content generation, image creation, SEO Scan, Search Console, and AI Agent workflows.
* One-click WordAI Title suggestions from Posts and Pages list screens.
* SEO-friendly writing controls for language, style, tone, paragraph count, excerpt length, heading structure, content depth, freshness signals, and tag count.
* Cleaner AI response processing for more polished titles, paragraphs, and editor-ready content.

= SEO growth tools =

* SEO Scan dashboard for posts, pages, and products with SEO scoring, issue discovery, recommendations, and AI-assisted improvement workflows.
* Google Search Console reporting inside the WordPress dashboard with content-decay opportunities, competing-page insights, and direct paths back to local WordPress content.
* SEO plugin compatibility controls designed to work cleanly alongside popular SEO plugins.
* Search-focused recommendations that help improve titles, meta quality, content structure, keyword usage, and readability.
* Explore the complete premium SEO workflow in [WordAI Pro](https://softcoy.com/products/wordai-pro).

= Image generation =

* Image Settings with GPT Image 1.5 as the default image model and ChatGPT Images 2.0 / GPT Image 2 as an optional model.
* Current Gemini image choices including Gemini 3.1 Flash Image, Gemini 3.1 Flash-Lite Image, and Gemini 3 Pro Image.
* AI image generation controls for creating visual assets from prompts without leaving WordPress.
* xAI Grok image generation support with provider-aware Image Settings for model, aspect ratio, resolution, and image-count handling.
* Learn how image generation works in the [WordAI documentation](https://softcoy.com/docs/wordai-pro-content-generation-modal).

= AI Agent, chat, support, and upgrade path =

* AI Agent content embedding with selectable content items, indexing status, and re-index guidance when source content changes.
* Frontend AI Chat assistant powered by selected website knowledge.
* AI Chat Analytics tab for reviewing conversations, visitor questions, feedback, and knowledge gaps.
* AI Chat lead capture workflow for collecting visitor details and reviewing interested visitor activity from the WordPress dashboard.
* Support page with diagnostics and SOFTCOY Support Office delivery.
* Get Pro page for unlocking the complete [WordAI Pro](https://softcoy.com/products/wordai-pro) publishing, SEO, image, and AI assistant workflow.
* Learn how [WordAI Pro](https://softcoy.com/products/wordai-pro) expands SEO automation, Search Console insights, AI Chat conversion workflows, WooCommerce content, and premium image generation.
* Review setup and feature guides in the [WordAI documentation](https://softcoy.com/docs/wordai-pro-overview).
* Update-safe custom database table handling during normal wp-admin plugin updates.

== Screenshots ==
1. WordAI API Settings page for choosing OpenAI, Google Gemini, Anthropic Claude, or xAI Grok and configuring provider model options.
2. WordAI Content Settings page with writing presets, SEO-friendly structure controls, language controls, and auto-insert options.
3. WordAI Image Settings page with GPT Image models, image output controls, and gallery / featured image options.
4. WordAI SEO Scan page with paginated post, page, and product SEO scoring, issue suggestions, AI Auto Fix actions, and upgrade path.
5. WordAI Google Search Console page for connecting a property and reviewing search performance reports from wp-admin.
6. WordAI AI Agent Contents Embedding page with embedding model controls, content-type selection, indexing summary, and expanded Content Items to Embed workflow.
7. WordAI AI Chat Settings page for configuring the frontend AI Chat assistant, provider model, greeting, tone, and display options.
8. WordAI AI Chat Analytics page for conversation reporting, feedback review, and knowledge gap insights.
9. WordAI Get Pro page showing the license upgrade path and the main Pro benefits available from inside wp-admin.
10. WordAI Support page with diagnostics, support request delivery, attachment support, and sensitive-data-safe diagnostics preview.

== Installation ==
1. In your WordPress dashboard, go to Plugins > Add New and search for WordAI.
2. Click Install Now, then click Activate.
3. You can also upload the plugin folder manually to `/wp-content/plugins/wordai/` and activate it from Plugins.
4. Go to WordAI > API Settings.
5. Choose OpenAI, Google Gemini, Anthropic Claude, or xAI Grok as your AI provider.
6. Add the API key for your selected provider and save settings.
7. Review WordAI > Content Settings and WordAI > Image Settings, then start generating content, titles, tags, excerpts, and images.

== Changelog ==

= 3.4.0 =
* Added xAI Grok provider support for content generation, suggested titles, AI image generation, frontend AI Chat, and provider-aware settings workflows.
* Added xAI Grok API, content, image, chat, and embedding-provider settings so Grok can be selected and managed consistently with the existing AI providers.
* Improved xAI Grok image generation so WordAI follows the Image Settings image-count control correctly with provider-aware image workflows.
* Added the OpenAI GPT-5.6 Sol, Terra, and Luna model family to the shared model workflow used by API Settings and AI Chat.
* Added current Anthropic models including Claude Sonnet 5, Claude Fable 5, and Claude Opus 4.8, with Sonnet 5 as the recommended default and retired Claude models removed from active selection.
* Added current Gemini models including Gemini 3.5 Flash, Gemini 3.1 Flash-Lite, Gemini 3.1 Pro Preview, and Gemini 3.1 Flash-Lite Image, with stable model defaults and compatibility-aware request handling.
* Improved OpenAI GPT-5-family text generation so content, titles, image alt text, and suggested titles use the stable Responses API workflow while image generation remains provider-specific.
* Improved suggested-title generation so current OpenAI GPT-5-family models use the same stable non-streaming provider response path as the content generation modal.

= 3.3.1 =
* Improved generated content cleanup so empty list bullets are removed before content is inserted into the editor.
* Improved image generation result handling so unsupported provider image requests show a clear Images tab error without showing Save to Gallery when no image exists.
* Improved content generation prompts so the selected paragraph count is treated as the exact body-paragraph target while headings remain available when enabled.
* Improved result tabs so compact badges show short states while detailed provider errors stay inside the opened result panel.
* Improved Anthropic and cross-provider content cleanup so generated article content avoids malformed bullet/list artifacts and keeps clean paragraph structure.
* Improved generated result tab spacing inside the content generation modal.
* Added clearer documentation links and first-use guidance for setting API keys, opening the WordAI editor modal, generating content, and creating images.
* Improved Prompt Assistant workflow so unfinished template placeholders are caught before generation, with clearer next-step guidance for users.
* Added Prompt Assistant inside the content generation modal with helpful prompt examples, guided builder fields, and direct Content Help documentation.
* Improved content generation guidance for title, content, excerpt, tags, image creation, and provider-based generation workflows.
* Improved Gemini long-form content handling with adaptive output limits based on Content Settings and cleaner duplicate-error prevention in the generation modal.
* Improved AI image prompt handling, SEO-friendly image alt text, generated-image thumbnails, and featured-image selection from the content generation modal.
* Improved the content generation modal prompt field and generated-image preview layout for longer prompts and easier featured-image selection.
* Improved the content generation modal loading UI with a compact title-bar progress wave and cleaner Prompt Assistant spacing.
* Improved the WooCommerce product editor content generation modal so it stays in place while generated product content and images are inserted.
* Improved Google Search Console Opportunities with richer content-decay signals, competing-page insights, and clearer paths from Search Console findings into local WordPress content workflows.
* Added direct local post matching for Search Console report URLs so related posts, pages, products, and custom content can be opened in SEO Scan or the editor when available.
* Improved SEO Scan deep-link behavior so opportunity-driven review workflows can open the correct post type, search term, status, and focused content item.
* Improved the Search Console page header by removing the unnecessary tier badge beside Refresh and keeping the action area cleaner for users.
* Improved the Get Pro page with stronger upgrade messaging and clearer Free vs Pro comparison wording.
* Updated WordAI documentation and screenshot references for the refreshed SEO Scan and Search Console workflows.

= 3.3.0 =
* Added Google Search Console reporting experience so connected sites can review search visibility insights directly from the WordPress dashboard.
* Added AI Chat Analytics for reviewing visitor conversations, feedback, unanswered questions, and content knowledge gaps.
* Added AI Chat lead capture workflow with frontend visitor prompts, validation feedback, and captured visitor review in analytics.
* Improved frontend AI Chat layout with cleaner visitor input controls, responsive chat window sizing, and better Powered by SOFTCOY placement.
* Improved AI Chat contact prompts with clearer optional / required visitor-detail handling and email validation feedback.
* Updated Gemini image generation support with current Gemini 3 image model options while keeping legacy Gemini image compatibility.
* Improved image format settings so OpenAI and Gemini show provider-compatible output format choices.
* Improved AI Agent content embedding with a larger content-item selection view, clearer indexing status, and re-index guidance when source content changes.
* Improved SEO Scan workflows with stronger recommendations, review-friendly AI Auto Fix handling, scheduled bulk SEO workflow interface, and cleaner action controls.
* Improved content generation prompts and response cleanup for more SEO-ready headings, paragraphs, summaries, and editor-ready output.
* Improved provider switching, suggested-title handling, modal feedback messages, and generation progress visibility across supported AI providers.

= 3.2.0 =
* Added new SEO scan / review features including search engine accepted specific SEO suggestions including AI auto fix solution
* Added bulk SEO scan and auto fix scheduled job settings for automation of larger content list items
* Improved content generation with more SEO friendly content structures and search engine visibility priority

= 3.1.0 =
* Added Content Items Embedding Option for post types
* Specific posts can be selected to embed to make source of knowledge of AI chat assistant
* Added SEO Scan for post, page, and product SEO scoring
* minor issues fixed

= 3.0.1 =
* Minor bug fixed
* Minor UI issue fixed

= 3.0.0 =
* Major free release with refreshed WordPress.org readme sections and matching screenshot assets.
* Improved WordAI admin branding with the current WordAI icon in row actions, modal titles, editor metabox buttons, settings headers, and API key notices.
* Improved the WordAI API Key Required notice so it appears only on WordAI admin pages and explains the selected provider key requirement.
* Set WordAI Free runtime communication to use live SOFTCOY endpoints by default for public installs.
* Added Anthropic Claude provider support alongside OpenAI and Google Gemini.
* Added GPT-5.5 text model option.
* Added ChatGPT Images 2.0 / GPT Image 2 image model option while keeping GPT Image 1.5 as the default model for easier first image generation.
* Added AI Agent indexing and frontend AI Chat preview features.
* Added Support page with local diagnostics and SOFTCOY Support Office delivery.
* Added Get Pro upgrade flow for converting a licensed free install to WordAI Pro.
* Improved provider settings, image settings, upgrade messaging, and modal output cleanup for newer AI model responses.
* Added versioned database schema updater so new tables and columns are applied during normal wp-admin plugin updates.
* Updated WordPress.org screenshot assets to full-page plugin admin views.

= 2.0.0 =
* Major release with multi-provider support for OpenAI and Google Gemini.
* Added unified provider selector across settings and modals.
* Improved content and image settings experience.
* Updated prompts, models, and defaults for higher quality output.
* Highlighted WordAI Pro SEO Optimization features for upgrades.

= 1.0.0 =
* Initial WordAI release.
* Added AI post title, content, image, and title suggestion generation.
* Added SEO-friendly content writing controls.

== Frequently Asked Questions ==
= What is WordAI? =
WordAI is an AI content and image generation plugin for WordPress. It helps create post and page content, titles, excerpts, tags, AI images, and AI Chat responses from the WordPress admin.

= Do I need an API key? =
Yes. Add an API key for OpenAI, Google Gemini, Anthropic Claude, or xAI Grok in WordAI > API Settings. The required key depends on the AI provider you select.

= Which providers are supported in WordAI Free? =
WordAI Free supports OpenAI, Google Gemini, Anthropic Claude, and xAI Grok with provider-specific settings and model selection.

= Which OpenAI models are available? =
WordAI includes the GPT-5.6 Sol, Terra, and Luna family alongside GPT-5.5 and compatible OpenAI models. Image generation includes GPT Image 1.5 plus ChatGPT Images 2.0 / GPT Image 2 when available in your OpenAI account.

= Why is GPT Image 1.5 the default image model? =
GPT Image 1.5 is selected by default so most users can generate images immediately. Users who have access to newer image models can select them from WordAI > Image Settings.

= Can I generate images in the free version? =
Yes. WordAI Free supports standard AI image generation from inside WordPress.

= Can I use WordAI for WooCommerce products? =
WooCommerce product content and image workflows are available in WordAI Pro.

= What is AI Agent in the free version? =
The free version includes AI Agent content embedding and frontend AI Chat preview features. WordAI Pro unlocks the full premium AI Agent, analytics, automation, and conversion-focused workflow.

= Does WordAI update database tables during normal plugin updates? =
Yes. WordAI includes a versioned database updater that runs in wp-admin after plugin updates, so new or changed custom tables and columns can be applied without deactivating and reactivating the plugin.

= Why are my results truncated? =
This usually happens when API parameters are too strict. Reset to defaults in API Settings, then try again.

= I do not see generated output. What should I check? =
If your server blocks streaming, turn off Streaming in API Settings, save settings, and test again.
