WP Automator
Site Management

Testing Connections

Verify and troubleshoot WordPress site connections

Ensuring reliable connections between WP Automator and your WordPress sites is crucial for smooth operation. This guide covers comprehensive connection testing, troubleshooting common issues, and maintaining optimal connectivity.

Why Test Connections?

Regular connection testing helps:

  • Verify credentials are valid and working
  • Detect issues before bulk operations
  • Monitor performance and response times
  • Ensure permissions are properly configured
  • Validate API endpoints are accessible

Quick Connection Test

Running a Basic Test

Select Site Navigate to your site in the dashboard

Click Test Connection Use the lightning bolt icon or right-click menu

Review Results Check the status indicator and response details

Take Action Fix any issues or proceed with operations

Test Results Explained

Green Checkmark - All Systems Go

  • API connection successful
  • Authentication verified
  • Permissions adequate
  • Response time < 2 seconds

Details Provided:

  • WordPress version
  • Active theme
  • Plugin count
  • User role
  • API response time

Yellow Alert - Attention Needed

  • Connection successful but slow (>3 seconds)
  • Limited permissions detected
  • Outdated WordPress version
  • Plugin conflicts possible

Common Warnings:

  • "Slow response time may affect bulk operations"
  • "User lacks editor capabilities"
  • "WordPress version outdated"

Red X - Connection Failed

  • Invalid credentials
  • Site unreachable
  • API disabled
  • SSL certificate issues

Error Types:

  • Authentication failure
  • Network timeout
  • 404 - API not found
  • 403 - Forbidden access

Comprehensive Testing

Full Diagnostic Test

Run a complete diagnostic to verify all functionalities:

Diagnostic Test Checklist:
API Discovery - Locate REST API endpoints
✓ Authentication - Verify credentials
✓ Permissions - Check user capabilities
✓ Post Creation - Test write access
✓ Media Upload - Verify media permissions
✓ Category Access - List categories
✓ Plugin Detection - Identify active plugins
✓ Performance - Measure response times

Test Components

API Discovery

Verifies REST API is enabled and accessible

Authentication

Validates username and application password

Permissions

Checks create, read, update, delete capabilities

Performance

Measures latency and throughput

Running Advanced Tests

Access advanced testing options:

  1. Navigate to site settings
  2. Click "Advanced" tab
  3. Select "Run Diagnostics"
  4. Choose test components
  5. Review detailed report

Pro Tip: Schedule automatic connection tests daily to catch issues early.

Common Connection Issues

Authentication Failures

Problem: Application password is incorrect or revoked

Solution:

  1. Log into WordPress admin
  2. Navigate to Users → Profile
  3. Generate new application password
  4. Update in WP Automator
  5. Test connection again

Prevention:

  • Use dedicated app passwords
  • Don't share passwords
  • Regularly rotate credentials

Problem: Username doesn't exist or was changed

Solution:

  1. Verify username in WordPress
  2. Check for typos or case sensitivity
  3. Update username in settings
  4. Consider using email instead

Prevention:

  • Use email for stability
  • Document username changes
  • Avoid special characters

Problem: Authentication token has expired

Solution:

  1. Clear stored credentials
  2. Re-enter application password
  3. Enable "Remember Me" option
  4. Extend token lifetime in WordPress

Prevention:

  • Set longer token expiry
  • Enable auto-renewal
  • Monitor expiry dates

Network Issues

Timeout Errors

Symptoms:

  • "Request timeout after 30 seconds"
  • Intermittent connection failures
  • Slow response times

Solutions:

Quick Fixes:
  - Increase timeout to 60 seconds
  - Check server load
  - Verify hosting resources
  - Test from different location

Long-term Solutions:
  - Upgrade hosting plan
  - Implement caching
  - Optimize database
  - Use CDN for assets

SSL Certificate Problems

Common SSL Errors:

Invalid Certificate

Certificate expired or misconfigured

Mixed Content

HTTP resources on HTTPS site

Certificate Mismatch

Domain doesn't match certificate

Self-Signed

Certificate not from trusted authority

Resolution Steps:

  1. Verify certificate validity
  2. Check certificate chain
  3. Update certificate if expired
  4. Contact hosting provider
  5. Temporarily disable SSL check (not recommended)

Permission Issues

Insufficient Capabilities

Required WordPress Capabilities:

  • edit_posts - Create and modify posts
  • publish_posts - Publish content
  • upload_files - Add media
  • manage_categories - Create categories
  • edit_others_posts - Modify any post

Granting Permissions:

Log into WordPress as administrator

Navigate to Users → All Users

Edit the API user account

Change role to Editor or Administrator

Save changes and retest connection

Security Note: Use minimum required permissions. Editor role is usually sufficient.

API Endpoint Verification

Checking REST API Availability

Test if REST API is accessible:

# Manual test via browser or curl
https://yoursite.com/wp-json/wp/v2/posts

# Expected response
{
  "posts": [...],
  "status": "success"
}

Common API Issues

REST API Disabled:

  • Check if plugin is blocking API
  • Verify .htaccess rules
  • Review security plugin settings
  • Ensure permalink structure is set

Custom API Routes:

// If using custom routes, configure in settings
/wp-json/custom/v1/
/api/wp/v2/
/rest-api/

Performance Testing

Response Time Analysis

Monitor and optimize connection performance:

Key Performance Indicators:

  • Initial connection: < 1 second
  • API response: < 2 seconds
  • Post creation: < 3 seconds
  • Media upload: < 5 seconds per MB

Measurement Tools:

  • Built-in diagnostics
  • Server monitoring
  • Network profiling
  • Database query analysis

Performance Standards:

OperationExcellentGoodNeeds Improvement
Connection< 500ms< 2s> 3s
List Posts< 1s< 3s> 5s
Create Post< 2s< 5s> 10s
Upload Image< 3s< 7s> 15s

Optimization Strategies:

  • Enable object caching
  • Optimize database queries
  • Implement CDN
  • Upgrade PHP version
  • Increase memory limits
  • Use persistent connections
  • Enable HTTP/2
  • Compress API responses

Load Testing

Test site capacity for bulk operations:

  1. Gradual Load Test: Start with 1 request, increase gradually
  2. Spike Test: Send multiple simultaneous requests
  3. Endurance Test: Sustained load over time
  4. Stress Test: Find breaking point

Automated Monitoring

Setting Up Health Checks

Configure automatic connection monitoring:

{
  "monitoring": {
    "enabled": true,
    "interval": "5 minutes",
    "checks": [
      "api_availability",
      "authentication",
      "response_time",
      "error_rate"
    ],
    "alerts": {
      "email": true,
      "dashboard": true
    }
  }
}

Alert Configuration

Set up notifications for connection issues:

  • Immediate Alerts: Connection failures
  • Warning Alerts: Slow response times
  • Daily Summary: Overall health report
  • Weekly Report: Performance trends

Troubleshooting Tools

Built-in Diagnostics

WP Automator provides several diagnostic tools:

Connection Debugger

Step-by-step connection analysis

Log Viewer

Real-time error and debug logs

Network Tracer

Trace request path and timing

Permission Checker

Verify all required capabilities

External Testing Tools

Supplement with external tools:

  • Postman: Test API endpoints manually
  • cURL: Command-line API testing
  • Browser DevTools: Network inspection
  • Pingdom: Uptime monitoring
  • GTmetrix: Performance analysis

Debug Mode

Enable debug mode for detailed information:

Navigate to site settings

Enable "Debug Mode" toggle

Reproduce the issue

Check debug logs for details

Disable debug mode when done

Important: Debug mode may expose sensitive data. Use only for troubleshooting.

Connection Best Practices

Security Recommendations

  1. Use Application Passwords: Never use main account password
  2. Implement IP Whitelisting: Restrict API access
  3. Enable 2FA: Add extra security layer
  4. Regular Password Rotation: Change credentials periodically
  5. Monitor Access Logs: Track API usage

Performance Optimization

  1. Use Caching: Implement object and page caching
  2. Optimize Database: Regular maintenance and indexing
  3. CDN Integration: Offload static assets
  4. Rate Limiting: Prevent overload
  5. Connection Pooling: Reuse connections

Maintenance Schedule

Regular maintenance tasks:

  • Daily: Automated health checks
  • Weekly: Performance review
  • Monthly: Security audit
  • Quarterly: Credential rotation
  • Annually: Full system review

Recovery Procedures

Connection Recovery

When connections fail:

Identify Issue Check error messages and logs

Quick Fixes Try common solutions first

Verify WordPress Check site is accessible

Update Credentials Regenerate if needed

Contact Support If issue persists

Bulk Recovery

For multiple site failures:

  1. Identify common pattern
  2. Check group settings
  3. Verify hosting status
  4. Test sample sites
  5. Apply fix to all affected

Next Steps

Ensure reliable operations with:

  1. Dashboard Overview for monitoring
  2. Error Handling Guide for issue resolution
  3. Troubleshooting Guide for complex issues

Having connection issues? Our support team is available 24/7 to help diagnose and resolve any problems.

Last updated on

Testing Connections | WP Automator