🤖 AI Annotator for WordPress

AI-powered intelligent term detection and annotation system. Automatically analyzes your content, finds technical terms, and creates helpful explanations in multiple languages using OpenAI GPT.

✨ Key Features

🧠 Intelligent Term Detection
AI analyzes your content and automatically identifies technical terms that need explanation
🌍 Multilingual Support
Works with content in English, Russian, Spanish, French, and German
🔮 GPT-Powered Annotations
Generates clear, concise explanations using OpenAI's advanced AI models
💫 Beautiful Tooltips
Modern, responsive tooltips that enhance user experience
🎛️ Flexible Control
Global settings plus per-post controls for fine-tuned customization
⚡ Performance Optimized
Smart dual-level caching system minimizes API calls and improves loading times

🚀 Quick Start

Step 1: Install Plugin

  1. Upload plugin files to /wp-content/plugins/ai-annotator-wp/
  2. Activate through WordPress admin panel
  3. Navigate to Settings → AI Annotator in admin menu

Step 2: OpenAI API Setup

  1. Get API Key: Go to platform.openai.com/api-keys
  2. Add Balance: Visit platform.openai.com/settings/organization/limits and add payment method
  3. Set Spending Limit: Recommended $5-20 for most websites
  4. Paste Key: Enter your API key in plugin settings

Step 3: Configure Settings

🌍 Multilingual Support

AI Annotator intelligently detects your content language and provides annotations in the same language:

Supported Languages

How It Works

  1. Automatic Detection: Plugin detects your site's language from WordPress locale settings
  2. Smart Analysis: AI analyzes content in any language to find technical terms
  3. Native Explanations: Generates annotations in the same language as your content
  4. Context Aware: Explanations consider the specific context of your article

⚙️ Configuration Options

Global Settings

Per-Post Controls

Each post/page includes a meta box with:

💰 Pricing & Usage

OpenAI API Costs

Smart Cost Management

🔧 Troubleshooting

Plugin Not Working?

  1. Check WordPress version (6.0+ required)
  2. Verify PHP version (7.4+ required)
  3. Test with default theme to rule out conflicts

API Issues?

  1. Invalid Key: Verify your OpenAI API key is correct
  2. Quota Exceeded: Add balance to your OpenAI account
  3. Rate Limits: Reduce usage or wait before retrying

No Annotations Appearing?

  1. Check global "Enable Annotations" setting
  2. Verify per-post settings allow annotations
  3. Test with higher intensity setting
  4. Check if terms exist in content
  5. Use built-in Test Suite for diagnostics

❓ Frequently Asked Questions

Q: Do I need my own OpenAI account?
A: Yes, you need your own OpenAI API key and account with billing setup. This gives you full control over usage and costs.
Q: What happens when my OpenAI balance runs out?
A: Annotations will stop working. You'll see a warning in admin settings. Add balance at platform.openai.com/settings/organization/limits.
Q: How much will this cost me?
A: Very little! Most websites spend $1-5 per month. GPT-3.5-turbo costs about $0.001 per annotation, and each term is cached after first annotation.
Q: Can I control which terms get annotated?
A: Yes! The AI automatically finds relevant technical terms, but you control how many through intensity settings (Low/Medium/High) and max terms limits. You can set defaults globally and override per-post.
Q: Does it work with non-English content?
A: Absolutely! The plugin supports Russian, Spanish, French, and German content. It automatically detects your language and provides annotations in the same language.
Q: Will this slow down my website?
A: No. Annotations are generated once and cached. The system is designed for minimal performance impact with smart caching and lazy loading.
Q: Does it work with my theme?
A: Yes, it's designed to work with any properly coded WordPress theme. The tooltips use standard CSS and JavaScript.
Q: Can I customize the tooltip appearance?
A: The plugin includes beautiful default styling. Advanced users can customize CSS through their theme's stylesheet.
Q: What about SEO?
A: The plugin is SEO-friendly. Annotations are added via JavaScript after page load, so they don't affect your original content or search engine indexing.
Q: Can I export/import my annotations?
A: Currently no, but this feature is planned for future versions. Annotations are stored in your WordPress database.
Q: Is there a free version?
A: The plugin itself is a one-time purchase, but you need your own OpenAI API account for the AI functionality.

🆘 Getting Help

Before Contacting Support

  1. Check the FAQ above
  2. Use the built-in "Test Suite" to diagnose issues
  3. Try the API connection test in settings
  4. Check WordPress and PHP versions meet requirements

Support Channels

What to Include in Support Requests

📋 Technical Requirements

🔄 Updates & Changelog

The plugin includes automatic update notifications. Always backup your site before updating.

Version 1.0.0

🤖 AI Annotator - Making your content more engaging and informative with the power of AI.

Need help? Check the comprehensive guides in your WordPress admin area under Settings → AI Annotator.