Maintenance Tools
The Tools section provides utilities for managing cache, optimizing database, and maintaining your site's performance.
Cache Management
Clear All Cache
Manually purge all cached files from Performance Toolkit's cache directory.
Use when:
- Content updated but cache not auto-purged
- Before client testing or demos
- After major site changes
- Cache seems stale
How to use:
- Go to Performance Toolkit → Tools
- Click Clear All Cache
- Confirm in dialog
- Cache files deleted
- Next page visit re-caches
Impact:
- Immediate effect
- Pages re-cached on next visitor request
- Small performance dip during re-caching
- Cache hit rate resets to 0% briefly
Clear Cache for Specific URL
If available, clear cache for specific pages/posts:
- Go to Performance Toolkit → Tools
- Click Clear Cache for URL (if available)
- Enter URL path (e.g.,
/blog/my-post/) - Click Clear
- That URL re-caches on next visit
Cache Statistics
Displays:
- Total cached files
- Cache directory size
- Percentage of total disk used
- Last cache purge timestamp
- Cache hit/miss statistics
Database Tools
Run Database Optimization
Manually trigger database cleanup without scheduling:
Cleans:
- Post revisions (keeps newest)
- Auto-draft posts
- Deleted post/comment trash
- Orphaned metadata
- Fragmented tables
- Table indexes
Before running:
- Backup database — always have recent backup
- Low-traffic window — run during off-hours
- Monitor completion — usually 1-5 minutes
How to use:
- Go to Performance Toolkit → Tools
- Click Run Database Optimization
- Select what to optimize:
- ✅ Remove post revisions
- ✅ Remove auto-drafts
- ✅ Empty trash
- ✅ Delete orphaned metadata
- ✅ Optimize tables
- Click Start
- Monitor progress
- View results when complete
Results show:
- Files removed
- Space recovered
- Time taken
- Any errors encountered
View Slow Queries
If available, see database queries taking longer than 1 second:
SELECT * FROM wp_posts WHERE ... [1.23 seconds]
SELECT * FROM wp_postmeta WHERE ... [0.95 seconds]
High slow query counts indicate:
- Missing database indexes
- Unoptimized queries
- Inefficient plugins
- Large database tables
What to do:
- Check if queries are from specific plugins
- Try disabling suspect plugins
- Run database optimization
- Contact hosting if persists
Asset Management
Purge Minified Assets Cache
Clear cached minified CSS/JavaScript files:
- Go to Performance Toolkit → Tools
- Click Purge Minified Assets (if available)
- All minified versions deleted
- Regenerated on next page view
When to use:
- After updating plugin/theme CSS/JS
- If CSS/JS changes not appearing
- To refresh cached minified versions
- After removing file minification exclusions
CDN Tools
Purge Cloudflare Cache
If Cloudflare is configured, manually purge cache:
- Go to Performance Toolkit → Tools
- Click Purge Cloudflare Cache
- All Cloudflare edge cache cleared
- Content re-caches on next global visitor request
When to use:
- Content updated but Cloudflare cache not auto-purged
- Before testing global performance
- After DNS changes
- When troubleshooting cache issues
Impact:
- Immediate purge across all Cloudflare locations
- First visitor after purge is slightly slower (cache miss)
- Subsequent visitors normal (cache rebuilds)
Optimization Tools
Refresh Performance Metrics
Manually update System Status metrics:
- Go to Performance Toolkit → Tools
- Click Refresh Metrics (if available)
- Metrics recalculated
- Dashboard updates
Note: Metrics typically auto-update every few minutes; manual refresh rarely needed.
Generate Asset Report
Create analysis of current CSS/JS files:
CSS Files: 12
- external: 8 files, 245 KB
- inline: 4 instances, 15 KB
- deferred: 0 files
JavaScript Files: 18
- external: 14 files, 580 KB
- inline: 4 instances, 25 KB
- deferred: 3 files
Useful for:
- Understanding what assets are loaded
- Identifying optimization opportunities
- Finding unused dependencies
- Debugging performance issues
Diagnostics
Run Performance Diagnostics
Scan site for common performance issues:
Checks:
- ✅ Caching enabled and working
- ✅ Minification configured correctly
- ✅ Image lazy loading active
- ✅ Database query count reasonable
- ✅ Unused plugins installed
- ✅ PHP version supported
- ✅ Disk space available
- ✅ Memory usage normal
Results:
- List of found issues
- Severity (critical, warning, info)
- Recommended actions
- Links to relevant settings
Example report:
WARNING: Database has 2,000+ post revisions (recommended cleanup)
INFO: 18 plugins active; 2 appear unused
CRITICAL: Only 5% disk space remaining
GOOD: PHP 8.1 installed
Testing Tools
Performance Test
Run lightweight performance test:
- Access home page
- Measure load time
- Check cache effectiveness
- Compare to baseline
Useful for:
- Testing after optimizations
- Before/after comparisons
- Verifying performance claims
- Troubleshooting slowness
Lighthouse Integration (if available)
Run Google Lighthouse test directly from plugin:
- Go to Tools
- Click Run Lighthouse Test
- Select Mobile or Desktop
- Plugin runs test against your site
- Results display with recommendations
Provides:
- Performance score (0-100)
- Core Web Vitals
- Specific recommendations
- Links to fix each issue
Settings Management
Export Settings
Backup your Performance Toolkit configuration:
- Go to Performance Toolkit → Tools
- Click Export Settings
- Downloads JSON file with all settings
- Save safely
Why export:
- Migrate site to new hosting
- Document configuration
- Share settings with developer
- Rollback restore
Import Settings
Restore settings from export:
- Go to Performance Toolkit → Tools
- Click Import Settings
- Upload previously exported JSON file
- Choose to merge or replace
- Settings restored
When to import:
- Moving site to new hosting
- Duplicating settings to another site
- Reverting to previous configuration
- Applying known-good settings
Maintenance Schedule
Recommended Maintenance
| Task | Frequency | Reason |
|---|---|---|
| Clear cache | Daily (auto) | Keeps content fresh |
| Monitor metrics | Weekly | Track performance trends |
| Database cleanup | Monthly | Recovers space, speeds queries |
| Review recommendations | Monthly | Act on optimization suggestions |
| Check disk space | Monthly | Ensure cache has room |
| Update plugin | On release | Bug fixes, new features |
| Purge CDN | As needed | Site updates reflected globally |
Automated Maintenance
Tools available for scheduling:
- Auto cache purge on content updates (enabled by default)
- Scheduled database cleanup (if available)
- Automatic metric refresh
- Background minification updates
Troubleshooting
Tool not working or showing error
- Refresh page — try again
- Check error message — note exact error text
- Clear browser cache — old page cached
- Try again — transient errors pass
- Contact support — provide error text
Performance didn't improve after tools
Tools manage existing optimizations; they don't add new ones:
- Run diagnostics to find issues
- Enable optimization features in main settings
- Combine multiple optimizations
- See System Status for improvement tracking
Can't find Tools page
Tools located at: Performance Toolkit → (Main menu) → Tools
If not visible:
- Ensure Performance Toolkit is activated
- Verify administrator permissions
- Refresh page
Best Practices
- ✅ Check maintenance tools monthly
- ✅ Run database cleanup quarterly
- ✅ Monitor cache statistics weekly
- ✅ Act on diagnostic recommendations
- ✅ Backup before and after major actions
- ✅ Clear cache after content updates
- ✅ Review performance metrics regularly
Remember: Tools help manage optimizations already configured. First enable optimization features in main settings, then use tools to maintain and monitor.
Performance Toolkit's tools keep your site optimized and healthy 24/7.