Troubleshooting

This reference guide helps you diagnose and resolve common SuperSense issues quickly.

Quick Diagnostics

Run these checks first when troubleshooting:

System Status Check

Navigate to SuperSense → Settings → System Status to view:

• License status
• PHP version
• WordPress version
• Memory limits
• Cron status
• API connectivity

Debug Mode

Enable debug mode for detailed logging:

1. Go to Settings → Advanced
2. Enable Debug Mode
3. Set Log Level to "Debug"
4. Reproduce the issue
5. Check logs at Settings → Logs

Installation Issues

Plugin Won't Activate

Symptoms: White screen or error when activating

Causes & Solutions:

Check PHP version:

<?php echo phpversion(); ?>

License Activation Failed

Symptoms: "Invalid license" or "Activation failed" message

Solutions:

1. Verify license key
   • Check for typos
   • Copy/paste from email
   • Remove extra spaces
2. Check activation limit
   • Log into SuperSense account
   • Deactivate unused sites
   • Upgrade if needed
3. Network issues
   • Check internet connectivity
   • Verify firewall allows outbound HTTPS
   • Try again in few minutes
4. Server time
   • Ensure server time is correct
   • SSL certificate is valid

Database Tables Missing

Symptoms: Errors about missing tables

Solutions:

1. Deactivate and reactivate plugin
2. Run manual table creation:

wp sps database create

3. Check database user permissions

Generation Issues

Content Not Generating

Symptoms: Generation hangs or fails without output

Checklist:

Debug steps:

1. Enable debug mode
2. Try generating manually
3. Check error logs
4. Test with simple keyword

Poor Content Quality

Symptoms: Content is irrelevant, short, or poorly structured

Solutions:

Generation Timeout

Symptoms: "Request timeout" or generation never completes

Solutions:

1. Increase PHP limits:

// php.ini or wp-config.php
ini_set('max_execution_time', 300);
ini_set('memory_limit', '512M');

2. Check API settings:
   • Increase timeout in settings
   • Reduce images per post
   • Simplify templates
3. Server resources:
   • Monitor CPU/memory usage
   • Generate during low-traffic periods
   • Consider server upgrade

Auto-Posting Issues

Auto-Post Not Running

Symptoms: No posts generated on schedule

Diagnostic steps:

1. Check if enabled:
   • Global auto-post enabled?
   • Project auto-post enabled?
   • Project is active?
2. Check pending keywords:
   • Any pending keywords available?
   • Keywords not filtered?
3. Check cron:

   wp cron event list | grep sps
   

4. Manual test:

   wp sps autopost run --verbose
   

Common fixes:

Inconsistent Timing

Symptoms: Posts at unexpected times

Causes & Solutions:

1. WP-Cron limitation:
   • Requires page visits
   • Set up system cron instead
2. Randomization enabled:
   • Check random interval setting
   • Disable for precise timing
3. Timezone mismatch:
   • Verify WordPress timezone
   • Check server timezone

Queue Stuck

Symptoms: Items in queue never process

Solutions:

1. Clear queue and restart:

wp sps autopost clear
wp sps autopost run

2. Check for errors:

wp sps autopost log --limit=20

3. Reset auto-post system:
   • Disable and re-enable auto-post
   • Clear all queued items

Image Issues

Images Not Attaching

Symptoms: Posts created without images

Checklist:

Debug:

1. Check image source availability
2. Test manual image fetch
3. Verify upload directory permissions:

chmod 755 wp-content/uploads

Image Processing Errors

Symptoms: "Image processing failed" errors

Causes & Solutions:

Check GD:

<?php 
echo extension_loaded('gd') ? 'GD enabled' : 'GD missing';
?>

Poor Image Quality

Symptoms: Blurry or low-quality images

Solutions:

• Increase quality setting (85-95)
• Increase max dimensions
• Enable higher-quality sources
• Disable over-compression

Performance Issues

Slow Generation

Symptoms: Generation takes too long

Optimization steps:

1. Reduce complexity:
   • Fewer images per post
   • Simpler templates
   • Shorter content
2. Server resources:
   • Increase PHP memory
   • Extend execution time
   • Check CPU usage
3. Network:
   • Check API latency
   • Use faster DNS
   • Verify no firewall delays

High Memory Usage

Symptoms: Memory errors, server slowdown

Solutions:

1. Reduce batch size:

define('SPS_BATCH_SIZE', 5);

2. Process fewer images:
   • Reduce images per post
   • Lower image dimensions
3. Increase limits:

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

Database Growing Large

Symptoms: Slow queries, large database size

Maintenance:

# Clean old logs
wp sps cleanup logs --days=30

# Optimize tables
wp db optimize

# Check table sizes
wp db size --tables

Error Reference

Common Error Messages

Getting Support

If you can't resolve an issue:

1. Gather information:
   • SuperSense version
   • WordPress version
   • PHP version
   • Error messages
   • Debug logs
   • Steps to reproduce
2. Check documentation:
   • Search our docs
   • Review changelog
3. Contact support:
   • Email: support@supersense.pro
   • Include gathered information
   • Describe expected vs actual behavior