Content Guard Pro includes a comprehensive diagnostics tool to verify your installation and troubleshoot issues.

Accessing Diagnostics #

Navigate to Content Guard Pro → Diagnostics

Diagnostic Checks #

Environment Check #

Verifies your server meets requirements:

Check	Requirement	Status
——-	————-	——–
PHP Version	8.0+	✓ Pass / ✗ Fail
WordPress Version	6.1+	✓ Pass / ✗ Fail
Memory Limit	64MB+ recommended	✓ Pass / ⚠ Warning
Max Execution Time	30s+ recommended	✓ Pass / ⚠ Warning

Database Check #

Verifies plugin tables exist and are accessible:

Table	Status
——-	——–
{prefix}content_guard_pro_findings	✓ Exists / ✗ Missing
{prefix}content_guard_pro_scans	✓ Exists / ✗ Missing
{prefix}content_guard_pro_audit_log	✓ Exists / ✗ Missing

Scheduler Check #

Verifies Action Scheduler is working:

• Action Scheduler version
• Pending actions count
• Failed actions count
• Next scheduled scan

API Connection Check #

Tests external service connectivity:

• Google Safe Browsing (if enabled)
• PhishTank (if enabled)
• WordPress.org API (for updates)

Pattern Engine Check #

Verifies detection patterns are loaded:

• Pattern count
• Last pattern update
• Sample pattern test

Running Full Diagnostics #

1. Go to Content Guard Pro → Diagnostics
2. Click Run Full Diagnostics
3. Wait for all checks to complete
4. Review results

Understanding Results #

Status Indicators #

Icon	Status	Meaning
——	——–	———
✓ Green	Pass	Everything working correctly
⚠ Yellow	Warning	Works but not optimal
✗ Red	Fail	Requires attention

Expandable Details #

Click any check to see more information:

• Technical details
• Current vs. required values
• Suggested fixes

Copying Diagnostic Report #

For Support Requests #

1. Run full diagnostics
2. Click Copy Diagnostics to Clipboard
3. Paste into support ticket or email

Report Contents #

The report includes:

• All diagnostic results
• WordPress version and configuration
• Active theme and plugins (names only)
• PHP configuration
• Server software

Sensitive Data #

The report does NOT include:

• API keys or passwords
• Site URLs (anonymized)
• User information
• Actual content or findings

Individual Tests #

Test Pattern Matching #

1. Go to Diagnostics
2. Find Pattern Test section
3. Enter sample content
4. Click Test Patterns
5. See which patterns match

Useful for:

• Understanding why content triggers findings
• Testing custom denylist patterns
• Verifying allowlist is working

Test Database Connection #

1. Click Test Database
2. Verifies read/write access
3. Reports query execution time

Test API Connections #

1. Click Test API Connections
2. Checks each enabled service
3. Reports response times and status

Automatic Diagnostics #

Content Guard Pro runs basic checks automatically:

On Plugin Activation #

• Verifies requirements met
• Creates database tables
• Schedules initial checks

On Admin Page Load #

• Checks for critical issues
• Displays admin notices if problems found

During Scans #

• Monitors performance metrics
• Auto-throttles if issues detected
• Logs errors for diagnostics

Interpreting Common Results #

“Memory Limit Warning” #

Issue: PHP memory limit below recommended

Solutions:
1. Increase in wp-config.php:

   define('WP_MEMORY_LIMIT', '256M');
   

2. Contact host to increase limit
3. Enable Safe Mode for lower memory usage

“Database Table Missing” #

Issue: Plugin tables don’t exist

Solutions:
1. Deactivate and reactivate plugin
2. Check database user has CREATE TABLE permission
3. Run manual table creation (see Troubleshooting)

“Action Scheduler Not Running” #

Issue: Background tasks not executing

Solutions:
1. Check WP-Cron is working
2. Verify no cron-disabling plugins active
3. Set up server cron job as alternative

“API Connection Failed” #

Issue: Can’t reach external services

Solutions:
1. Check server allows outbound HTTPS
2. Verify firewall settings
3. Check if host blocks external requests
4. Test API key validity

Logs #

Accessing Logs #

1. Go to Diagnostics
2. Click View Logs tab
3. Select log type and date range

Log Types #

Log	Contents
—–	———-
Scan Log	Scan operations and results
Error Log	PHP errors and exceptions
API Log	External API requests/responses
Action Log	User actions and changes

Log Retention #

• Logs kept for 30 days by default
• Configurable in Settings
• Older logs automatically purged

Exporting Logs #

1. Select log type
2. Set date range
3. Click Export
4. Download as text file

Useful for detailed troubleshooting or support requests.