SmartyPress AI Engine – ChatGPT, Bots, Content generation

SmartyPress AI Engine is a powerful AI engine that integrates artificial intelligence directly into your WordPress Gutenberg editor. Generate high-quality content with OpenAI or Deepseek using two powerful methods: AI Content Generator panel and Magic Wand inline editing.

Key Features

AI Content Generator Panel:
* Generate SEO-optimized titles
* Create full blog post content
* Generate excerpts and summaries
* Suggest relevant categories
* Bulk generate up to 50 posts at once

Magic Wand (Inline Editing):
* Generate content directly in any block
* Custom prompts for precise control
* 10+ pre-built actions (enhance, correct, translate, etc.)
* Replace mode – instant content replacement
* Suggest mode – choose from multiple AI-generated variants
* Works with Paragraph, Heading, List, Quote, Code blocks

Supported AI Providers:
* OpenAI (GPT-4o, GPT-4o Mini, GPT-4 Turbo, GPT-3.5 Turbo)
* Deepseek (Deepseek Chat, Deepseek Coder)

Main Features

Content Generation:
* Title generation with SEO optimization
* Full article/post content generation
* Excerpt and summary generation
* Category suggestions from existing categories

Magic Wand Actions (10+):
* Generate Content – create new content from prompts
* Enhance Text – improve readability and quality
* Correct Text – fix grammar and spelling
* Longer Text – expand content with details
* Shorter Text – condense while keeping key points
* Translate Text – translate to any language
* Generate Title – create 5 title variants
* Generate Excerpt – create 3 excerpt variants
* Suggest Synonyms – get 5 synonym options
* Generate Alt Text – for images

Advanced Features:
* Bulk post generation (1-50 posts)
* Custom prompts for precise control
* WordPress filters for developers
* Support for all public post types
* Multi-language support
* Real-time content insertion

Supported AI Models

OpenAI:
* GPT-4o
* GPT-4o Mini
* GPT-4 Turbo
* GPT-3.5 Turbo

Deepseek:
* Deepseek Chat
* Deepseek Coder

Use Cases

This AI engine is perfect for:
* Blog content creation
* Product descriptions
* Landing page copy
* Social media posts
* Email newsletters
* Documentation

External Services

IMPORTANT: This plugin connects to third-party AI services to generate content. Please read this section carefully.

Services Used

This plugin uses the following external AI services:

1. OpenAI API (optional)
* Service: OpenAI’s language models for content generation
* Purpose: Generate titles, content, excerpts, and other text when OpenAI is selected as provider
* Data sent: Your prompts, post titles, content excerpts, and generation parameters (temperature, max tokens)
* When: Only when you explicitly click a generate button or use Magic Wand
* Terms of Service: https://openai.com/policies/terms-of-use
* Privacy Policy: https://openai.com/policies/privacy-policy
* API Documentation: https://platform.openai.com/docs

2. Deepseek API (optional)
* Service: Deepseek’s language models for content generation
* Purpose: Generate titles, content, excerpts, and other text when Deepseek is selected as provider
* Data sent: Your prompts, post titles, content excerpts, and generation parameters (temperature, max tokens)
* When: Only when you explicitly click a generate button or use Magic Wand
* Terms of Service: https://www.deepseek.com/en/terms
* Privacy Policy: https://www.deepseek.com/en/privacy
* API Documentation: https://platform.deepseek.com/docs

Data Transmission Details

What data is sent:
* User prompts and instructions
* Post/page titles (when generating content)
* Post/page content excerpts (when generating excerpts or categories)
* Selected text from blocks (when using Magic Wand)
* Generation settings (temperature, max tokens, model name)

What data is NOT sent:
* User personal information
* Email addresses
* Passwords
* WordPress user data
* Site configuration
* Database information
* Other posts/pages content (unless explicitly selected)

When data is sent:
* Only when you actively click a “Generate” button
* Only when you use Magic Wand and click “Generate”
* Never automatically or in background
* Never without your explicit action

Data storage:
* API keys are stored in your WordPress database
* Generated content is stored in your WordPress database
* No content is stored on third-party servers after generation
* API providers may temporarily cache requests per their policies

Your Control

• You choose which AI provider to use (OpenAI, Deepseek, or both)
• You control when generation happens (manual clicks only)
• You can deactivate the plugin anytime to stop all data transmission
• You can delete your API keys from Settings at any time

Privacy & GDPR

This plugin is GDPR compliant with the following considerations:

• User Consent: Users must configure API keys, implying consent to use AI services
• Data Minimization: Only necessary data is sent to AI providers
• Right to Delete: You can delete all plugin settings and API keys anytime
• Transparency: All data transmission is documented in this section
• No Tracking: Plugin does not track users or collect analytics

For Site Owners:
If you use this plugin on a site with EU users, inform them in your privacy policy that:
* Content may be generated using third-party AI services
* User-provided content/prompts may be sent to OpenAI and/or Deepseek
* Refer users to AI providers’ privacy policies (links above)

How to Use

Quick Start Guide

Start using the AI engine with these simple methods:

Method 1: AI Content Generator Panel (Full Posts)

1. Go to Posts → Add New (or edit existing post)
2. In right sidebar, find “AI Content Generator” panel
3. Click generation buttons:
   • Generate Title – Creates SEO-optimized titles
   • Generate Content – Creates full article
   • Generate Excerpt – Creates summary
   • Generate Categories – Suggests categories
4. Generated content populates fields automatically
5. Review and edit as needed
6. Publish!

Method 2: Magic Wand (Inline Editing)

1. Add any block (Paragraph, Heading, Quote, etc.)
2. Click the magic wand icon in block toolbar
3. Enter your custom prompt:
   • “Write about benefits of AI in content creation”
   • “Explain WordPress REST API for beginners”
   • “Create a compelling product description”
4. Select AI provider (OpenAI or Deepseek)
5. Click Generate
6. Content appears in your block instantly!

Method 3: Bulk Generation (Multiple Posts)

1. Go to SmartyPress AI → Bulk Generator
2. Enter topics, one per line:
   WordPress Security Best Practices
How to Optimize WordPress Speed
SEO Tips for Bloggers
3. Configure settings:
   • Post Type (post, page, etc.)
   • Post Status (draft, publish)
   • Author
   • AI Provider
4. Click Generate Posts
5. Plugin creates posts with full AI content

Magic Wand Actions

Text Enhancement:
* Enhance Text – Improve quality, readability, engagement
* Correct Text – Fix grammar, spelling, typos
* Longer Text – Expand with details (3x length)
* Shorter Text – Condense to half length
* Translate Text – Translate to any language

Content Generation:
* Generate Content – Create new content from custom prompt
* Generate Title – Get 5 title suggestions (suggest mode)
* Generate Excerpt – Get 3 excerpt variants (suggest mode)
* Suggest Synonyms – Get 5 synonym options (suggest mode)
* Generate Alt Text – Create alt text for images

Using Suggest Mode

Some actions (Title, Excerpt, Synonyms) provide multiple variants:

1. Click Magic Wand on block
2. Select action (e.g., “Generate Title”)
3. Click Generate
4. Modal shows AI-generated variants
5. Select your favorite with radio button
6. Click Apply Selected to insert
7. Or click Regenerate for new variants

Custom Prompts Tips

Be specific:
❌ “Write something”
✅ “Write a 300-word introduction about WordPress security best practices”

Provide context:
❌ “Improve this”
✅ “Improve this text to sound more professional and add technical details”

Specify language:
❌ “Translate”
✅ “Translate to Spanish maintaining formal tone”

Set tone/style:
✅ “Write in casual, conversational tone”
✅ “Write formally for business audience”
✅ “Write in storytelling style with examples”

Keyboard Shortcuts

• Ctrl+Enter (or Cmd+Enter) – Generate in modal
• ESC – Close modal without generating

Privacy

This plugin sends data to external AI services. For complete privacy information, see the “External Services” and “Privacy & GDPR” sections above.

Contributing

Contributions are welcome! Please submit pull requests or open issues on GitHub.

Tech Stack

Modern AI engine built with:
* PHP 8.0+ with OOP
* React 18+ with WordPress Gutenberg components
* Vite for bundling
* SCSS for styling
* WordPress REST API

Credits

Developed by Alex Kovalev

Automatic Installation

1. Go to Plugins > Add New in your WordPress admin
2. Search for “SmartyPress AI Engine”
3. Click Install Now and then Activate
4. Go to SmartyPress AI > Settings
5. Enter your API keys (OpenAI and/or Deepseek)
6. Save settings and start generating content!

Manual Installation

1. Download the plugin zip file
2. Upload to /wp-content/plugins/ directory
3. Extract the files
4. Activate through the Plugins screen
5. Configure API keys in SmartyPress AI > Settings

Getting API Keys

OpenAI:
1. Visit https://platform.openai.com
2. Sign up or log in
3. Go to API Keys section
4. Create new secret key
5. Copy the key to plugin settings

Deepseek:
1. Visit https://platform.deepseek.com
2. Sign up or log in
3. Go to API Settings
4. Create new API key
5. Copy the key to plugin settings

Building from Source (For Developers)

The plugin uses Vite for building React components. Pre-built assets are included, but if you want to modify the frontend:

Requirements:
* Node.js 18 or higher
* npm or yarn

Build process:

`bash

Navigate to plugin directory

cd wp-content/plugins/smartypress-ai-engine/assets

Install dependencies

npm install

Build for production

npm run build

Or build individual components

npm run build:gutenberg # Builds AI Generator panel
npm run build:wand # Builds Magic Wand functionality

Development mode with hot reload

npm run dev
`

What gets built:
* dist/gutenberg-plugin.js – AI Content Generator panel
* dist/gutenberg-plugin.css – Panel styles
* dist/wand-plugin.js – Magic Wand functionality
* Asset files for WordPress dependency management

Build configuration:
* Vite 6+ for bundling
* React 18+ components
* SCSS preprocessing
* Autoprefixer for browser compatibility
* Minification enabled
* IIFE format for WordPress compatibility

Do I need API keys?

Yes, you need at least one API key from OpenAI (https://platform.openai.com) or Deepseek (https://platform.deepseek.com). You can use both providers if you want.

How much does it cost?

The plugin itself is completely free. However, you pay for API usage to OpenAI and/or Deepseek based on their pricing:
* OpenAI: Pay-per-token pricing, varies by model (check their pricing page)
* Deepseek: Generally more affordable than OpenAI (check their pricing page)

Typical costs:
* Generating a blog post title: $0.001 – $0.01
* Generating full article (500-1000 words): $0.02 – $0.10
* The exact cost depends on the model, prompt length, and generated content length

Is my data safe?

Yes. Security measures include:
* All API communications use HTTPS encryption
* API keys stored securely in WordPress database
* No data stored on third-party servers after generation
* WordPress nonces and capability checks
* Input sanitization and output escaping

Your content is sent to AI providers only when you explicitly request generation. Please review the “External Services” section and AI providers’ privacy policies.

Can I use custom prompts?

Yes! Magic Wand feature allows you to enter completely custom prompts for any block. You can also customize default prompts using WordPress filters.

Which AI provider should I use?

OpenAI:
* Higher quality outputs
* Better understanding of complex prompts
* More expensive
* Recommended for: critical content, marketing copy

Deepseek:
* Faster generation
* More affordable
* Good quality for most use cases
* Recommended for: blog posts, drafts, bulk generation

You can switch between providers anytime or use both.

Which post types are supported?

All public post types including:
* Posts
* Pages
* Custom Post Types (configured in Settings)

Can I limit who can use AI generation?

Yes, the plugin respects WordPress capabilities:
* edit_posts – required for using generator panel and Magic Wand
* publish_posts – required for bulk post generation
* manage_options – required for plugin settings

Configure user roles in WordPress to control access.

How does Magic Wand work?

1. Select any supported block (paragraph, heading, quote, etc.)
2. Click the magic wand icon in the block toolbar
3. Enter your prompt (e.g., “Write about WordPress AI plugins”)
4. Click Generate
5. Content appears in your block instantly!

What languages are supported?

AI models support all major languages. You can:
* Generate content in any language by specifying it in your prompt
* Use the Translate Text action to translate between languages
* Plugin interface available in English and Russian

Can developers extend the plugin?

Yes! The plugin provides WordPress filters for customization:

• smartypress_ai_prompt_{action} – Customize prompts
• smartypress_ai_wand_params – Modify AI parameters
• smartypress_ai_wand_features – Add custom actions

See documentation for examples.

Does this work with the classic editor?

No, this plugin requires the Gutenberg block editor (WordPress 5.0+). It’s designed specifically for block-based editing.

Can I use this for WooCommerce products?

Yes, if WooCommerce products are enabled as a public post type, you can generate product descriptions, titles, and other content.

What happens if I run out of API credits?

Generation will fail with an error message. You’ll need to add credits to your OpenAI or Deepseek account. The plugin will show the API error message to help you troubleshoot.

What happens when I uninstall the plugin?

When you delete the plugin through WordPress admin, all plugin data will be completely removed:
* Plugin settings and API keys
* All options and transients
* Post meta created by the plugin (if any)
* User meta created by the plugin (if any)

Note: Generated content (posts, titles, excerpts) will NOT be deleted as they are your content. Only plugin-specific data is removed.

If you want to keep your settings for future use, simply deactivate the plugin instead of deleting it.

1.0.0 – 2025-10-26

Initial Release – Full AI Integration for WordPress

Features:
* Advanced AI engine with intelligent content generation
* AI Content Generator panel in Gutenberg
* Magic Wand for inline content generation
* Dual AI provider support (OpenAI + Deepseek)
* 10+ pre-built Magic Wand actions
* Custom prompts for precise control
* Replace and Suggest generation modes
* Bulk post generation (1-50 posts)
* React 18 + Vite modern frontend
* WordPress security standards compliance
* Multi-language support (EN, RU)

Content Generation:
* SEO-optimized title generation
* Full article/post content creation
* Excerpt and summary generation
* Category suggestions from existing categories
* Support for all public post types (posts, pages, custom)

Magic Wand Actions:
* Generate Content – custom prompts
* Enhance Text – improve quality
* Correct Text – grammar & spelling
* Longer Text – expand content (3x)
* Shorter Text – condense content (50%)
* Translate Text – any language
* Generate Title – 5 variants (suggest mode)
* Generate Excerpt – 3 variants (suggest mode)
* Suggest Synonyms – 5 options (suggest mode)
* Generate Alt Text – for images

Supported Blocks:
* core/paragraph – text paragraphs
* core/heading – H1-H6 headings
* core/list – ordered/unordered lists
* core/quote – blockquotes
* core/code – code blocks
* core/preformatted – preformatted text

AI Models Available:
* OpenAI: GPT-4o, GPT-4o Mini, GPT-4 Turbo, GPT-3.5 Turbo
* Deepseek: Deepseek Chat, Deepseek Coder

Technical Implementation:
* REST API with 6 secure endpoints
* WordPress hooks and filters for extensibility
* IIFE format for WordPress compatibility
* Vite build system with hot reload
* SCSS modular styles with autoprefixer
* React hooks for state management
* Asset dependency management

Security:
* Nonce verification for all requests
* Capability checks (edit_posts, publish_posts)
* Input sanitization and validation
* Output escaping
* HTTPS API communication
* Secure API key storage in database

Developer Features:
* WordPress filters: smartypress_ai_prompt_{action}
* WordPress filters: smartypress_ai_wand_params
* WordPress filters: smartypress_ai_wand_features
* Extensible action system
* Custom prompt support
* API service abstraction

Bug Fixes & Improvements:
* Fixed React Hooks ordering issues
* Fixed ES modules resolution errors
* Fixed process.env undefined error
* Added translators comments for i18n
* Updated to WordPress 6.8 compatibility
* Removed deprecated load_plugin_textdomain
* Added phpcs:ignore for WordPress settings nonce

Documentation:
* Complete README with examples
* Detailed FAQ section
* External services disclosure (required)
* Privacy and GDPR information
* Build instructions for developers
* WordPress filters usage examples
* Custom action implementation guide