WordPress Plugin Support
Troubleshoot and support WordPress plugin installations
Platform administrators can assist organizations with WordPress plugin issues.
Support Capabilities
Plugin Installation Issues
Plugin fails to activate
Common causes:
- PHP version incompatibility (requires PHP 8.2+)
- WordPress version too old (requires 6.0+)
- Conflicting plugins
- Insufficient server permissions
Troubleshooting steps:
- Check PHP version in WordPress Site Health
- Verify WordPress version compatibility
- Temporarily disable other plugins to identify conflicts
- Check file permissions on wp-content/plugins directory
API connection failures
Common causes:
- Invalid API credentials
- Firewall blocking outbound connections
- SSL certificate issues
- Organization API key expired
Troubleshooting steps:
- Verify API key in plugin settings matches organization's key
- Test API endpoint connectivity from server
- Check SSL certificate validity
- Regenerate API key if necessary
Shortcode rendering issues
Common causes:
- Theme conflicts with shortcode output
- Caching plugin serving stale content
- JavaScript errors blocking dynamic content
- Missing required shortcode attributes
Troubleshooting steps:
- Test with default theme (Twenty Twenty-Four)
- Clear all caching layers
- Check browser console for JS errors
- Verify shortcode syntax and required parameters
Diagnostic Tools
Health Check Endpoint
GET /api/wordpress/health-check
Authorization: Bearer {admin_token}Response:
{
"status": "healthy",
"wordpress_version": "6.4.2",
"php_version": "8.2.12",
"plugin_version": "3.0.0",
"api_connection": "ok",
"last_sync": "2025-01-15T10:30:00Z"
}Sync Status
GET /api/wordpress/sync-status/{organization_id}
Authorization: Bearer {admin_token}Escalation Path
If issues cannot be resolved:
- Collect diagnostic information (health check, error logs)
- Document reproduction steps
- Escalate to development team via internal ticket
- Provide organization with estimated resolution timeline