GET SET UP
Install the plugin, get your API key, configure settings. Takes 10 minutes.
INSTALL THE PLUGIN
- Download the plugin from this site
- WordPress Admin → Plugins → Add New → Upload Plugin
- Choose the downloaded zip file
- Install and Activate
GET API KEY FROM OPENAI
- Go to platform.openai.com/api-keys
- Sign up or log in
- Create new secret key
- Copy the key
- Add billing at platform.openai.com/billing
CONFIGURE IN WORDPRESS
- Settings → AI Focus Groups
- Select Provider: OpenAI
- Paste API key
- Select Model: GPT-4o
- Save Settings
YOU'RE READY
Green checkmark means connection verified. Move to "First Test" to run an analysis.
RUN YOUR FIRST TEST
Test any post in 60 seconds. See how it scores.
- Open post or page in editor
- Scroll to "AI Content Focus Groups" meta box
- Select General Public
- Click Analyse Content
- The analysis is queued and processed by WordPress cron (runs every 5 minutes). You can either wait several minutes for automatic processing, or go to AI Focus Groups → Job Queue and click "Run Now" to process immediately
- Click View Report
WHAT YOU'LL SEE
- Five scores (0-100): Sentiment, Clarity, Engagement, Tone, Readability
- Summary of findings
- Quick wins (easy improvements)
- Biggest gaps (major issues)
- Suggested improvements
FIRST TIME
Don't stress about scores. You're learning. Pick any published post and test it.
UNDERSTANDING SCORES
Five dimensions. Each measures something specific.
SENTIMENT
How content makes readers feel. Positive, neutral, negative.
Low score? Check for stress language, unintended negativity.
CLARITY
How easy to understand. Catches jargon and complexity.
Low score? Replace jargon. Split complex sentences.
ENGAGEMENT
What hooks readers and what loses them.
Low score? Strengthen hook. Cut boring sections.
TONE
How your voice lands. Must match audience expectations.
Low score? Adjust formality level to match audience.
READABILITY
Technical difficulty. Sentence length, word complexity.
Low score? Shorter sentences. Simpler words.
SCORE RANGES
- 80-100: Excellent
- 60-79: Good, minor fixes
- 40-59: Needs work
- 0-39: Major problems
AIM FOR 75+
Target 75+ across all dimensions. That's where content reliably works.
CHOOSE YOUR AUDIENCE
Three pre-built groups. Pick based on who you're writing for.
GENERAL PUBLIC
Everyday readers. Broad audience. No specialist knowledge.
- Values clarity above all
- Use for blog posts, general content
- Avoid jargon and assumptions
BUSINESS PROFESSIONALS
Corporate readers. Executives and managers.
- Values ROI, data, professionalism
- Use for B2B content, white papers
- Expect professional tone and metrics
YOUNG ADULTS (18-30)
Digital natives. Value authenticity.
- Values casual tone, no corporate speak
- Use for millennial/Gen Z marketing
- Avoid formality and trying too hard
TEST MULTIPLE GROUPS
Same content, different reactions. Test with all three to see how audiences differ.
YOUR PUBLISHING WORKFLOW
Make testing part of your process.
- Write draft
- Self-edit
- Test with focus group
- Read feedback carefully
- Make improvements (focus on lowest scores)
- Test again if major changes (30%+ rewrite)
- Publish when scores hit 75+
QUALITY GATE
Don't publish below 75 average. Make that your standard.
CUSTOM FOCUS GROUPS PRO
Build personas matching your exact audience.
HOW TO CREATE
- AI Focus Groups → Focus Groups
- Click "Add New Focus Group"
- Enter name and description
- Select expertise level
- Define persona details
- Save and activate
PERSONA DETAILS
- Identity: Age, occupation, role
- Context: When/where they read
- Values: What matters to them
- Behavior: How they read
- Frustrations: What annoys them
UNLIMITED GROUPS
Pro lets you create as many custom groups as you need. Build a library for all your audience segments.
AI PROVIDERS PRO
Switch between OpenAI, Claude, and Gemini.
OPENAI (GPT-4O)
- Fast, reliable, general-purpose
- Best for most content
- ~$0.005 per analysis
CLAUDE (ANTHROPIC)
- Nuanced tone analysis
- Best for sensitive topics
- ~$0.003-$0.015 per analysis
GOOGLE GEMINI
- Technical content, long articles
- Large context windows
- ~$0.001-$0.005 per analysis
HOW TO SWITCH
- Get API key from provider
- Settings → AI Focus Groups
- Select provider
- Paste API key
- Select model
- Save
ADVANCED FEATURES PRO
CONTENT REWRITES
Generate AI-powered rewrites based on feedback.
- Run analysis first
- Click "Generate Rewrite"
- Compare original vs rewritten
- Pick best suggestions
- Version history saves all rewrites
USING REWRITTEN CONTENT
Copy rewritten content directly into your post editor.
Step 1: Open the post you want to update
- Go to Posts → All Posts (or Pages → All Pages)
- Find the post you want to update
- Click "Edit" to open the editor
Step 2: Open the version modal
- Scroll to the "AI Content Focus Groups" meta box
- Click "View Versions" to open the version modal
- Review the available rewritten versions
Step 3: Copy the content you want
- Select the rewritten version you prefer
- Click the copy button next to any section (title, paragraph, etc.)
- You can click multiple copy buttons to add multiple sections to your clipboard
- Or use the "Copy All" button to copy the entire rewritten version at once
- All copied content is stored in your clipboard ready to paste
Step 4: Paste into your editor
- Gutenberg: Select the paragraph block and paste
- Elementor: Open text editor widget and paste
- Divi: Open text module and paste into content area
- WPBakery: Open text block and paste
- Classic Editor: Switch to text or visual tab and paste
Formatting is preserved. Works with any page builder that accepts text content.
TROUBLESHOOTING
BUTTON GREYED OUT
- Check API key configured
- Check focus groups exist
- Check rate limit (10/hour)
INVALID API KEY ERROR
- Remove spaces from key
- Check provider match
- Add billing to OpenAI
- Verify key exists in dashboard
ANALYSIS STUCK
- Check Job Queue for errors
- Try again (API timeout)
- Use instant mode
- Check WordPress cron
SCORES SEEM WRONG
- AI simulates personas (not truth)
- Test multiple groups
- Context matters
- Use as guidance
SYSTEM STATUS
Check AI Focus Groups → System Status for requirements: WordPress 6.0+, PHP 7.4+, HTTPS enabled.