Getting Started
Initial Setup
-
Install and Activate
Install the plugin through WordPress admin or upload the plugin files to your
/wp-content/plugins/directory. -
Get OpenAI API Key
Visit OpenAI.com, create an account, and generate an API key from your dashboard.
-
Configure Settings
Go to the Settings page and enter your OpenAI API key and configure your preferences.
-
Test Connection
Use the “Test API Connection” button to verify everything is working correctly.
Quick Start Guide
Add Your Services
Go to Content Generator and add your business services (e.g., “Web Design”, “SEO”, “Marketing”).
Add Your Locations
Add the cities or areas you serve (e.g., “New York”, “Los Angeles”, “Chicago”).
Generate Content
Click “Generate Single Post” or schedule multiple posts using the combination matrix.
Dashboard Overview
Dashboard Features
- Quick Stats: View total posts generated, queue status, and recent activity.
- Recent Posts: See your latest AI-generated content with direct edit links.
- Queue Overview: Monitor scheduled posts and their status.
- Quick Actions: Generate posts instantly or access key features.
Content Generator
Setting Up Your Content Matrix
The content matrix allows you to create service + location combinations for targeted local SEO content.
Add Services
Enter the services your business offers, one per line (e.g., Web Design, SEO, Marketing).
Add Locations
List the cities or regions you serve, one per line (e.g., New York, Los Angeles, Chicago).
Generation Options
- Single Post: Click any combination to generate immediately.
- Bulk Scheduling: Select multiple combinations and schedule them for automatic generation.
- Schedule All: Automatically schedule all unused combinations.
Combination Matrix Status
- Available Ready to generate
- Used Already generated
- Scheduled In queue for generation
Additional Content Generator
What is Additional Content?
Create custom blog posts from your own titles, separate from the service/location combination system. Perfect for answering customer questions or covering unique topics.
How to Use
- Enter Business Information: Provide your business name, service/industry, and location for context.
- Add Post Titles: Enter one title per line. Paste multiple titles for bulk processing.
- Set Scheduling: Choose when to generate and publish posts (immediate, daily, or custom).
- Add to Queue: Click “Add to Queue” to process all titles.
Landing Pages
Generate Landing Pages
Create professional landing pages for your services and locations with AI-generated content, optimized for conversions.
Features
- Service-specific landing pages with detailed descriptions
- Location-based pages optimized for local SEO
- Automatic FAQ sections and call-to-action elements
- Batch generation with detailed progress logging
Queue Manager
Managing Your Content Queue
The Queue Manager shows all scheduled posts and allows you to manage, edit, and monitor generation progress.
Queue Status Types
- Pending Waiting to be generated
- Processing Currently being generated
- Completed Successfully generated
- Failed Generation failed
Queue Actions
- Generate Now: Immediately generate pending items.
- Edit Post: View and edit completed posts.
- Delete: Remove items from queue.
- Retry Failed: Retry items that failed generation.
Analytics & Reports
Content Analytics Dashboard
Track performance of your AI-generated content with detailed analytics and insights.
Key Metrics
- Page Views: Track total views for each post and service/location combination.
- Service Performance: See which services generate the most traffic.
- Location Performance: Identify top-performing locations.
- Trending Content: Discover posts gaining traction.
Enable Tracking on All Posts
Use the “Enable Tracking on All Posts” button to add analytics tracking to all published posts. This processes posts in batches and automatically extracts service and location data from post titles.
Email Reports
Automated Email Analytics
Receive daily or weekly email reports with analytics summaries and AI-generated insights about your content performance.
Email Report Features
- Daily or weekly analytics summaries
- Top-performing posts and services
- AI-generated content recommendations
- Social media post suggestions
Marketing Tools
AI-Powered Marketing Content
Generate marketing content including social media posts, email campaigns, and promotional materials based on your blog posts.
Available Tools
- Social Media Posts: Generate Facebook, Twitter, and LinkedIn posts from your content.
- Email Templates: Create email campaigns promoting your blog posts.
- Meta Descriptions: Generate SEO-optimized meta descriptions.
Featured Images
Automatic Featured Image Assignment
Automatically assign featured images to your posts based on services and locations. Upload images and assign them to specific combinations for targeted visual content.
How to Use
- Upload Images: Use the image uploader or select from media library.
- Assign to Combinations: Click “Assign” and select which service/location combinations should use this image.
- Automatic Application: New posts are automatically assigned matching featured images.
- Update All Posts: Use “Update All Posts Now” to apply images to existing posts with detailed logging.
Secondary Images
In-Content Images
Automatically insert secondary images into post content after the second paragraph. Assign location-specific images to enhance visual appeal and SEO.
Secondary Image Features
- Location-Based Assignment: Assign images to specific locations for targeted content.
- Automatic Insertion: Images are automatically placed after the second paragraph.
- Scan Images: Automatically scan media library and assign images based on alt text matching locations.
- Batch Processing: Update all posts with progress logging showing which images were assigned to which posts.
Service Galleries
Automatic Image Galleries
Automatically insert image galleries at the end of posts based on the service. Perfect for showcasing your work with portfolio images.
How to Setup
- Add Service: Enter the service name (e.g., “Web Design”, “SEO”).
- Upload Gallery Images: Add multiple images that represent this service.
- Automatic Insertion: Galleries are automatically added to matching posts.
SEO Image Generator
Generate SEO-Optimized Images
Create professional branded images with text overlays for better social media sharing and SEO. Perfect for featured images and social thumbnails.
Features
- Custom text overlays with your branding
- Multiple templates and styles
- Automatic size optimization for social platforms
- Batch generation for multiple posts
Location Map Generator
Generate Location Maps
Create static map images for your location-based posts. Automatically geocode addresses and generate map images for each location.
Map Features
- Automatic address geocoding
- Custom map styles and markers
- Zoom level customization
- Automatic insertion into location posts
Service Area Map
Display Your Service Coverage
Generate an interactive map showing all your service locations. Perfect for landing pages and about pages to visualize your coverage area.
Features
- Interactive map with all locations
- Automatic marker generation from your location list
- Shortcode for easy page embedding
- Customizable colors and markers
Settings Configuration
General Settings
- OpenAI API Key: Required for AI content generation.
- AI Model: Choose between GPT-3.5-turbo, GPT-4, or GPT-4-turbo.
- Post Status: Set default status (Draft, Publish, or Scheduled).
- Default Category: Assign posts to a specific category.
- Default Author: Set the author for generated posts.
Content Options
- Target Word Count: Set desired post length (300–3000+ words).
- Content Depth: Choose between basic, detailed, or comprehensive coverage.
- Content Structure: Select post format (guide, listicle, FAQ, etc.).
- Generate Excerpts: Automatically create post excerpts.
AI Images
- Enable AI Images: Generate images using DALL·E.
- Image Style: Customize the style prompt for generated images.
- Image Size: Choose image dimensions (1024×1024, 1024×1792, etc.).
FAQ Settings
- Enable FAQ Schema: Add structured data for better SEO.
- Minimum Questions: Set how many FAQ questions to generate.
- FAQ Section Title: Customize the FAQ heading.
SMS Reports
Receive daily analytics reports via SMS with AI-generated insights and social media post suggestions.
- Twilio Configuration: Enter your Twilio Account SID, Auth Token, and phone numbers.
- Report Schedule: Set daily report time and enable/disable automatic reports.
- AI Insights: Include AI-generated Facebook post suggestions in reports.
- Test Connection: Send a test SMS to verify your Twilio setup.
License Management
Managing Your License
Activate your Pro license to unlock all premium features including additional content, landing pages, analytics, and automated reports.
Pro Features
- Unlimited post generation
- Additional content generator
- Landing page generator
- Advanced analytics and reports
- Email and SMS reports
- Marketing tools
- Featured and secondary images
- Service galleries
- SEO image generator
- Location maps and service area maps
Troubleshooting
Common Issues
API Connection Failed
Problem: Cannot connect to OpenAI API
Solution:
- Verify your API key is correct
- Check OpenAI account has credits
- Ensure your server can make external connections
- Check firewall/hosting restrictions
Posts Not Generating
Problem: Scheduled posts remain in queue
Solution:
- Check WordPress cron is working (use WP Crontrol plugin)
- Verify API connection is working
- Check error logs for specific issues
Images Not Applying
Problem: Featured or secondary images not showing on posts
Solution:
- Ensure images are properly assigned to service/location combinations
- Use “Update All Posts Now” to apply images to existing content
- Check post meta data has correct service and location values
- For secondary images, verify location matching is working correctly
Analytics Not Tracking
Problem: Page views not being recorded
Solution:
- Use “Enable Tracking on All Posts” in Analytics dashboard
- Verify posts have the
_wpaibg_ai_generatedmeta flag - Check that JavaScript tracking script is loading on front-end
SMS Reports Not Sending
Problem: Daily SMS reports not being received
Solution:
- Verify Twilio credentials are correct
- Use “Test SMS Connection” button to check setup
- Ensure phone numbers include country code (e.g., +1234567890)
- Check Twilio account has sufficient credits
Frequently Asked Questions
Do I need an OpenAI account?
Yes, you need an OpenAI account and API key. The plugin uses your OpenAI account to generate content, and you are billed directly by OpenAI for API usage.
Can I edit the generated content?
Yes, all generated content can be edited like any WordPress post. We recommend reviewing and customizing content before publishing.
Is the generated content unique?
Yes, each post is generated fresh by the AI and should be unique. However, we recommend using plagiarism checkers if uniqueness is critical for your use case.
How many posts can I generate?
Pro users have unlimited post generation (limited only by your OpenAI API). Free users are limited to 5 posts per month.
What happens to images when I update posts?
The “Update All Posts Now” feature adds images to posts that don’t have them but won’t replace existing images. You can see which images were assigned in the detailed processing log.
Can I use this for client websites?
Yes, Pro license allows use on client sites. Check your specific license terms for multi-site usage details.
Does this work with my theme?
Yes, the plugin creates standard WordPress posts that work with any theme. Generated content uses standard HTML formatting.
How do service galleries work?
Service galleries are automatically inserted at the end of posts when the post matches the service. The gallery displays via the_content filter and requires no shortcodes.
Can I schedule posts for specific times?
Yes, you can schedule both generation time and publication time. Posts can be generated as drafts, scheduled posts, or published immediately.
What analytics data is tracked?
The plugin tracks page views by post, service, and location. Analytics are stored in your WordPress database and displayed in the Analytics dashboard with charts and insights.
Still Need Help?
If you can’t find the answer to your question in this documentation, we’re here to help!