=== Rocketship SEO === Contributors: joeyoungblood Donate link: https://www.joeyoungblood.com/ Tags: seo, meta-tags, xml-sitemap, ai-seo, schema-markup, google-analytics Requires at least: 5.0 Tested up to: 7.0 Stable tag: 1.0.65 Requires PHP: 7.0 License: GPL-2.0+ License URI: http://www.gnu.org/licenses/gpl-2.0.txt AI-powered WordPress SEO plugin with Google Analytics integration, smart meta titles, descriptions, schema markup, sitemaps, and OpenAI & Google Gemini AI. == Description == Rocketship SEO is a comprehensive WordPress SEO plugin that combines traditional SEO optimization with cutting-edge AI technology. Using OpenAI's GPT models or Google Gemini, it automatically generates optimized meta titles, descriptions, and provides intelligent SEO recommendations to boost your site's search engine visibility. = πŸš€ AI-Powered Features = * **AI Meta Title Generation**: Generate compelling, SEO-optimized titles using GPT models * **AI Meta Description Creation**: Create engaging descriptions that improve click-through rates * **AI Content Analysis**: Get detailed SEO analysis with scoring and actionable recommendations * **Advanced AI Strategy Tools**: GPT-5 powered SEO strategy, content gap analysis, and E-A-T analysis * **AI Keyword Research**: Advanced keyword research with semantic analysis and competition insights * **Bulk AI Suggestions**: Generate suggestions for multiple posts at once with easy apply/skip options * **Smart SEO Scoring**: AI analyzes your content and provides improvement suggestions * **Multiple AI Models**: Choose from OpenAI (GPT-4o-mini, GPT-4o, GPT-5, o1-preview, o1-mini) or Google Gemini (Gemini 1.5 Pro, Gemini 1.5 Flash) = πŸ“Š Traditional SEO Features = * **Custom Meta Fields**: Set custom meta titles and descriptions for posts and pages * **XML Sitemap Generation**: Automatically generate dynamic, search engine-friendly sitemaps * **Visual Sitemap Generator**: Interactive site navigation at /sitemap with multiple view modes * **Schema Markup**: JSON-LD structured data for articles, websites, organizations, and more * **Open Graph Tags**: Optimize content for Facebook, LinkedIn, and other social platforms * **Twitter Cards**: Enhanced Twitter sharing with proper meta tags * **File Rules Editor**: Professional .htaccess and robots.txt editor with backup system * **AI Image Redirect**: Protect images from direct access, hotlinking, and unauthorized downloads * **Bot Redirection System**: Control bot access with User-Agent detection and custom redirects * **Google Analytics Integration**: View GA4 traffic data, pageviews, sessions, and user metrics directly in WordPress * **Per-Page Analytics**: See analytics data for individual posts/pages in the editor metabox * **Google Reviews OAuth**: Fetch ALL your Google Business Profile reviews (not limited to 5) * **Dual Authentication**: Choose between API Key (simple, 5 reviews) or OAuth (unlimited reviews) * **Gutenberg Integration**: Dedicated sidebar panel with real-time preview * **Classic Editor Support**: Full compatibility with WordPress classic editor = 🎯 Key Features = * **Live Preview**: See how your meta tags will appear in Google search results * **Character Counting**: Visual indicators for optimal title and description lengths * **Smart Fallbacks**: Automatically uses post title and excerpt when custom fields are empty * **Google Analytics Dashboard**: View traffic data, top pages, and traffic sources without leaving WordPress * **Per-Content Analytics**: See pageviews, sessions, and trends for each post/page in the editor * **Compatibility System**: Advanced detection and conflict prevention with other SEO plugins * **Granular Override Control**: Choose which SEO features to enable when other plugins are present * **Sitemap Management**: Individual post/page exclusion options * **Breadcrumb Schema**: Automatic breadcrumb structured data * **Robots.txt Integration**: Sitemap URLs automatically added to robots.txt * **Multi-language Ready**: Full internationalization support * **Performance Optimized**: Efficient caching and minimal database queries = πŸ€– How AI Features Work = 1. **Setup**: Choose your AI provider (OpenAI or Google Gemini) and configure your API key in Rocketship SEO settings 2. **Choose Model**: Select from OpenAI models (GPT-4o-mini, GPT-5, o1-preview) or Gemini models (Gemini 1.5 Pro, Flash) 3. **Generate**: Click AI suggestion buttons while editing posts/pages 4. **Analyze**: Use AI content analysis to get SEO improvement recommendations 5. **Advanced Tools**: Access GPT-5 optimized SEO strategy, content gap analysis, and E-A-T analysis 6. **Bulk Process**: Use AI Tools page to generate suggestions for multiple posts 7. **Optimize**: Apply AI suggestions with one click or customize as needed = πŸ’‘ Perfect For = * Content creators who want AI-powered SEO optimization * Website owners looking to improve search rankings * Agencies managing multiple WordPress sites * Developers who need comprehensive SEO solutions * Anyone wanting to save time on SEO optimization == Installation == = Automatic Installation = 1. Go to Plugins > Add New in your WordPress admin 2. Search for "Rocketship SEO" 3. Click Install Now and then Activate 4. Go to Rocketship SEO in admin sidebar to configure settings = Manual Installation = 1. Download the plugin zip file 2. Upload to `/wp-content/plugins/` directory 3. Extract the files 4. Activate through the 'Plugins' menu in WordPress 5. Configure settings in Rocketship SEO admin panel = AI Setup (Optional but Recommended) = 1. Get an API key from OpenAI (https://platform.openai.com/api-keys) or Google AI Studio (https://aistudio.google.com/app/apikey) 2. Go to Rocketship SEO > General Settings 3. Scroll to "AI-Powered SEO Recommendations" section 4. Enter your API key and choose your preferred AI model 5. Enable AI recommendations 6. Start using AI features in post/page editors == How to Use == = Basic SEO Setup = 1. **Enable Features**: Go to Rocketship SEO > General Settings and enable desired features 2. **Configure Sitemaps**: Visit Rocketship SEO > XML Sitemap to enable sitemap generation 3. **Set Organization Info**: Add your organization name and logo for schema markup 4. **Configure Social Media**: Add Twitter handle and default Open Graph image = Using AI Features = **For Individual Posts/Pages:** 1. Edit any post or page 2. Find the Rocketship SEO panel (sidebar in Gutenberg, meta box in Classic Editor) 3. Click "πŸ€– AI Suggestions" button next to title or description fields 4. Review generated suggestions and click "Use This" for your preferred option 5. Click "πŸ” AI SEO Analysis" for detailed content analysis and recommendations **For Bulk Operations:** 1. Go to Rocketship SEO > AI Tools (appears when AI is enabled) 2. Select posts you want to optimize or use filters (category, date range, etc.) 3. Choose "Generate Titles" or "Generate Descriptions" 4. Review suggestions and apply or skip for each post 5. Use "Apply All" for bulk operations = Content Analysis = 1. Open the AI SEO Analysis panel while editing content 2. Review your SEO score (0-100) 3. Check "Strengths" section for what's working well 4. Follow "Improvements" suggestions for better optimization 5. Use "Suggested Keywords" to enhance your content 6. Implement "Recommendations" for maximum SEO impact = Using Google Analytics = **Initial Setup:** 1. Go to Rocketship SEO > Google Analytics 2. Click "Connect with Google" and authorize access 3. Select your GA4 property from the dropdown 4. View your traffic data immediately! **Dashboard Features:** * **Overview Tab**: Pageviews, sessions, users, bounce rate * **Top Pages Tab**: Most visited content with metrics * **Traffic Sources Tab**: Source/medium breakdown * **Date Range Selector**: 7, 30, 90, or 365 days **Per-Post Analytics:** 1. Edit any post or page 2. Find the "Google Analytics" metabox in the sidebar/below content 3. View pageviews, sessions, and users for that specific page 4. See 7-day trend chart for quick performance insights = XML Sitemap Features = * **Main Index**: Access at `yoursite.com/sitemap_index.xml` * **Post Sitemap**: `yoursite.com/post-sitemap.xml` * **Page Sitemap**: `yoursite.com/page-sitemap.xml` * **Exclude Pages**: Use checkbox in editor to exclude specific content * **Submit to Search Engines**: Only submit the main sitemap index URL == Frequently Asked Questions == = How do I get started with AI features? = **For OpenAI:** 1. Sign up for an OpenAI account at https://platform.openai.com 2. Create an API key in your OpenAI dashboard 3. Go to Rocketship SEO > General Settings 4. Select "OpenAI" as your AI provider 5. Enter your API key in the "AI-Powered SEO Recommendations" section 6. Choose your preferred AI model (GPT-4o-mini for speed, GPT-5 for quality) 7. Enable AI recommendations and start using the features **For Google Gemini:** 1. Visit Google AI Studio at https://aistudio.google.com/app/apikey 2. Create a Gemini API key 3. Go to Rocketship SEO > General Settings 4. Select "Google Gemini" as your AI provider 5. Enter your API key in the "AI-Powered SEO Recommendations" section 6. Choose your preferred model (Gemini 1.5 Flash for speed, Gemini 1.5 Pro for quality) 7. Enable AI recommendations and start using the features = Which AI model should I choose? = **OpenAI Models:** * **GPT-4o-mini**: Fast and cost-effective, great for most users * **GPT-4o**: Optimized performance with great quality * **GPT-5**: Most advanced capabilities for complex SEO analysis * **o1-preview**: Best for detailed SEO strategy and reasoning **Google Gemini Models:** * **Gemini 1.5 Flash**: Fast responses with great quality, cost-effective * **Gemini 1.5 Flash-8B**: Ultra-fast for simple tasks * **Gemini 1.5 Pro**: Best overall performance and quality * **Gemini Pro**: Stable and reliable performance = How much do AI features cost? = AI features use your chosen provider's API credits. Approximate costs per suggestion: **OpenAI Pricing:** * **GPT-4o-mini**: ~$0.001-0.002 per suggestion (very affordable) * **GPT-4o**: ~$0.01-0.03 per suggestion * **GPT-5**: ~$0.03-0.08 per suggestion * **o1-preview**: ~$0.05-0.15 per suggestion **Google Gemini Pricing:** * **Gemini 1.5 Flash-8B**: ~$0.0001-0.0003 per suggestion (extremely affordable) * **Gemini 1.5 Flash**: ~$0.0005-0.001 per suggestion (very affordable) * **Gemini 1.5 Pro**: ~$0.002-0.005 per suggestion * **Gemini Pro**: ~$0.001-0.003 per suggestion Most users spend $1-5 per month with OpenAI or $0.50-$2 per month with Gemini for regular optimization. = Can I use the plugin without AI features? = Absolutely! All traditional SEO features work independently. You can: * Set custom meta titles and descriptions manually * Generate XML sitemaps * Add schema markup and social media tags * Use all features without an OpenAI API key = Will this conflict with other SEO plugins? = Rocketship SEO includes advanced compatibility settings to prevent conflicts: * **Automatic Detection**: Detects RankMath, Yoast SEO, All in One SEO, SEOPress, and The SEO Framework * **Smart Compatibility**: Configure which features to override in Rocketship SEO > General Settings > Compatibility Settings * **Granular Control**: Choose to override only specific features (title, description, schema, Open Graph, Twitter Cards) * **Safe Fallback**: If no override options are selected, Rocketship SEO disables all meta output to prevent conflicts * **Admin Notices**: Get notified when conflicting plugins are detected with easy access to compatibility settings = How accurate are the AI suggestions? = AI suggestions are highly optimized for SEO best practices, but you should: * Review suggestions before applying them * Ensure they match your brand voice and style * Customize suggestions to fit your specific needs * Use them as starting points for further optimization = Can I edit AI-generated content? = Yes! AI suggestions are just starting points. You can: * Click suggestions to apply them and then edit as needed * Use suggestions as inspiration for your own content * Combine multiple suggestions * Always review and customize for your brand = Does the plugin work with Gutenberg and Classic Editor? = Yes! The plugin provides: * **Gutenberg**: Dedicated sidebar panel with live preview * **Classic Editor**: Traditional meta box below the content * **Both**: Full AI functionality and real-time character counting = How often should I use AI features? = * **New Content**: Use AI suggestions for every new post/page * **Existing Content**: Run bulk analysis monthly or quarterly * **High-Priority Pages**: Re-analyze when content changes significantly * **Regular Audits**: Use AI Tools page for site-wide optimization = What data does the plugin send to AI providers? = Only the content you choose to analyze: * Post titles and content (for generating suggestions) * No personal data, user information, or site credentials * Data is processed according to your chosen provider's privacy policy (OpenAI or Google) * You control what content is analyzed = Can I switch between OpenAI and Gemini? = Yes! You can easily switch between providers: * Change the AI Provider setting in Rocketship SEO settings * Add the appropriate API key for your chosen provider * All features work identically with both providers * Test both to see which works best for your needs = Can I use this for client websites? = Yes! The plugin is perfect for agencies: * Use your own API key (OpenAI or Gemini) across multiple sites * Generate professional SEO content quickly * Provide detailed SEO analysis reports to clients * Save time on manual SEO optimization * Gemini offers more affordable pricing for high-volume usage = How do I set up Google Analytics integration? = 1. Go to Rocketship SEO > Google Analytics in your WordPress admin 2. Click "Connect with Google" to start the OAuth flow 3. Sign in with a Google account that has access to your GA4 properties 4. After authorization, select your GA4 property from the dropdown 5. Start viewing your analytics data directly in WordPress! **Requirements:** * A Google Analytics 4 (GA4) property (not Universal Analytics UA-xxxxx) * Google Cloud project with these APIs enabled: - Google Analytics Data API - Google Analytics Admin API * OAuth 2.0 credentials (Client ID and Client Secret) from Google Cloud Console = Why don't I see any GA4 properties after connecting? = If no properties appear after OAuth connection: 1. **Enable the Admin API**: Go to Google Cloud Console and enable "Google Analytics Admin API" 2. **Check GA4 Access**: Make sure the connected Google account has access to GA4 properties (not just Universal Analytics) 3. **Reconnect**: Click Disconnect and reconnect with Google to refresh the OAuth scopes 4. **Verify Property Type**: Only GA4 properties are supported (properties/123456789 format) = What Google Analytics data can I see? = The Google Analytics dashboard shows: * **Overview**: Pageviews, sessions, users, bounce rate, average session duration * **Top Pages**: Most visited pages with detailed metrics * **Traffic Sources**: Where your visitors come from (source/medium breakdown) * **Date Ranges**: View data for last 7, 30, 90, or 365 days * **Per-Post Analytics**: Individual page metrics in post/page editor metabox = How do I optimize for better search rankings? = 1. **Use AI Analysis**: Get specific recommendations for each page 2. **Follow Character Limits**: Keep titles 50-60 chars, descriptions 150-160 chars 3. **Include Target Keywords**: Use AI suggestions with your focus keywords 4. **Optimize Schema Markup**: Enable structured data for better search display 5. **Regular Audits**: Use bulk AI tools monthly to maintain optimization = What if I need help? = * Check this FAQ for common questions * Visit our documentation at https://www.joeyoungblood.com/rocketship-seo-docs * Contact support through our website * Join our community forum for tips and best practices == Screenshots == 1. AI-powered suggestions in Gutenberg editor with live preview 2. Comprehensive AI SEO analysis with scoring and recommendations 3. Bulk AI tools for managing multiple posts efficiently 4. Plugin settings page with AI configuration options 5. Classic editor meta box with AI integration 6. XML sitemap index with professional display 7. Schema markup and social media optimization settings 8. Google Analytics dashboard with traffic overview and top pages 9. Google Analytics per-post metabox showing individual page metrics 10. Bot Detector dashboard with traffic intelligence and bot classification == Changelog == = 1.0.65 = βœ… **COMPATIBILITY**: Improved compatibility with newer versions of WordPress, including WordPress 7.0 and recent 6.9.x releases. πŸ”§ **IMPROVED**: Refined internal hooks and admin integration for smoother operation on current WordPress releases. = 1.0.64 = ♻️ **REFINED**: Refined internal code paths and improved overall stability. βœ… **COMPATIBILITY**: Improved compatibility across a wider range of hosting environments and plugin/theme combinations. = 1.0.61 = πŸ”§ **FIX**: Activation failure handling is now fully graceful for missing PHP requirements (including mandatory `mbstring`) with no `wp_die()` fatal screen. ✨ **IMPROVED**: Failed activation notice is displayed directly below the Rocketship SEO plugin row on the Plugins page for clearer visibility. πŸ”’ **HARD REQUIREMENT**: `mbstring` remains required; plugin deactivates itself safely and provides cPanel/shared-hosting fix steps. = 1.0.60 = πŸ”§ **FIX**: Table of Contents markup is now valid HTML (`