Beast Mode

Beast Mode is SpeedMate's intelligent automatic caching system that learns from traffic patterns to cache high-traffic pages automatically.

What is Beast Mode?

Traditional caching requires manual configuration of which pages to cache. Beast Mode eliminates this by:

• Analyzing Traffic: Monitors page views in real-time
• Learning Patterns: Identifies high-traffic pages automatically
• Auto-Caching: Caches popular pages without manual intervention
• Adaptive: Adjusts cache strategy based on changing traffic

How It Works

User Request → Traffic Analysis → Score Calculation
                                        ↓
                                  Score > Threshold?
                                        ↓
                                  Auto-Cache Page
                                        ↓
                                  Serve from Cache

Scoring Algorithm

Beast Mode scores pages based on:

1. Request Count: Number of requests in time window
2. Request Rate: Requests per minute
3. Response Time: Average page generation time
4. Resource Usage: Memory and database query count

Formula:

score = (requests * 10) + (rate * 5) + (response_time / 100)

Threshold: score >= 50 triggers auto-caching

Configuration

Enable Beast Mode

update_option('speedmate_settings', [
    'mode' => 'beast',
    'beast_threshold' => 50,        // Minimum score
    'beast_time_window' => 3600,    // 1 hour window
    'beast_whitelist' => [],        // Always cache
    'beast_blacklist' => [],        // Never cache
]);

Via WordPress Admin

1. Navigate to Settings > SpeedMate
2. Set Mode to Beast
3. Configure threshold and whitelist
4. Save changes

Whitelist Rules

Force-cache specific patterns:

update_option('speedmate_settings', [
    'beast_whitelist' => [
        '/blog/*',           // All blog posts
        '/category/*',       // All categories
        '/tag/*',           // All tags
        '/shop/*',          // All shop pages
        '/',                // Homepage
    ]
]);

Programmatic Whitelist

add_filter('speedmate_beast_whitelist', function($whitelist) {
    // Add custom post type
    $whitelist[] = '/products/*';
    
    // Add specific pages
    $whitelist[] = '/about';
    $whitelist[] = '/contact';
    
    return $whitelist;
});

Blacklist Rules

Exclude specific patterns from Beast Mode:

update_option('speedmate_settings', [
    'beast_blacklist' => [
        '/checkout/*',       // E-commerce checkout
        '/cart/*',          // Shopping cart
        '/my-account/*',    // User account pages
        '/admin/*',         // Admin pages
    ]
]);

Default Exclusions

Beast Mode automatically excludes:

• Admin pages (/wp-admin/*)
• User account pages
• Checkout/cart pages (WooCommerce)
• Search results
• Preview pages
• Password-protected pages

Traffic Analysis

Real-Time Monitoring

# View current traffic stats
wp speedmate stats

# Monitor Beast Mode decisions
tail -f wp-content/speedmate.log | grep beast

Traffic Data Structure

{
  "url": "/blog/post-name",
  "hits": 142,
  "rate": 2.3,
  "avg_response": 450,
  "score": 87,
  "cached": true,
  "cache_time": "2026-01-22T10:30:00Z"
}

Performance Metrics

Before Beast Mode

High Traffic Page:
- Requests: 1000/hour
- Response Time: 500ms
- Database Queries: 80/request
- Memory Usage: 80MB
- Total Time: 500 seconds

After Beast Mode

High Traffic Page:
- Requests: 1000/hour  
- Response Time: 3ms (cached)
- Database Queries: 0/request
- Memory Usage: 5MB
- Total Time: 3 seconds

Performance Gain: 99.4% faster

Advanced Features

Adaptive Caching

Beast Mode adapts cache strategy based on:

1. Time of Day: Higher threshold during low traffic
2. Day of Week: Lower threshold on weekends
3. Seasonal Traffic: Adjusts for traffic spikes
4. Resource Availability: Reduces caching under load

add_filter('speedmate_beast_threshold', function($threshold) {
    $hour = (int) date('H');
    
    // Lower threshold during business hours
    if ($hour >= 9 && $hour <= 17) {
        return $threshold * 0.8;
    }
    
    // Higher threshold at night
    return $threshold * 1.2;
});

Cache Warming Integration

Beast Mode automatically triggers cache warming for:

• Related posts
• Category archives
• Author pages
• Next/previous pagination

Dynamic TTL

Cache lifetime adjusts based on update frequency:

add_filter('speedmate_beast_ttl', function($ttl, $url) {
    // Longer TTL for static pages
    if (preg_match('/^\/(about|contact)/', $url)) {
        return 86400; // 24 hours
    }
    
    // Shorter TTL for blog posts
    if (preg_match('/^\/blog\//', $url)) {
        return 3600; // 1 hour
    }
    
    return $ttl;
}, 10, 2);

Monitoring

Dashboard Widget

View Beast Mode stats in WordPress admin:

Beast Mode Status
━━━━━━━━━━━━━━━━━━━━
Status:        Active
Auto-Cached:   142 pages
Traffic Hits:  1,245
Avg Score:     67
Cache Hit Rate: 94.2%

WP-CLI Monitoring

# Beast Mode stats
wp speedmate info | grep -A5 "Beast Mode"

# Top scoring pages
wp eval "print_r(\SpeedMate\Utils\Stats::get_top_scored());"

# Recent auto-cached pages
wp eval "print_r(\SpeedMate\Utils\Stats::get_recent_cached());"

Logging

// Enable Beast Mode logging
update_option('speedmate_settings', [
    'logging_enabled' => true,
    'log_level' => 'info'
]);

Log entries:

{
  "level": "info",
  "event": "beast_auto_cache",
  "url": "/blog/popular-post",
  "score": 87,
  "threshold": 50,
  "timestamp": "2026-01-22T10:30:00Z"
}

Best Practices

1. Start with Conservative Threshold: Use default 50, adjust based on traffic
2. Monitor Regularly: Check cache hit rates and scores
3. Use Whitelist for Critical Pages: Force-cache homepage, landing pages
4. Blacklist User-Specific Content: Exclude checkout, account pages
5. Enable Cache Warming: Pre-cache likely navigation paths
6. Review Logs Periodically: Identify patterns and adjust rules

Troubleshooting

Pages Not Auto-Caching

1. Check traffic meets threshold
2. Verify page not in blacklist
3. Review exclusion rules
4. Check cache directory permissions

Too Many Pages Cached

1. Increase threshold
2. Add patterns to blacklist
3. Reduce time window
4. Enable stricter scoring

Cache Thrashing

1. Increase TTL
2. Reduce auto-invalidation triggers
3. Use cache warming
4. Review whitelist rules

Next Steps

• Configure Whitelist Rules
• Traffic Warmer Integration
• Monitor with Dashboard Widget