Write Pilot Documentation

Installation

Requirements

Before installing Write Pilot, ensure your server meets these requirements:

• WordPress 5.8 or higher
• PHP 7.4 or higher (PHP 8.0+ recommended)
• MySQL 5.7+ or MariaDB 10.3+
• At least 128MB PHP memory limit (256MB recommended)
• SSL certificate (HTTPS) for API communications

Installation Steps

1. Download the Plugin: After purchase, download the write-pilot.zip file from your account dashboard.
2. Upload to WordPress: Go to Plugins → Add New → Upload Plugin and select the downloaded ZIP file.
3. Activate: Click "Install Now" and then "Activate Plugin".
4. Enter License Key: Navigate to Write Pilot → License and enter your license key from the purchase email.
5. Configure AI Models: Go to Write Pilot → Settings and add your API keys.

License Activation

Write Pilot uses Lemon Squeezy for license management. Your license key was sent to your email after purchase.

1. Go to Write Pilot → License in your WordPress admin.
2. Enter your license key in the provided field.
3. Click "Activate License".
4. You'll see a confirmation message with your license status and site limit.

Configuration

Basic Settings

Navigate to Write Pilot → Settings to configure the core settings:

Content Settings

• Default Post Status: Choose whether generated content should be saved as Draft, Pending Review, or Published.
• Post Type: Select the post type for generated content (Posts, Pages, or custom post types).
• Author: Assign a default author for generated content.
• Content Length: Set target word count (500-3000 words recommended).

Domain Core (Niche Selection)

Write Pilot includes 20 specialized domain cores for context-aware content generation:

• Technology: Software, gadgets, AI, cybersecurity
• Automotive: Cars, motorcycles, EVs, auto industry
• Health: Medical, wellness, nutrition, fitness
• Travel: Destinations, hotels, travel tips
• Finance: Investing, personal finance, crypto
• Food: Recipes, restaurants, cooking tips
• Fashion: Style, trends, clothing
• Beauty: Skincare, makeup, cosmetics
• Home: Decor, DIY, real estate
• Parenting: Kids, family, education
• Pets: Dogs, cats, pet care
• Gaming: Video games, esports, reviews
• Entertainment: Movies, TV, music
• Sports: Teams, athletes, events
• Business: Entrepreneurship, marketing, careers
• Science: Research, discoveries, environment
• Education: Learning, courses, skills
• Lifestyle: General living, tips, advice
• Legal: Law, regulations, compliance
• Marketing: SEO, social media, advertising

AI Auto-Categorization

Enable automatic category assignment for generated content:

• Enable Auto-Categorization: Toggle on to let AI assign categories.
• Confidence Threshold: Set minimum confidence (default: 0.75 or 75%). Lower values assign categories more liberally.
• Category Whitelist: Select which categories the AI can assign to.
• Fallback Category: Default category when AI confidence is below threshold.

WebP Media Engine

Configure automatic image fetching for your content:

Image Sources

• Pexels API Key: Get your free API key from pexels.com/api
• Unsplash Access Key: Get your key from unsplash.com/developers

Media Settings

• Image Format: WebP (recommended for best compression)
• Featured Image: Automatically set first image as featured
• Images Per Post: Number of images to include (1-5)
• Image Size: Large, Medium, or Small

AI Models Setup

Write Pilot supports 9 AI models across 3 providers. Configure your preferred models and set up the auto-fallback chain for uninterrupted content generation.

Claude (Anthropic)

To use Claude models, you need an Anthropic API key:

1. Visit console.anthropic.com
2. Create an account or sign in
3. Navigate to API Keys section
4. Create a new API key
5. Copy the key and paste it in Write Pilot settings

Available Claude Models

• claude-opus-4-6: Most capable, best for complex content (highest cost)
• claude-sonnet-4-6: Balanced performance and cost (recommended)
• claude-haiku: Fastest, most affordable, good for simple content

OpenAI GPT

To use GPT models:

1. Visit platform.openai.com
2. Create an account or sign in
3. Go to API Keys in your account
4. Create a new secret key
5. Copy and paste in Write Pilot settings

Available GPT Models

• GPT-4o: Latest flagship model, excellent quality
• GPT-4o-mini: Smaller, faster, more affordable
• o3-mini: Optimized for reasoning tasks

Google Gemini

To use Gemini models:

1. Visit Google AI Studio
2. Sign in with your Google account
3. Create an API key
4. Copy and paste in Write Pilot settings

Available Gemini Models

• Gemini 2.0 Flash: Fast, efficient, great for most content
• Gemini 2.5 Pro: Most capable, best quality
• Gemini Flash-Lite: Fastest, most affordable option

Auto-Fallback Chain

Configure the order of models for automatic fallback. If your primary model returns an error or 404, Write Pilot automatically switches to the next model in your chain.

Example Fallback Chain:
1. claude-sonnet-4-6 (Primary)
2. gpt-4o (Secondary)
3. gemini-2.0-flash (Tertiary)

Scheduling

Write Pilot includes a powerful scheduling system for automated content generation. Configure your publishing rhythm and let the plugin handle the rest.

Basic Scheduling Options

• Daily Quota: Maximum number of posts to generate per day (1-20)
• Run Window: Time range when generation should occur (e.g., 8:00 AM - 6:00 PM)
• Minimum Interval: Minimum time between posts (e.g., 2 hours)
• Days of Week: Select which days to generate content

Multi-Site Stagger

For Professional and Agency plans managing multiple sites, use Site Offset to stagger content generation:

Site 1: Offset 0 (generates at scheduled time)
Site 2: Offset 30 (generates 30 minutes later)
Site 3: Offset 60 (generates 1 hour later)

This prevents all your sites from hitting AI APIs simultaneously and distributes server load.

Keyword Queue

Add keywords to your generation queue:

1. Navigate to Write Pilot → Keywords
2. Enter keywords (one per line or comma-separated)
3. Select priority level (High, Medium, Low)
4. Click "Add to Queue"

The scheduler processes keywords in priority order. High-priority keywords are processed first.

URL Mode

Generate content inspired by existing URLs:

1. Navigate to Write Pilot → URL Mode
2. Enter source URLs (competitors, references, etc.)
3. Write Pilot extracts key topics and generates original content

Webhook on Publish

Trigger external actions when content is published:

1. Go to Write Pilot → Settings → Webhooks
2. Enter your webhook URL
3. Select events to trigger (Post Published, Post Scheduled, etc.)
4. Save settings

Webhook payload includes post ID, title, URL, categories, and generation metadata.

Troubleshooting

Common Issues

Content Generation Fails

Symptoms: Posts not being created, error messages in logs.

Solutions:

• Verify your API keys are correct and have sufficient credits
• Check that your fallback chain has multiple models configured
• Ensure your server's PHP memory limit is at least 128MB
• Verify SSL certificate is valid (required for API calls)

Images Not Fetching

Symptoms: Posts published without images.

Solutions:

• Verify Pexels and/or Unsplash API keys are entered
• Check API rate limits (Pexels: 200/hour, Unsplash: 50/hour free tier)
• Try shorter keywords for better image matches
• Ensure allow_url_fopen is enabled in PHP

Scheduling Not Working

Symptoms: Posts not generated at scheduled times.

Solutions:

• Verify WordPress cron is running (check with WP Crontrol plugin)
• If using real cron, ensure it's configured correctly in cPanel/server
• Check that "Run Window" times match your timezone settings
• Verify daily quota hasn't been reached

License Activation Fails

Symptoms: "Invalid license key" error.

Solutions:

• Copy the license key directly from your purchase email (avoid extra spaces)
• Check your site limit hasn't been reached
• Ensure your site can reach api.lemonsqueezy.com
• Try deactivating and reactivating the license

Timeout Errors

Symptoms: "Maximum execution time exceeded" errors.

Solutions:

• Write Pilot sets set_time_limit(300) but your host may override this
• Contact your host to increase PHP max_execution_time
• Try using faster AI models (Haiku, GPT-4o-mini, Flash-Lite)
• Reduce content length settings

Debug Mode

Enable debug logging for detailed troubleshooting:

1. Go to Write Pilot → Settings → Advanced
2. Enable "Debug Mode"
3. Check logs at wp-content/write-pilot-logs/

FAQ

General Questions

Is the content unique?

Yes. Write Pilot generates 100% original content using AI. Each article is created fresh based on your keywords, domain core, and seed prompts. We do not spin or rewrite existing content.

Will this work with my theme?

Yes. Write Pilot creates standard WordPress posts/pages that work with any theme. The generated HTML is clean and follows WordPress coding standards.

Do I need API keys from all providers?

No. You only need an API key from at least one provider (Claude, OpenAI, or Google). However, we recommend configuring multiple providers for the auto-fallback feature.

What's the cost of AI API calls?

Write Pilot requires your own API keys. Costs vary by provider and model:

• Claude Haiku: ~$0.01-0.03 per article
• GPT-4o-mini: ~$0.02-0.05 per article
• Gemini Flash: ~$0.01-0.02 per article

Premium models cost more but produce higher quality content.

Can I edit generated content?

Absolutely! Generated posts are standard WordPress posts. Edit them using the block editor, classic editor, or any page builder.

Licensing

What's included in lifetime access?

Your one-time payment includes:

• Permanent license for your site limit
• All future updates (features & security)
• Email support
• Access to documentation and resources

Can I upgrade my plan?

Yes! Contact support to upgrade from Starter to Professional or Agency. You'll only pay the difference.

What happens if I change domains?

Deactivate the license on your old domain, then activate on the new one. Same license key, new site.

Technical Questions

Does Write Pilot work with multisite?

Yes, but each subsite counts as one site toward your license limit. For multisite networks, we recommend the Agency plan.

Is there a trial or demo?

Write Pilot includes a trial mode that lets you test basic functionality before activating your license. Full features require a valid license.

How does the auto-fallback work?

When your primary AI model returns an error (404, rate limit, etc.), Write Pilot automatically tries the next model in your configured chain. This happens transparently with no action needed from you.

Can I use this for client sites?

Yes! The Professional (10 sites) and Agency (unlimited) plans are perfect for agencies managing client WordPress sites.