NB AI Buttons v2.5.2

Context-aware AI text generation & media creation attached to textareas, inputs, and page builders. Supports WP AI Connector, NVIDIA AI Direct, Gemini Direct, Custom OpenAI, Pollinations.ai Free Images, ClearBackdrop Background Removal, Kilo Gateway Free Agent Models, and External Prompt Export / Result Paste workflows. Full TinyMCE Visual Editor integration.

Features

• Automated Page Builder Skills: Dedicated expert skill prompts for WordPress Core, WPBakery Page Builder, Divi Builder, and Elementor Pro automatically loaded based on site theme/plugins.
• Clean Field Injection: Selective field injection to prevent overcrowding standard text inputs.
• WPBakery AI Integration: Shortcode generator, structured markup transformers, and WPBakery expert skill directives.
• TinyMCE Visual Editor Integration: Direct reading and injection into TinyMCE Visual mode (`getContent`/`setContent`).
• Multi-Provider AI Engine: Use native WP AI Connector, NVIDIA AI Foundation Models (Llama 3.1/3.3, Gemma 4, Nemotron, DeepSeek, Qwen), Google Gemini Direct, Custom OpenAI, Kilo Gateway, or Pollinations.ai free image generation.
• Free Models Built-In: NVIDIA NIM free tier, Pollinations.ai (no key), ClearBackdrop background removal (no key), Kilo Gateway (local agent models).
• Background Removal: One-click background removal via ClearBackdrop API. Returns transparent PNG. No API key needed.
• Media Generation Provider Options: Choice between (Recommended) WordPress 7 AI Connector (Gemini Nano & Multi-Modal), Direct Gemini API, OpenAI DALL-E 3 & GPT-4o Omni Vision, Pollinations.ai Free Images, or ClearBackdrop Background Removal.
• Unified Orange AI Badges: Simplified clean AI buttons across Media Modal, Featured Image box, and admin fields with modal z-index layer fix.
• Post Excerpt Auto-Targeting: 'Create Excerpt' preset outputs automatically fill Classic & Gutenberg Excerpt fields.

Changelog

v2.5.2 - 2026-09-06

• Added PHPDoc type annotations to class properties and helper methods in NB_AI_Buttons_Ajax.

v2.5.1 - 2026-09-06

• Fixed PHP syntax error in admin custom model display ternary expression.

v2.5.0 - 2026-09-06

• Standardized admin settings interface to match NetBound ecosystem conventions (standard nb_admin_header, Hub links, brand orange accents, and balanced 3-column layout).
• Refactored WordPress 7 AI Connector integration to support all native client signatures (wp_ai_prompt, wp_ai_client_prompt, WordPress\AiClient\AiClient, and WP_AI_Connectors).
• Eliminated silent fallbacks to Direct Gemini API: explicitly returns WP 7 AI Connector responses, notices, or actionable approval links.
• Enriched media generation diagnostics with clear provider notices and prevented unintended fallback cascades.

v2.4.0 - 2026-09-04

• Added NVIDIA free models dropdown with Gemma 4, Llama 3.1/3.3, Nemotron, DeepSeek, Qwen free models.
• Added Pollinations.ai free image generation provider (no API key needed).
• Added Kilo Gateway provider mode for free agent models via local gateway.
• Added ClearBackdrop free background removal (no API key needed, 100 images/hr).
• Added Remove Background button in AI Image tab for transparent PNG cutout.
• Updated capability detection and fallback chains to include all new free providers.

v2.3.1 - 2026-08-18

• Removed standalone ? AI help buttons from form fields and section headers in favor of the integrated AI chat assistant.

v2.3.0 - 2026-08-15

• Enhanced WordPress 7 AI Connector media execution path to route image generation through Google Gemini Nano & Multi-Modal models registered in WP Tools. Made WP 7 AI Connector the recommended default Media Provider.

v2.2.9 - 2026-08-15

• Added gemini-3.0-pro-image (Gemini Pro 3 Multi-Modal Image Generation & Edit) and Omni Flash model options (gemini-2.5-flash, gemini-2.0-flash-exp, gpt-4o-mini) to settings selectors.

v2.2.8 - 2026-08-15

• Added configurable model controls for Gemini Image Generation/Editing (imagen-3.0-generate-002 / imagen-3.0-fast-generate-001 / imagen-3.0-capability-001) and Video Generation (veo-2.0-generate-001 / veo-3.1-generate-001).

v2.2.7 - 2026-08-15

• Added OpenAI DALL-E 3 & GPT-4o Omni Vision Media Provider option.
• Enhanced multi-modal reference image editing (Gemini 2.5 Flash Vision & GPT-4o Omni conditioning for image modifications).

v2.2.6 - 2026-08-15

• Removed AI Media Studio admin page and launcher button.
• Switched Direct Gemini image generation to active imagen-3.0-generate-002 and imagen-3.0-fast-generate-001 models.

v2.2.5 - 2026-08-15

• Enhanced WP AI Connector 403 Forbidden diagnostic messaging with step-by-step resolution options.

v2.2.4 - 2026-08-15

• Removed first box preset saves controls from Column 1.
• Organized Provider Mode selector with clear <optgroup> categories and added API Selection Priority guide box explaining WordPress 7 AI Connector vs Direct Model APIs.

v2.2.3 - 2026-08-15

• Placed inline <style> block directly in admin_page_html() (matching nb-category-grid) to guarantee CSS styling is always output regardless of menu page hook names.
• Updated enqueue_admin_assets() hook condition to match all nb-ai-buttons page handles.

v2.2.2 - 2026-08-15

• Removed external nb-hub file loading (nb-shared-admin-functions.php) to prevent shared Hub CSS override conflicts.
• Ensured 100% self-contained admin page styling matching nb-category-grid 3-column equal grid standard.

v2.2.1 - 2026-08-15

• Restored admin UI layout, NetBound corporate color standards, header call, and 3-column equal grid (.nb-cga) to match nb-category-grid standard.
• Fixed double-wrapped .wrap container element causing header and grid padding issues in WordPress admin dashboard.
• Updated section headers with Font Awesome 6 icons and NetBound orange accent styling.

v2.2.0 - 2026-08-14

• Fixed Admin Settings page 3-column equal grid responsive breakpoint (900px) so layout displays properly side-by-side on desktop screens.
• Added live Operational Test button (⚡ Run Operational Test) in the Admin Sandbox column with execution latency timing and status badge.
• Clarified Google Gemini API Key requirement (optional when WP AI Connector is active).
• Rebranded Admin Bar toolbar node to clean ai badge matching plugin suite styling and added 💡 Help with this Page action to slide-over AI chat drawer.
• Updated Page Builder skill context guidance for WP Core, Divi, Elementor, and WPBakery.

v2.1.0 - 2026-08-13

• Cleaned up auto-injected buttons on form fields to prevent overcrowding on standard inputs.
• Added contextual ? AI help buttons for field assistance and descriptions on complex admin/post setting areas.
• Added WPBakery Page Builder AI integration: wpbakery-expert skill, shortcode generator, and structured markup transformers alongside Divi, Elementor, and Gutenberg.

v2.0.0 - 2026-08-11

• Styled Admin Bar node to a vibrant NetBound orange button with bold white label.
• Added Direct API fallback (Gemini, NVIDIA, OpenAI) for AI Chat when WP AI Connector returns 403 Forbidden or errors.
• Added active provider/model badge to the AI Chat drawer header and context bar.
• Added AJAX failure handler to clear loading spinner on network/API errors.
• Added recommendation note for `nb-crash-block` plugin when modifying code with AI.

v1.9.8 - 2026-08-06

• Restricted inline field AI buttons (`.nb-ai-attach-btn`) strictly to Post/Page Editor screens and Media Library screens.
• Cleaned up attach buttons from general admin screens, settings pages, options, and non-content fields.

v1.9.7 - 2026-08-06

• Removed the bottom-right AI button in the WordPress Media Library modal to keep toolbar controls unobstructed.
• Implemented smooth hover shift animation for AI field buttons (`.nb-ai-attach-btn`), moving them up on hover to reveal underlying text and form content.

v1.9.6 - 2026-08-06

• Fixed JavaScript reference error in Sidebar AI Chat initialization.
• Attached Active Theme (with version), Active Plugins list, Registered Shortcodes list, and Category terms to AI context.
• Implemented Gemini 2.5 Flash Multi-Modal Vision processing for Reference Image conditioning.
• Added automatic generated image clipboard copying with toast confirmation notice.
• Added Clear Form & Re-Generate Image buttons to the Image modal tab.

v1.9.5 - 2026-08-06

• Added Copy Output button to each AI Chat response message in the Sidebar AI Assistant drawer.
• Added Clear Chat history button to header of the Sidebar AI Assistant drawer.
• Enforced structured multi-paragraph sentence formatting and paragraph breaks in AI chat response outputs.

v1.9.4 - 2026-08-06

• Implemented modal blink-out and return flow for Reference Image picker to eliminate dual modal conflicts.
• Added automatic reference image pre-loading when opening AI generator from selected Media Library items or Media Modal.
• Added persistent Reference Image Presets ("My Face", "Logo", etc.) with single-click selection and "+ Save Current as Preset".
• Added Claymation to image style presets and enabled saving combined custom Style & Reference Presets.
• Added Aspect Ratio selector (`1:1`, `16:9`, `9:16`, `4:3`, `3:4`) for Imagen direct media generation.
• Improved visual centering and alignment of AI buttons on single-line inputs, textareas, and media toolbars.

v1.9.3 - 2026-08-06

• Removed AI attach buttons from all WordPress search fields and search forms.
• Removed icons/emojis from the Admin Toolbar and streamlined AI Chat trigger to a clean orange `ai` button.
• Removed the redundant Admin Toolbar settings node.

v1.9.2 - 2026-08-06

• Added HTML paragraph (`

  `), bold (``), and heading (`

  `) formatting instructions and `formatTextToHtml` parser for clean multi-paragraph text editor output.

• Implemented WordPress Media Modal (`wp.media`) frame selector for Reference Image selection.
• Removed emojis from all orange buttons and adjusted Media Library button height for consistent Admin UI alignment.
• Excluded AI attach button from appearing inside the Sidebar AI Chat prompt box.
• Refined Featured Image prompt builder to use Post Title strictly and added Featured Image status banner notice.

v1.9.1 - 2026-08-06

• Switched Direct Gemini Image endpoint to verified `imagen-4.0-generate-001` model (`:predict` endpoint returning HTTP 200 OK).
• Added automated Featured Image prompt builder from page title and content context.
• Added automatic fallback from WP AI Connector timeout errors (`cURL error 28`) to Direct Gemini API when API key is present.

v1.9.0 - 2026-08-06

• Added Media Generation Provider setting (Direct Gemini API vs WP Connector) with live provider notification badges.
• Fixed Imagen 3 REST API endpoint parameters (`generateImages` & `predict` dual-endpoint fallback).
• Simplified all Media Modal & Post Editor buttons to clean orange AI badges and set modal `z-index: 999999` to prevent overlay conflicts.
• Updated 'Create Excerpt' preset output to automatically populate Classic and Gutenberg post Excerpt fields.

v1.8.3 - 2026-08-06

• Moved preset directive pills below the prompt textarea and updated click behavior to append text without instant auto-generating.
• Added `wp_ajax_nb_ai_buttons_generate` action alias in PHP to prevent AJAX action mismatch.
• Implemented missing client-side `generateMedia` handler so AI Image & Video Studio buttons trigger spinning indicators and generate media outputs.

v1.8.2 - 2026-08-06

• Fixed fatal PHP Error (`Call to private NB_AI_Buttons_Ajax::__construct()`) on page load by invoking `NB_AI_Buttons_Ajax::get_instance()`.

v1.8.1 - 2026-08-06

• Rewrote WordPress AI Connector API execution engine (`call_wp_connector_api`) with multi-method resolution across `wp_ai_client_prompt`, `WordPress\AiClient\AiClient`, `wp_ai_get_client`, `wp_ai_client`, and `wp_ai_generate_text` filters.
• Added detailed, actionable error diagnostics when WordPress AI Connector returns `InvalidArgumentException` or unapproved model errors.

v1.8.0 - 2026-08-06

• Added automated Page Builder Expert Skills system (`wp-expert.txt`, `divi-expert.txt`, `elementor-expert.txt`) that detects site builder and injects specialized context into AI chat.
• Streamlined Admin Bar menu item to sleek orange `AI` badge and fixed Admin Bar Chat drawer trigger event binding.
• Added `Explain Concept` preset prompt pill to AI Assistant modal window.
• Improved WP AI Connector model approval diagnostics and clear user error messages when Google Connector needs model approval on `tools.php?page=ai-connector-approval`.

v1.7.3 - 2026-08-06

• Fixed PHP syntax error (unmatched closing brace) in main plugin class definition.

v1.7.2 - 2026-08-06

• Added `nb_hub_registered_modules` ecosystem integration hook for seamless detection inside NetBound Hub (`nb-hub`).
• Verified zero-dependency standalone operation when `nb-hub` is not present.

v1.7.1 - 2026-08-06

• Simplified TinyMCE toolbar button label from 'AI Assist' to 'AI'.
• Removed redundant teeny right-side attach button from main post editor textareas.

v1.7.0 - 2026-08-06

• Added 'AI Image Studio' navigation tab and button directly inside the WordPress Media Modal (`wp.media` frame).
• Added 'AI Generate Featured Image' button attached to Post Editor Featured Image meta box (Classic Editor) and Gutenberg inspector panel.
• Integrated automatic `setAsFeaturedImage` helper linking generated media directly to `featured_media` in Gutenberg (`wp.data.dispatch('core/editor')`) and `#_thumbnail_id`.

v1.6.1 - 2026-08-06

• Added automatic copy of generated text output directly to system clipboard upon completion.
• Added dedicated 'Copy Output Text' manual button to assistant modal.
• Fixed post editor content insertion for TinyMCE Visual Mode and Gutenberg Block Editor (`wp.data.dispatch('core/editor')`).

v1.6.0 - 2026-08-06

• Added direct link button to WP AI Connector Approval page (`tools.php?page=ai-connector-approval`) on settings admin screen.
• Enforced strict front-end security: unauthenticated visitors are prevented from accessing AI buttons or calling AJAX endpoints.
• Added far-right Admin Bar slide-over Sidebar AI Chat drawer with site awareness, file attachment upload, and "(This chat uses token credits)" indicator.

v1.5.1 - 2026-08-06

• Fixed `WordPress\AiClient\Common\Exception\InvalidArgumentException` error (`No models found that support text_generation for this prompt`).
• Caught `Throwable` in WP AI Client connector handler to prevent unhandled PHP exceptions.
• Added automatic fallback to Direct APIs (Gemini, NVIDIA, OpenAI) when WP AI Client has no active models configured.
• Improved AJAX error message formatting for `WP_Error` objects and JSON error responses.

v1.5.0 - 2026-08-05

• Added native TinyMCE Visual Editor integration with `getContent({format:'text'})` and `setContent()`.
• Widened modal window to 850px with responsive flex wrapping for output buttons.
• Fixed preset pill triggers: automatically populates prompt box with clear instructions to prevent empty prompt API errors.

v1.4.3 - 2026-08-05

• Fixed WP Connectors API detection to support `wp_ai_client_prompt()`, `wp_ai_get_client()`, `WP_AI_Connectors`, and `WP_AI_Client` signatures.

v1.4.2 - 2026-08-05

• Enhanced configuration guidance and fallback resolution when WP Connectors API is not installed.

v1.4.1 - 2026-08-05

• Fixed `Error: [​object Object]` text window output by implementing safe string unboxing for WP AI Connector response objects and JS string serialization.

v1.4.0 - 2026-08-05

• Added native integration for NVIDIA AI Foundation Models via OpenAI chat/completions REST standard with Bearer auth.
• Added custom OpenAI-compatible API support with custom endpoint/model settings.
• Added "Copy Prompt for External Engine" button to export formatted, context-enriched prompts to clipboard.
• Added "Paste External Result" tab in assistant modal to insert text generated on online AI engines directly into fields.
• Dynamic capability detection querying active WP Connector and direct API settings.

v1.3.1 - 2026-08-05

• Removed all ecosystem/bootstrap dependencies. Fully standalone — no nb-hub or nb-gemini-ai required.
• Deleted nb-ecosystem-bootstrap.php.
• Activation hook now initializes default options directly.

v1.3.0 - 2026-08-05

• Fixed text and media generation pipeline: now uses WP 7.0 Connectors API (`wp_ai_get_client`) with optional Gemini REST API fallback.
• Superior field context awareness: scrapes field name/id/placeholder/labels/metabox/block type/form context.
• Enhanced page context: extracts titles, headings, body content, meta descriptions, post metadata.
• Capability-aware UI: Image and Video tabs only show if connector/API supports them.
• Gemini API fallback toggle on setup page with API key input.
• Button label simplified to compact 'ai' pill.
• Renamed 'Studio' to 'Media' throughout.

v1.2.0

• Added page context awareness.

v1.1.1

• Minor UI fixes and performance improvements.

v1.1.0

• Added image generation (Studio).

v1.0.0

• Initial release with context-aware text generation.