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:

1. Check PHP version in WordPress Site Health
2. Verify WordPress version compatibility
3. Temporarily disable other plugins to identify conflicts
4. 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:

1. Verify API key in plugin settings matches organization’s key
2. Test API endpoint connectivity from server
3. Check SSL certificate validity
4. 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:

1. Test with default theme (Twenty Twenty-Four)
2. Clear all caching layers
3. Check browser console for JS errors
4. 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:

1. Collect diagnostic information (health check, error logs)
2. Document reproduction steps
3. Escalate to development team via internal ticket
4. Provide organization with estimated resolution timeline