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:
- Navigate to site settings
- Click "Advanced" tab
- Select "Run Diagnostics"
- Choose test components
- 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:
- Log into WordPress admin
- Navigate to Users → Profile
- Generate new application password
- Update in WP Automator
- Test connection again
Prevention:
- Use dedicated app passwords
- Don't share passwords
- Regularly rotate credentials
Problem: Username doesn't exist or was changed
Solution:
- Verify username in WordPress
- Check for typos or case sensitivity
- Update username in settings
- Consider using email instead
Prevention:
- Use email for stability
- Document username changes
- Avoid special characters
Problem: Authentication token has expired
Solution:
- Clear stored credentials
- Re-enter application password
- Enable "Remember Me" option
- 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:
- Verify certificate validity
- Check certificate chain
- Update certificate if expired
- Contact hosting provider
- Temporarily disable SSL check (not recommended)
Permission Issues
Insufficient Capabilities
Required WordPress Capabilities:
edit_posts
- Create and modify postspublish_posts
- Publish contentupload_files
- Add mediamanage_categories
- Create categoriesedit_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:
Operation | Excellent | Good | Needs 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:
- Gradual Load Test: Start with 1 request, increase gradually
- Spike Test: Send multiple simultaneous requests
- Endurance Test: Sustained load over time
- 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
- Use Application Passwords: Never use main account password
- Implement IP Whitelisting: Restrict API access
- Enable 2FA: Add extra security layer
- Regular Password Rotation: Change credentials periodically
- Monitor Access Logs: Track API usage
Performance Optimization
- Use Caching: Implement object and page caching
- Optimize Database: Regular maintenance and indexing
- CDN Integration: Offload static assets
- Rate Limiting: Prevent overload
- 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:
- Identify common pattern
- Check group settings
- Verify hosting status
- Test sample sites
- Apply fix to all affected
Next Steps
Ensure reliable operations with:
- Dashboard Overview for monitoring
- Error Handling Guide for issue resolution
- 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