=== AI Block Editor === Contributors: virgildia Tags: ai, gutenberg, block-editor, openai, ai-blocks, theme-json Requires at least: 5.8 Tested up to: 6.9.4 Stable tag: 1.0.5 Requires PHP: 7.0 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html == Description == AI Editor adds an AI assistant to the Gutenberg editor for adding blocks and updating content. It can generate full sections or modify selected blocks using simple or complex prompts. Powered by the latest OpenAI models, it also supports using your own API key. When your theme uses theme.json, AI Editor can follow your global styles, presets, and design tokens like colors, typography, spacing, and layout so generated blocks match your site’s design system. **Major updates released in May 2026:** theme.json style matching, selected block editing, and newer AI models with reasoning controls. = Features = - **Natural language block creation**: Describe your desired content in plain language and the AI will handle the rest. - **All core Gutenberg blocks for insertion**: AI Editor can insert supported `core/*` Gutenberg blocks using canonical block markup. - **Selected block editing**: Select one or more blocks in Gutenberg and ask AI Editor to update the selected content or layout. - **Custom block editing**: Custom and third-party blocks can be edited after you add and select them. AI Editor uses the markup it can see for the selected block, so review the result because custom blocks may have private fields, dynamic rendering, or plugin-specific rules the AI cannot fully infer. - **Theme-aware output**: For themes that use theme.json, AI Editor can use your theme's presets and editor settings to keep generated layouts consistent with your site's colors, spacing, typography, and other design styles. - **Resizable sidebar**: Drag the left edge of the AI Editor sidebar to make the chat panel wider. - **GPT model selection**: Choose from supported GPT models, with GPT-5.5 recommended by default when available for your API key. - **Reasoning effort controls**: Choose how much reasoning the model should use for faster simple edits or more careful complex layout work. - **Conversation context controls**: Limit how many recent chat messages are sent with each request. - **Prompt caching**: AI Editor keeps repeated system instructions stable so OpenAI prompt caching can reuse shared context when available, helping monitor API usage and reduce repeated input processing. - **Theme compatibility check**: Review whether the active theme is a good fit for AI Editor's Gutenberg and theme style workflow. - **BYOK**: Use your own OpenAI API key. - **Language translation**: Multilingual support. = Prompt Examples = - "Add this article as a magazine-style layout using blocks: (paste article here)." - "Create a layout for an About Us page, including sections for a mission statement, team members, and contact." - "Add 3 columns, each with a pricing plan." - "Create a table comparing the caffeine content of popular drinks." - "Rewrite this testimonial block to sound more concise." - "Update the selected columns for better balance." = Getting The Best Results = - **Quickly add content blocks**: Ask AI Editor to add headings, sections, buttons, lists, tables, columns, and other core blocks for your content. - **Turn full copy into blocks**: Paste a full page draft or section copy and ask AI Editor to convert it into Gutenberg blocks. You can guide which blocks to use, or let AI Editor choose the block structure. - **Use the latest recommended model**: For the best results, use the latest supported model available to your OpenAI account. GPT-5.5 with reasoning set to `medium` is a good starting point for more complex layouts. - **Select the right amount of content**: If the change depends on a parent layout, columns, group spacing, or surrounding section structure, select the whole relevant block or section and say what you want changed. - **Use narrow selections for simple edits**: If you only need a specific text, button, heading, or single block changed, select just that block and give a direct instruction. = Settings = Navigate to Settings -> AI Editor to configure the plugin. - **OpenAI API Key**: Add your own OpenAI API key. Requests are sent from your WordPress site to OpenAI. - **GPT Model**: Choose the model AI Editor should use. The settings page marks the recommended model. - **Reasoning Effort**: Choose `none`, `low`, `medium`, `high`, or `xhigh`. Lower values are faster for simple edits; higher values can help with larger layouts or more careful restructuring but may take longer and use more tokens. - **Theme Style Context For AI**: A short style note used as design direction. AI Editor can rewrite the active theme description with AI. Raw theme presets are handled separately, so this field should stay short and human-readable. - **Limit Conversation Context Sent To OpenAI**: Turn on/off trimming of older chat messages before sending a new request. - **Max Messages In Conversation Context**: Set how many recent messages are kept when conversation context trimming is enabled. - **Theme Compatibility For AI Editor**: Run a compatibility check for the active theme. It reviews Gutenberg support, block theme signals, editor style support, and available theme presets so you can spot where manual cleanup may be needed. **Note**: AI Editor is powered by OpenAI's GPT technology. For more information on the data handling and privacy aspects, please refer to OpenAI's [Privacy Policy](https://openai.com/privacy) and [Terms of Service](https://openai.com/terms). == Requirements == PHP 7.0+ is recommended, WordPress 5.8+, with Gutenberg active. An OpenAI API key is required. == Installation == 1. From your WordPress dashboard, go to **Plugins > Add New**. 2. Search for **AI Editor** in the **Search Plugins** box. 3. Click **Install Now** to install the AI Editor Plugin. 4. Click **Activate** to activate the plugin. 5. In the WordPress menu, go to **Settings -> AI Editor** to add your OpenAI API key and select the desired GPT model. 6. Open the Gutenberg editor for your post or page. 7. Click on the three dots in the top-right corner to expand the options menu. 8. Under the **Plugins** section, click on **AI Editor** to enable the AI sidebar. 9. Once the AI Editor sidebar appears, you may click the star icon at the top of it. This action pins the AI Editor to the toolbar for quick access. 10. Ask the AI to add blocks or layouts by providing descriptions. == Screenshots == 1. Using AI Editor to add blocks. 2. AI Editor in the Gutenberg sidebar. 3. Creating tables quickly. 4. Adding and editing blocks. 5. Settings page for AI Editor. == Frequently Asked Questions == = What is Gutenberg? = Gutenberg is the modern block-based editor in WordPress, allowing users to create content using a variety of blocks. = How do I use AI Editor? = Once installed, go to the Gutenberg editor, enable the AI Editor sidebar, and start adding blocks by describing to the AI what you need. = Do I need an OpenAI API key? = Yes, an OpenAI API key is required to use the AI Editor. You can enter your API key in the plugin settings. = Are there any plugin limitations? = - AI Editor can insert core Gutenberg blocks. Custom and third-party blocks should be added manually first, then selected for editing. - Custom block edits depend on the selected markup AI Editor can see. Some custom blocks store data outside saved markup or render dynamically, so AI Editor may make mistakes and you should review the result. - New image blocks are blank placeholders. AI Editor does not add external image URLs, Unsplash images, generated image sources, or media library items. - AI Editor uses your theme settings when they are exposed through theme.json. If your theme does not provide theme.json settings, AI Editor cannot see all of your theme styles, so the final look and feel will depend more on your theme's default styling. --- == Changelog == = 1.0.5 = - Support for GPT-5.4 and GPT-5.5 models, with GPT-5.5 as the recommended default. - Selected block editing for one or more selected blocks. - Theme-aware output using active editor settings and theme.json presets when available. - Prompt caching for repeated AI Editor system instructions. - Reasoning-effort settings for balancing speed and more careful layout work. - Conversation context controls. - Theme style context generation from the active theme description. - Theme compatibility checks for AI Editor's Gutenberg workflow. - Resizable AI Editor sidebar. - Updated translation template and added translator comments for placeholder strings. = 1.0.4 = Added GPT-4.1 model. = 1.0.3 = Added GPT-4o mini model. = 1.0.2 = UI updates. = 1.0.1 = Added GPT-4o model. = 1.0.0 = First release of the plugin.