=== Hoosh AI Assistant ===
Tags: ai, thumbnail, content generator, assistant, hoosh
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.2
Stable tag: 1.1.0
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

AI-powered WordPress assistant. Generate thumbnails, auto-complete titles & content, and suggest tags using OpenAI or Google Gemini.

== Description ==

**Hoosh** is your AI Copilot for WordPress. It brings powerful AI capabilities directly into your Gutenberg editor, allowing you to autocomplete sentences, generate images, and streamline your workflow without breaking your flow.

= Key Features =

**Smart Title Autocomplete**
Get real-time title suggestions as you type. The AI suggests completions based on your content context.

**Content & Text Block Completion**
Stuck on a paragraph? Let AI help you complete your thoughts with context-aware suggestions that flow naturally with your content.

**Intelligent Taxonomy Suggestions**
AI-powered tag recommendations based on your content. The system learns from your existing posts to suggest relevant, consistent tags.

**Automatic Excerpt Generation**
Generate compelling post excerpts with one click.

**AI Thumbnail Generation**
Create stunning featured images using DALL-E 3, DALL-E 2, or Nano Banana models.

**Learning Engine**
The plugin analyzes your published content to understand your blog's themes, topics, and writing style. This context improves all AI suggestions over time.

**Usage Tracking & Limits**
Monitor your AI token consumption with daily and monthly limits. Dashboard widget shows usage statistics.

**Interactive Status Indicator**
The header indicator lets you toggle AI features on/off instantly with visual feedback.

= Supported AI Providers =

* **OpenAI** – GPT-4o, GPT-3.5 Turbo for text generation
* **Google Gemini** – Gemini 2.5 Flash Lite, Gemini 3 Flash Preview for text generation
* **DALL-E** – DALL-E 3 and DALL-E 2 for image generation
* **Nano Banana** – Nano Banana and Nano Banana Pro for image generation (via Google Gemini)

= Requirements =

* WordPress 6.0 or higher
* PHP 8.2 or higher
* Gutenberg (Block) editor
* API key from OpenAI or Google Gemini

= External Services =

This plugin connects to external AI services to provide its functionality. By using this plugin, you agree to the terms of service of the respective providers:

**OpenAI API**
Used for text generation (GPT models) and image generation (DALL-E). When you use title completion, content completion, excerpt generation, or thumbnail generation with OpenAI, your content is sent to OpenAI's servers for processing.

* [OpenAI Terms of Use](https://openai.com/policies/terms-of-use)
* [OpenAI Privacy Policy](https://openai.com/policies/privacy-policy)

**Google Gemini API**
Used for text generation (Gemini models) and image generation (Nano Banana). When you use title completion, content completion, excerpt generation, or thumbnail generation with Google Gemini, your content is sent to Google's servers for processing.

* [Google Gemini API Terms of Service](https://ai.google.dev/gemini-api/terms)
* [Google Privacy Policy](https://policies.google.com/privacy)


== Installation ==

1. Upload the `hoosh-ai-assistant` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Navigate to **Settings → Hoosh AI** and enter your API key
4. Configure your preferred AI models and usage limits
5. Start creating content with AI assistance!

= Minimum Requirements =

* WordPress 6.0 or higher
* PHP 8.2 or higher
* Gutenberg (Block) editor
* At least one API key (OpenAI or Google Gemini)

== Frequently Asked Questions ==

= Do I need an API key? =

Yes, you need at least one API key to use this plugin:

* **OpenAI API key** – For GPT models and DALL-E image generation
* **Google Gemini API key** – For Gemini models and Nano Banana image generation

= Which AI provider should I choose? =

* **OpenAI** – Best overall quality with GPT-4o, supports both text (GPT models) and images (DALL-E)
* **Google Gemini** – Fast and efficient with Gemini 2.5 Flash Lite for text and Nano Banana for images

= Can I use multiple providers? =

The plugin supports one active provider at a time. You can switch between OpenAI and Google Gemini in the settings. Each provider handles both text and image generation. Your API keys for both providers are stored separately, so switching is seamless.

= How does the Learning Engine work? =

The Learning Engine analyzes your published posts to understand your blog's themes, topics, and writing style. This context is used to improve taxonomy suggestions and ensure AI recommendations match your content strategy. You can view and update the Learning Engine context in Settings → Hoosh AI under the Learning Engine section.

= Can I set usage limits? =

Yes, configure daily and monthly token limits in settings. Set to 0 for unlimited usage. The dashboard widget shows your current consumption.

= Which post types are supported? =

Posts and pages by default. Add custom post types using the `hoosh_ai_supported_post_types` filter.

= How do I control who can use AI features? =

The plugin includes custom capabilities for each feature. Administrators have all capabilities by default. Use a role management plugin to assign capabilities to other roles.

= What data is sent to external services? =

When using AI features, the following data may be sent to the configured AI provider:

* Post title and content (for text completion and suggestions)
* Image generation prompts (for thumbnail generation)
* Site context from the Learning Engine (for improved suggestions)

== Screenshots ==

1. Settings page with API key configuration and AI provider selection.

== Changelog ==

= 1.1.0 - 2026-01-01 =

* Added Google Gemini as an AI provider
* Text models: Gemini 2.5 Flash Lite, Gemini 3 Flash Preview
* Image models: Nano Banana, Nano Banana Pro
* Provider selection and API key management in settings

= 1.0.3 - 2025-12-29 =

**Initial Release**

Features:

* Smart title autocomplete
* Content and text block autocomplete
* One-click excerpt generation
* AI-powered tag suggestions
* One-click thumbnail generation

AI Providers:

* OpenAI provider support (GPT-4o, GPT-3.5 Turbo)

== Upgrade Notice ==

= 1.1.0 =
New Google Gemini provider support! Configure your Gemini API key in Settings → Hoosh AI to use Gemini 2.5 Flash Lite for text and Nano Banana for images.

= 1.0.0 =
Initial release of Hoosh AI Assistant. Configure your API keys in Settings → Hoosh AI to get started.

== Privacy Policy ==

Hoosh AI Assistant connects to external AI services to provide its functionality. Please review the External Services section in the Description for details about data transmission and third-party privacy policies.

The plugin stores the following data locally:

* API keys (in WordPress options)
* Usage statistics (token counts, operation logs)
* Learning Engine context (site themes and topics)

No personal user data is collected or transmitted by the plugin itself.
