Cache, Scheduler & Cron Actions

WP Social Ninja caches remote responses and refreshes them on a WP-Cron schedule. These hooks let you react to cache purges and the per-platform refresh jobs. See Caching for the bigger picture.

wpsocialreviews/purge_cache

wpsocialreviews/purge_cache — The feed/review cache was cleared

When it runs: Fires when WP Social Ninja clears its cache (manually or programmatically) in Feeds/CacheHandler.php. The handler also integrates with common page caches (LiteSpeed, Nginx Helper, Breeze).

Parameters: none

Source: app/Services/Platforms/Feeds/CacheHandler.php

Usage:

add_action('wpsocialreviews/purge_cache', function () {
    // also bust your own CDN/page cache
    my_cdn_purge_tag('wpsn');
});

Per-platform cron jobs

wpsr_{platform}_feed_update · wpsr_{platform}_reviews_update · wpsr_{platform}_send_email_report

When they run: On the plugin's WP-Cron schedule, when a platform's cache expires. Feed and review platforms each get a refresh action; some also send scheduled email reports.

Hook	Purpose
wpsr_{platform}_feed_update	Refresh a feed platform's data
wpsr_{platform}_reviews_update	Refresh a review platform's data
wpsr_{platform}_send_email_report	Send a scheduled email report

Source: app/Hooks/Handlers/SchedulerHandler.php

Usage:

// Force a Google reviews refresh (e.g. from WP-CLI or a custom trigger)
do_action('wpsr_google_reviews_update');

Token & AI-summary maintenance jobs

Hook	Args	Purpose
wpsr_instagram_access_token_refresh_weekly	—	Refresh the Instagram long-lived token
wpsocialreviews/check_instagram_access_token_validity_weekly	$account	Validate an Instagram token
wpsocialreviews/regenerate_ai_summary_cache	—	Rebuild AI review summaries (Pro)

Source: app/Hooks/Handlers/SchedulerHandler.php

Per-platform cache clearing

wpsocialreviews/clear_cache_{platform} — Clear one platform's cache

When it runs: when the admin clears a single platform's cache.

Parameters:

• $cacheType (string): which cache to clear.

Source: app/Http/Controllers/SettingsController.php

Usage:

add_action('wpsocialreviews/clear_cache_myplatform', function ($cacheType) {
    // remove your platform's cached rows
});