Skip to content

scottnzuk/ContentPilot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

10 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

ContentPilot - AI-Powered Content Generation for WordPress

WordPress Plugin Version License PHP

ContentPilot is an enterprise-grade WordPress plugin that revolutionizes content creation by automatically transforming the latest news articles into unique, engaging blog posts using advanced AI technology. With ContentPilot, you get microservices architecture, offline AI content humanization, Google EEAT compliance, and advanced RankMath SEO integration - all designed to supercharge your content marketing strategy.

๐Ÿš€ Features

Core Features (All Included)

  • AI Content Generation: Support for OpenRouter (default), OpenAI GPT, Anthropic Claude, and custom APIs
  • Offline AI Content Humanization: Make AI-generated content appear more human-written using the humano Python package
  • RSS Feed Integration: Fetch latest news from popular RSS feeds or custom feeds
  • Large Batch Post Creation: Generate up to 30 unique blog posts per batch
  • Automated Scheduling: Set up automatic post generation with WP-Cron
  • Featured Image Generation: AI-powered featured images for posts
  • Advanced SEO Optimization: RankMath SEO integration with automatic meta descriptions, title optimization, and content structure analysis
  • Advanced Analytics: Track post performance and engagement
  • Customizable Content: Configure tone of voice, word count, and categories
  • Security First: Encrypted API key storage and comprehensive input sanitization
  • WordPress Native: Built with WordPress coding standards and native UI
  • Microservices Architecture: Enterprise-grade performance and scalability
  • Real-time Monitoring: Live performance metrics and health monitoring

๐Ÿ“‹ Requirements

  • WordPress 5.0 or higher
  • PHP 7.4 or higher
  • MySQL 5.6 or higher
  • OpenRouter API key (recommended default) or OpenAI/Anthropic API key
  • cURL extension enabled
  • RankMath SEO plugin (recommended for full SEO features)

๐Ÿ”ง Installation

Method 1: WordPress Admin (Recommended)

  1. Download the plugin zip file from the releases page
  2. Log in to your WordPress admin dashboard
  3. Navigate to Plugins > Add New
  4. Click Upload Plugin and select the downloaded zip file
  5. Click Install Now and then Activate

Method 2: Manual Installation

  1. Download and extract the plugin files
  2. Upload the contentpilot folder to /wp-content/plugins/
  3. Activate the plugin through the WordPress admin Plugins menu

Method 3: Git Clone (Developers)

git clone https://github.com/scottnzuk/contentpilot-enhanced.git
cd contentpilot-enhanced
# Copy to your WordPress plugins directory
cp -r . /path/to/wordpress/wp-content/plugins/contentpilot/

โš™๏ธ Configuration

  1. After activation, navigate to Settings > ContentPilot
  2. Configure the following settings:
    • LLM Provider: Choose between OpenRouter (default), OpenAI, Anthropic, or Custom API
    • API Key: Enter your API key (stored securely and encrypted)
    • Categories: Select WordPress categories for generated posts
    • Word Count: Choose short (300-500), medium (500-800), or long (800-1200) posts
    • Tone of Voice: Select Neutral, Professional, or Friendly tone
    • RankMath SEO Integration: Enable/disable advanced SEO features

Getting API Keys

OpenRouter API Key (Recommended Default)

  1. Visit OpenRouter
  2. Sign up or log in to your account
  3. Navigate to API Keys section
  4. Create a new API key
  5. Copy and paste into the plugin settings

OpenAI API Key

  1. Visit OpenAI Platform
  2. Sign up or log in to your account
  3. Navigate to API Keys section
  4. Create a new API key
  5. Copy and paste into the plugin settings

Anthropic API Key

  1. Visit Anthropic Console
  2. Sign up or log in to your account
  3. Navigate to API Keys section
  4. Create a new API key
  5. Copy and paste into the plugin settings

๐ŸŽฏ Usage

Generating Posts

  1. Go to Settings > ContentPilot
  2. Ensure all settings are configured
  3. Click Generate 30 Posts button (or customize batch size)
  4. Wait for the process to complete (usually 30-60 seconds)
  5. Check Posts > All Posts for new draft posts
  6. Review, edit, and publish the generated content

Managing Generated Content

  • All generated posts are created as drafts for manual review
  • Posts are automatically categorized based on your settings
  • Each post includes a note indicating it was AI-generated
  • You can edit, modify, or delete posts as needed before publishing

๐Ÿ”’ Security Features

  • Encrypted API Key Storage: API keys are encrypted before storage
  • Input Sanitization: All user inputs are sanitized and validated
  • Nonce Verification: CSRF protection for all admin actions
  • Capability Checks: Proper WordPress permission handling
  • SQL Injection Prevention: Prepared statements for database queries
  • XSS Protection: Output escaping for all displayed content

๐Ÿ—๏ธ Technical Architecture

File Structure

contentpilot/
โ”œโ”€โ”€ contentpilot.php      # Main plugin file
โ”œโ”€โ”€ includes/
โ”‚   โ”œโ”€โ”€ class-admin-settings.php  # Admin settings management
โ”‚   โ”œโ”€โ”€ class-news-fetch.php      # RSS feed processing
โ”‚   โ”œโ”€โ”€ class-ai-generator.php    # AI content generation
โ”‚   โ””โ”€โ”€ class-post-creator.php    # WordPress post creation
โ”œโ”€โ”€ admin/
โ”‚   โ””โ”€โ”€ settings-page.php         # Admin interface
โ”œโ”€โ”€ assets/
โ”‚   โ”œโ”€โ”€ css/admin.css             # Admin styling
โ”‚   โ””โ”€โ”€ js/admin.js               # Admin JavaScript
โ”œโ”€โ”€ readme.txt                    # WordPress repository readme
โ””โ”€โ”€ README.md                     # This file

Key Classes

  • ContentPilot_Admin_Settings: Handles plugin configuration and settings
  • ContentPilot_News_Fetch: Manages RSS feed fetching and parsing
  • ContentPilot_AI_Generator: Interfaces with AI APIs for content generation
  • ContentPilot_Post_Creator: Creates and manages WordPress posts

๐Ÿ”Œ API Integration

Supported AI Providers

OpenRouter Integration (Default)

  • Models: Multiple provider models available
  • Endpoint: https://openrouter.ai/api/v1
  • Authentication: Bearer token
  • Benefits: Single API key for multiple AI providers

OpenAI Integration

  • Model: GPT-3.5-turbo (default) or GPT-4
  • Endpoint: https://api.openai.com/v1/chat/completions
  • Authentication: Bearer token

Anthropic Integration

  • Model: Claude-3-haiku (default) or Claude-3-sonnet
  • Endpoint: https://api.anthropic.com/v1/messages
  • Authentication: API key header

Custom API

  • Configurable endpoint and authentication
  • Must follow OpenAI-compatible response format

๐ŸŽจ RankMath SEO Integration

ContentPilot features deep integration with RankMath SEO plugin for advanced search engine optimization:

Automatic SEO Features

  • Title Optimization: AI-generated titles with SEO best practices
  • Meta Description Generation: Automatic, engaging meta descriptions
  • Content Structure Analysis: Ensures proper heading hierarchy (H1, H2, H3)
  • Keyword Optimization: Intelligent keyword placement and density
  • Readability Analysis: Content scoring for readability and engagement
  • Schema Markup: Automatic generation of structured data
  • Focus Keyword Analysis: RankMath integration for target keywords
  • Content Length Optimization: Recommends ideal content length

SEO Performance Monitoring

  • Real-time SEO Scoring: Instant feedback on content quality
  • RankMath Integration Dashboard: View SEO metrics within ContentPilot
  • Automatic SEO Suggestions: AI-powered recommendations for improvement
  • Bulk SEO Optimization: Apply SEO best practices to multiple posts

Advanced SEO Settings

  • Custom SEO Templates: Create reusable SEO patterns for different content types
  • SEO Preset Management: Save and apply SEO configurations
  • Automatic Internal Linking: Intelligent suggestion of related content
  • Image Alt Text Optimization: AI-generated descriptive alt text
  • Canonical URL Management: Prevent duplicate content issues

๐Ÿ› Troubleshooting

Common Issues

Posts not generating

  • Verify API key is correct and has sufficient credits
  • Check WordPress error logs for detailed error messages
  • Ensure RSS feeds are accessible and returning content

API errors

  • Confirm API key has proper permissions
  • Check API rate limits and usage quotas
  • Verify internet connectivity and firewall settings

Permission errors

  • Ensure user has manage_options capability
  • Check WordPress file permissions
  • Verify plugin activation was successful

SEO features not working

  • Ensure RankMath SEO plugin is installed and activated
  • Check RankMath API connectivity
  • Verify SEO module is enabled in ContentPilot settings

Debug Mode

Enable WordPress debug mode to see detailed error messages:

// Add to wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

๐Ÿค Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

Development Setup

# Clone the repository
git clone https://github.com/scottnzuk/contentpilot-enhanced.git
cd contentpilot-enhanced

# Set up local WordPress development environment
# Copy plugin to WordPress plugins directory
cp -r . /path/to/wordpress/wp-content/plugins/contentpilot/

Coding Standards

  • Follow WordPress Coding Standards
  • Use proper sanitization and escaping
  • Include comprehensive error handling
  • Add inline documentation for complex functions

๐Ÿ“ Changelog

Version 2.0.0 (2025-12-02)

  • ๐ŸŽ‰ COMPLETE REBRANDING: Transformed to ContentPilot
  • โœ… Updated all branding, documentation, and user-facing text
  • โœ… Enhanced plugin description with professional ContentPilot messaging
  • โœ… Improved README with compelling marketing content
  • โœ… Updated all documentation files with modern ContentPilot identity
  • โœ… Verified all user-facing text reflects ContentPilot branding
  • โœ… Set OpenRouter as default API provider for multi-model access
  • โœ… Added "Get OpenRouter API Key" button to admin interface
  • โœ… Enhanced RankMath SEO integration with advanced features
  • โœ… Updated all SEO documentation with actual RankMath capabilities

Version 1.3.0 (2025-11-30)

  • ๐ŸŽ‰ ALL FEATURES NOW FREE! Converted all premium features to core functionality
  • โœ… Removed license validation and subscription requirements
  • โœ… Removed all pro feature restrictions and limits
  • โœ… Enabled batch post creation up to 30 posts per batch
  • โœ… Added automated scheduling with WP-Cron integration
  • โœ… Added featured image generation capabilities
  • โœ… Added SEO optimization and meta tag automation
  • โœ… Added advanced analytics and performance monitoring
  • โœ… Added microservices architecture for enterprise performance
  • โœ… Added RankMath SEO integration and analysis
  • โœ… Added real-time monitoring and health checks
  • โœ… Updated admin interface to show all features as available
  • โœ… Updated documentation to reflect free feature access

Version 1.2.0 (2025-10-15)

  • ๐Ÿš€ Major Performance Improvements with microservices architecture
  • โšก 70-80% Performance Enhancement through advanced caching and optimization
  • ๐Ÿ” Google EEAT Compliance for better search rankings
  • ๐Ÿ“Š Advanced Analytics Dashboard with real-time monitoring
  • ๐Ÿ—๏ธ Enterprise-Grade Architecture with Service Registry and Orchestrator

Version 1.1.0 (2025-10-01)

  • ๐ŸŽจ Modern Admin Interface with PWA features
  • ๐Ÿ” Enhanced Security with ML threat detection
  • ๐Ÿ“ˆ Performance Optimizations with Redis/Memcached caching
  • ๐Ÿ”Œ API Platform for third-party integrations
  • ๐Ÿงช Comprehensive Testing suite with 100+ test cases

Version 1.0.0 (2025-09-08)

  • Initial release
  • Core AI content generation functionality
  • OpenAI and Anthropic API integration
  • RSS feed processing
  • Batch post creation
  • Admin settings interface
  • Security enhancements
  • WordPress repository compatibility

๐Ÿ”ฎ Roadmap

Version 2.1.0 (Q1 2026)

  • Multi-language support
  • Advanced content templates
  • Enhanced AI model selection
  • Custom personality training
  • Advanced scheduling options
  • Integration marketplace
  • Expanded RankMath SEO features
  • AI-powered content audits

Version 3.0.0 (Future)

  • Advanced AI model fine-tuning
  • Multi-site management
  • Enterprise security features
  • White-label solutions
  • Advanced customization options
  • Professional services integration
  • Deep RankMath SEO automation
  • AI-driven content strategy recommendations

๐Ÿ“„ License

This project is licensed under the GPL v2 License - see the LICENSE file for details.

๐Ÿ‘จโ€๐Ÿ’ป Author

scottnzuk

๐Ÿ™ Acknowledgments

  • WordPress community for excellent documentation
  • OpenAI, Anthropic, and OpenRouter for powerful AI APIs
  • RankMath team for excellent SEO plugin integration
  • RSS feed providers for news content
  • Beta testers and early adopters

๐Ÿ“ž Support

For support, please:

  1. Check the troubleshooting section
  2. Search existing issues
  3. Create a new issue if needed

Made with โค๏ธ for the WordPress community

About

ContentPilot: Advanced WordPress plugin for AI-powered content generation, RSS filtering, SEO optimization, and comprehensive content management

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors