Troubleshooting Guide

Problem: Unable to connect to WordPress site

Possible Causes:

• Incorrect site URL
• Site is offline
• Firewall blocking requests
• SSL certificate issues

Solutions:

Steps to Resolve:
  1. Verify Site URL:
     - Check for typos
     - Include https:// or http://
     - Remove trailing slashes
     - Test in browser
  
  2. Check Site Status:
     - Visit site directly
     - Check hosting status
     - Verify DNS resolution
  
  3. Firewall Settings:
     - Whitelist WP Automator IPs
     - Check security plugins
     - Review hosting firewall
  
  4. SSL Issues:
     - Update expired certificates
     - Fix mixed content warnings
     - Check certificate chain

Problem: WordPress authentication errors

Error Messages:

• "Invalid username or password"
• "Application password required"
• "User lacks required capabilities"

Solutions:

Authentication Fixes:
  1. Application Password:
     - Generate new app password
     - Remove spaces when copying
     - Check password hasn't expired
     - Ensure user has permissions
  
  2. User Permissions:
     Required Role: Editor or Administrator
     Required Capabilities:
       - edit_posts
       - publish_posts
       - upload_files
       - manage_categories
  
  3. Security Plugins:
     - Disable 2FA for API access
     - Whitelist application
     - Check login restrictions
  
  4. REST API Access:
     - Ensure REST API enabled
     - Check .htaccess rules
     - Verify permalink settings

Quick Fix Script:

// Add to functions.php temporarily
add_filter('rest_authentication_errors', function($result) {
    if (!empty($result)) {
        return $result;
    }
    if (!is_user_logged_in()) {
        return new WP_Error('rest_not_logged_in', 
            'You are not currently logged in.', 
            array('status' => 401));
    }
    return $result;
});

Problem: Requests timing out

Symptoms:

• "Request timeout after 30000ms"
• "ETIMEDOUT" errors
• Slow response times

Solutions:

Timeout Resolutions:
  1. Server Performance:
     - Upgrade hosting plan
     - Optimize database
     - Clear cache
     - Reduce plugins
  
  2. Network Issues:
     - Check latency to server
     - Use CDN for assets
     - Enable compression
  
  3. WP Automator Settings:
     - Increase timeout values
     - Reduce batch sizes
     - Enable retry logic
  
  4. WordPress Optimization:
     - Install caching plugin
     - Optimize images
     - Minify CSS/JS
     - Use object caching

Problem: Content generation fails

Common Errors:

{
  "error": "Content generation failed",
  "code": "GENERATION_ERROR",
  "details": "Generation service returned empty response"
}

Troubleshooting Steps:

Problem: Generated content quality issues

Quality Problems:

• Repetitive content
• Off-topic generation
• Grammar errors
• Incomplete articles

Improvement Strategies:

Quality Enhancement:
  Prompt Optimization:
    - Be specific and detailed
    - Include examples
    - Set clear constraints
    - Define target audience
  
  Content Optimization:
    Better Quality:
      - Increase word count for complex topics
      - Use detailed prompts for better results
    
    Balance Quality/Cost:
      - Standard settings for most content
      - Upgrade for critical pieces
  
  Settings Adjustment:
    - Increase temperature for creativity
    - Decrease for factual content
    - Adjust max tokens for length
    - Fine-tune top_p parameter
  
  Post-Processing:
    - Enable grammar checking
    - Add SEO optimization
    - Include fact-checking
    - Apply style guides

Problem: Content formatting problems

Common Issues:

• Broken HTML
• Missing paragraphs
• Incorrect headings
• Lost formatting

Solutions:

// Formatting fixes
const formatFixes = {
  html_cleanup: {
    issue: "Broken HTML tags",
    fix: "Enable HTML sanitization",
    setting: "sanitize_html: true"
  },
  
  paragraph_breaks: {
    issue: "Missing paragraphs",
    fix: "Adjust paragraph detection",
    setting: "auto_paragraph: true"
  },
  
  heading_structure: {
    issue: "Incorrect heading hierarchy",
    fix: "Enable heading normalization",
    setting: "normalize_headings: true"
  },
  
  special_characters: {
    issue: "Character encoding issues",
    fix: "Set UTF-8 encoding",
    setting: "charset: 'UTF-8'"
  }
};

Optimize Generation Speed:

Performance Improvements:
  1. Generation Optimization:
     - Use standard generation settings
     - Reduce content length
     - Adjust quality settings
  
  2. Batch Processing:
     - Group similar content
     - Use templates
     - Cache common elements
  
  3. Parallel Processing:
     - Enable concurrent generation
     - Increase worker count
     - Optimize queue settings
  
  4. Caching Strategy:
     - Cache prompts
     - Store templates
     - Reuse components

Speed Up Publishing:

Publishing Optimization:
  1. WordPress Site:
     - Optimize database
     - Enable caching
     - Upgrade hosting
     - Reduce plugins
  
  2. Network:
     - Use closer servers
     - Enable compression
     - Implement CDN
  
  3. Batch Settings:
     - Reduce batch size
     - Sequential publishing
     - Implement delays
  
  4. Content Size:
     - Optimize images
     - Minimize HTML
     - External media hosting

Improve Interface Speed:

UI Optimization:
  1. Browser:
     - Clear cache/cookies
     - Disable extensions
     - Update browser
     - Use Chrome/Firefox
  
  2. Data Loading:
     - Enable pagination
     - Reduce page size
     - Filter unnecessary data
  
  3. Real-time Updates:
     - Adjust refresh rate
     - Disable live updates
     - Use manual refresh
  
  4. Local Issues:
     - Check internet speed
     - Close other tabs
     - Restart browser