Developer Reference

add_filter('mamba_cache_ttl', function($ttl, $url) {
    if (strpos($url, '/shop/') !== false) {
        return 1800; // 30 minutes for shop pages
    }
    return $ttl;
}, 10, 2);

add_filter('mamba_default_ttl', function($ttl) {
    return 43200; // 12 hours
}, 10, 1);

add_filter('mamba_should_cache_page', function($should_cache) {
    if (is_user_logged_in() && current_user_can('edit_posts')) {
        return false; // Don't cache for editors
    }
    return $should_cache;
}, 10, 1);

add_filter('mamba_cache_control_header', function($header, $ttl) {
    return "public, max-age={$ttl}, stale-while-revalidate=60";
}, 10, 2);

add_filter('mamba_stale_while_revalidate', function($swr, $ttl) {
    return 3600; // 1 hour stale-while-revalidate
}, 10, 2);

add_filter('mamba_stale_if_error', function($sie, $ttl) {
    return 86400; // Serve stale for 24h on error
}, 10, 2);

add_filter('mamba_vary_cookies', function($cookies) {
    $cookies[] = 'my_custom_cookie';
    return $cookies;
}, 10, 1);

add_filter('mamba_vary_headers', function($headers) {
    $headers[] = 'X-Custom-Header';
    return $headers;
}, 10, 1);

add_filter('mamba_cache_key', function($key, $url) {
    if (wp_is_mobile()) {
        return $key . '_mobile';
    }
    return $key;
}, 10, 2);

add_filter('mamba_ignored_query_params', function($params) {
    $params[] = 'fbclid';
    $params[] = 'gclid';
    $params[] = 'utm_source';
    return $params;
}, 10, 1);

add_filter('mamba_purge_urls', function($urls, $post_id) {
    $urls[] = home_url('/custom-page/');
    return $urls;
}, 10, 2);

add_filter('mamba_purge_post_urls', function($urls, $post) {
    if ($post->post_type === 'product') {
        $urls[] = wc_get_page_permalink('shop');
    }
    return $urls;
}, 10, 2);

add_filter('mamba_cache_tags', function($tags, $url) {
    if (is_product()) {
        global $product;
        $tags[] = 'product_' . $product->get_id();
    }
    return $tags;
}, 10, 2);

add_filter('mamba_invalidation_post_types', function($post_types) {
    $post_types[] = 'my_custom_post_type';
    return $post_types;
}, 10, 1);

add_filter('mamba_store_api_cache_enabled', '__return_false');

add_filter('mamba_store_api_ttl', function($ttl, $route) {
    if (strpos($route, '/products') !== false) {
        return 3600; // 1 hour for products
    }
    return $ttl;
}, 10, 2);

add_filter('mamba_store_api_cacheable_routes', function($routes) {
    $routes[] = '/wc/store/v1/custom-endpoint';
    return $routes;
}, 10, 1);

add_filter('mamba_store_api_excluded_routes', function($routes) {
    $routes[] = '/wc/store/v1/checkout';
    return $routes;
}, 10, 1);

add_filter('mamba_store_api_vary_headers', function($headers) {
    $headers[] = 'X-Customer-Group';
    return $headers;
}, 10, 1);

add_filter('mamba_warmup_urls', function($urls) {
    $urls[] = home_url('/important-landing-page/');
    return $urls;
}, 10, 1);

add_filter('mamba_warmup_batch_size', function($size) {
    return 20; // Process 20 URLs per batch
}, 10, 1);

add_filter('mamba_warmup_concurrency', function($concurrency) {
    return 5; // 5 concurrent requests
}, 10, 1);

add_filter('mamba_warmup_delay', function($delay) {
    return 500; // 500ms between batches
}, 10, 1);

add_filter('mamba_warmup_timeout', function($timeout) {
    return 30; // 30 second timeout
}, 10, 1);

add_filter('mamba_warmup_post_types', function($post_types) {
    $post_types[] = 'portfolio';
    return $post_types;
}, 10, 1);

add_filter('mamba_cdn_enabled', function($enabled) {
    return !is_admin(); // Only enable CDN on frontend
}, 10, 1);

add_filter('mamba_cdn_url', function($cdn_url) {
    return 'https://cdn.example.com';
}, 10, 1);

add_filter('mamba_cdn_cache_tags', function($tags) {
    $tags[] = 'custom_tag_' . get_current_blog_id();
    return $tags;
}, 10, 1);

add_filter('mamba_cdn_excluded_extensions', function($extensions) {
    $extensions[] = 'pdf';
    return $extensions;
}, 10, 1);

add_filter('mamba_lcp_enabled', '__return_true');

add_filter('mamba_lcp_image', function($image_url, $url) {
    if (is_front_page()) {
        return get_template_directory_uri() . '/images/hero.webp';
    }
    return $image_url;
}, 10, 2);

add_filter('mamba_lazy_load_enabled', function($enabled) {
    return !is_product(); // Disable on product pages
}, 10, 1);

add_filter('mamba_lazy_load_threshold', function($threshold) {
    return '300px';
}, 10, 1);

add_filter('mamba_dns_prefetch_urls', function($urls) {
    $urls[] = 'https://api.example.com';
    return $urls;
}, 10, 1);

add_filter('mamba_preconnect_urls', function($urls) {
    $urls[] = ['url' => 'https://fonts.googleapis.com', 'crossorigin' => true];
    return $urls;
}, 10, 1);

add_filter('mamba_db_cleanup_enabled', '__return_false');

add_filter('mamba_db_cleanup_tasks', function($tasks) {
    unset($tasks['revisions']); // Keep revisions
    return $tasks;
}, 10, 1);

add_filter('mamba_db_transient_expiry', function($days) {
    return 7; // Clean transients older than 7 days
}, 10, 1);

add_filter('mamba_admin_capability', function($capability) {
    return 'manage_woocommerce'; // Allow shop managers
}, 10, 1);

add_filter('mamba_purge_capability', function($capability) {
    return 'edit_posts'; // Allow editors to purge
}, 10, 1);

add_filter('mamba_admin_bar_enabled', '__return_false');

add_action('mamba_purge_tags', function($tags) {
    error_log('Mamba purged tags: ' . implode(', ', $tags));
}, 10, 1);

add_action('mamba_purge_urls', function($urls, $headerCombos = []) {
    foreach ($urls as $url) {
        error_log('Mamba purged URL: ' . $url);
    }
}, 10, 2);

add_action('mamba_cache_purged', function() {
    error_log('Mamba cache was fully purged');
});

add_action('mamba_purge_all', function() {
    // Notify external systems of full cache clear
});

add_action('mamba_store_api_cleared', function() {
    error_log('Mamba Store API cache was cleared');
});

add_action('mamba_db_task_completed', function($taskId, $affected) {
    error_log("Mamba DB task {$taskId}: {$affected} rows affected");
}, 10, 2);

add_action('mamba_cache_error', function($message, $context = []) {
    error_log('Mamba error: ' . $message);
}, 10, 2);

# Purge all cache
wp mamba purge

# Purge only Store API cache
wp mamba purge --store-api

# Purge only page cache
wp mamba purge --pages

wp mamba purge url https://example.com/shop/

# Warm all URLs
wp mamba warmup

# Warm only products with limit
wp mamba warmup --type=products --limit=100

# Warm with higher concurrency
wp mamba warmup --concurrency=5

# Display status table
wp mamba status

# Get JSON output
wp mamba status --format=json

# Run all optimization tasks
wp mamba db optimize

# Preview transient cleanup
wp mamba db optimize --task=transients --dry-run

# Clean only revisions
wp mamba db optimize --task=revisions

# List all config
wp mamba config list

# Get specific value
wp mamba config get default_ttl

# Set a value
wp mamba config set default_ttl 43200

{
  "enabled": true,
  "page_cache": {
    "enabled": true,
    "entries": 1250,
    "size": "45.2 MB"
  },
  "store_api_cache": {
    "enabled": true,
    "entries": 340
  },
  "last_purge": "2026-01-23T08:15:00Z"
}

curl -X POST \
  -H "X-WP-Nonce: {nonce}" \
  https://example.com/wp-json/mamba/v1/purge \
  -d '{"type": "all"}'

{
  "success": true,
  "message": "Cache purged successfully",
  "purged_at": "2026-01-23T10:30:00Z"
}

curl -X POST \
  -H "X-WP-Nonce: {nonce}" \
  https://example.com/wp-json/mamba/v1/purge/url \
  -d '{"url": "https://example.com/product/sample/"}'

curl -X POST \
  -H "X-WP-Nonce: {nonce}" \
  https://example.com/wp-json/mamba/v1/warmup \
  -d '{"limit": 100, "type": "products"}'

{
  "success": true,
  "job_id": "warmup_abc123",
  "urls_queued": 100,
  "status": "processing"
}

{
  "job_id": "warmup_abc123",
  "status": "completed",
  "total_urls": 100,
  "processed": 100,
  "successful": 98,
  "failed": 2,
  "duration": "45s"
}

{
  "page_cache_enabled": true,
  "store_api_cache_enabled": true,
  "default_ttl": 86400,
  "store_api_ttl": 300,
  "cdn_enabled": false,
  "warmup_enabled": true
}

curl -X POST \
  -H "X-WP-Nonce: {nonce}" \
  https://example.com/wp-json/mamba/v1/settings \
  -d '{"default_ttl": 43200}'

curl -X POST \
  -H "X-WP-Nonce: {nonce}" \
  https://example.com/wp-json/mamba/v1/db/optimize \
  -d '{"tasks": ["transients", "orphans"]}'

{
  "success": true,
  "results": {
    "transients": {"cleaned": 145},
    "orphans": {"cleaned": 23}
  }
}