Tools & Utilities
Diagnostic, testing, and maintenance tools for your CDN setup
Tools Page Overview
The Tools page provides several utilities to test, validate, and maintain your CDN configuration. Access it at 1 CDN Manager → Tools.
1. CDN Connection Test
What It Does
Tests if your configured CDN URLs are accessible and responding correctly.
How to Use
- Click the "Test CDN Connections" button
- The plugin will send test requests to each configured CDN
- Results show which CDNs are working and which have issues
What It Tests
- DNS Resolution: Can the CDN domain be resolved?
- HTTP Response: Does the CDN respond to requests?
- CORS Headers: Are proper CORS headers present?
- Content Delivery: Can files be fetched from the CDN?
Interpreting Results
✅ Green (Pass): CDN is configured correctly and working
❌ Red (Fail): CDN has issues - check the error message
⚠️ Yellow (Warning): CDN works but has potential issues
Common Errors
DNS Resolution Failed
- CDN domain doesn't exist or DNS not configured
- Check your DNS settings with your CDN provider
Connection Timeout
- CDN is not responding or server is down
- Check firewall settings
- Verify CDN is properly configured to serve content
404 Not Found
- CDN is working but files are not accessible
- Check origin configuration in your CDN dashboard
- Verify path structure matches your site
2. Configuration Status
What It Shows
Displays a summary of your current CDN configuration including:
- Which CDN types are enabled
- Configured CDN URLs
- Versioning status
- Additional settings status
Quick Reference
Use this section to quickly verify your setup without going through all settings tabs.
3. Clear Cache
Plugin Cache
The plugin caches certain operations for performance. Clear this cache when:
- You've changed CDN settings
- URLs are not being replaced correctly
- After updating the plugin
How to Clear
- Click "Clear Plugin Cache" button
- Confirmation message will appear
- Test your site to verify changes
Cache Directories
The plugin creates cache directories for optimized content:
/wp-content/cache/uscdn-css/- Cached CSS files/wp-content/cache/fonts/- Font cache
Regenerate .htaccess Files
Click "Regenerate .htaccess" to recreate cache directory rules with:
- CORS headers for cross-origin requests
- Proper MIME types for fonts
- Cache control headers
4. CDN URL Diagnostic Tool
What It Does
Advanced diagnostic that shows exactly how URLs are being replaced for different file types.
How to Use
- Click "Run Diagnostics" button
- Review the three sections of results:
- Database Settings: Shows what's configured
- URL Replacement Tests: Shows how test URLs are transformed
- Recommendations: Suggestions to fix issues
Understanding the Results
Database Settings Section
- Shows enabled status for each CDN type
- Displays configured CDN URLs
- Identifies missing configurations
URL Replacement Tests Section
- Tests sample URLs for each file type
- Shows original URL and replaced URL
- Indicates if routing is correct
Important Note
Verifying Frontend Behavior
To verify actual CDN behavior:
- Visit your website frontend (logged out)
- Right-click → Inspect Element → Network tab
- Reload the page
- Check URLs for images, videos, fonts
- They should use your configured CDN domains
5. System Information
What It Shows
Technical details about your WordPress environment:
- WordPress Version: Current WP version
- PHP Version: Server PHP version (minimum 7.4 required)
- Plugin Version: Current plugin version
- Active Plugins: List of installed and active plugins
- Theme: Current active theme
- Server Info: Server software and configuration
When to Use
- Before contacting support
- Troubleshooting compatibility issues
- Checking if your environment meets requirements
Copy to Clipboard
Use the "Copy System Info" button to copy all details for support tickets.
6. Export/Import Settings
Export Settings
Save your current CDN configuration to a JSON file:
- Click "Export Settings"
- A JSON file downloads with all your settings
- Save this file for backup or migration
Import Settings
Restore settings from a previously exported file:
- Click "Choose File"
- Select your exported JSON file
- Click "Import Settings"
- Settings will be applied immediately
Use Cases
- Backup: Save settings before making changes
- Migration: Move settings to staging/production
- Replication: Apply same settings across multiple sites
- Recovery: Restore after accidentally changing settings
What's Included
The export includes:
- All CDN URLs (Image, Media, Static, Fonts, Frontend)
- Enable/disable status for each CDN type
- Versioning settings and version strings
- Advanced options (rewriting, conflict detection, etc.)
- Source host configurations
Not included: Cloudflare API credentials (for security)
7. Conflict Detection
What It Does
Scans for other plugins that might conflict with CDN functionality:
- Other CDN plugins
- Caching plugins
- Image optimization plugins
- Performance optimization plugins
How to Use
- Click "Scan for Conflicts"
- Review detected plugins
- Follow recommendations to resolve conflicts
Common Conflicts
Other CDN Plugins
- CDN Enabler
- WP Offload Media
- Jetpack Site Accelerator
Recommendation: Disable other CDN plugins or use only one
Aggressive Caching
- WP Rocket
- W3 Total Cache
- WP Super Cache
Recommendation: Exclude CDN URLs from caching
Best Practices
Regular Maintenance
- Weekly: Run CDN connection test to ensure everything is working
- After Changes: Always clear cache after modifying settings
- Before Updates: Export settings as backup
Troubleshooting Workflow
- Run Configuration Status to check what's enabled
- Run CDN Connection Test to verify CDN accessibility
- Run CDN URL Diagnostic to test URL replacement
- Check System Information for compatibility issues
- Run Conflict Detection to find interfering plugins
Performance Tips
- Clear plugin cache regularly to ensure optimal performance
- Regenerate .htaccess files if you change CDN domains
- Use the diagnostic tool after major WordPress or theme updates