Hooks reference

Every filter and action the plugin exposes. Names are stable — they're a public contract.

Templates

thewpfeeds_template_path (filter)

The theme subdirectory searched for overrides. Default thewpfeeds.

add_filter( 'thewpfeeds_template_path', fn () => 'feeds' );
// overrides now live in {theme}/feeds/

thewpfeeds_template (filter)

The final resolved absolute template path. Receives ( string $located, string $name ) — return a different path to hijack resolution entirely (e.g. route templates from a plugin instead of the theme).

Providers

thewpfeeds_register_providers (action)

Register custom providers. Receives the ProviderRegistry; see Providers.

thewpfeeds_linkedin_version (filter)

The LinkedIn-Version API header. LinkedIn sunsets API versions on a schedule; the plugin pins a known-good version and updates it in releases — this filter is the escape hatch if you need to move faster than a plugin update.

thewpfeeds_enable_proxy (filter)

Reserved for the upcoming managed connection service (connect LinkedIn without creating a developer app). Default false; flipping it today selects a client that isn't live yet — leave it alone unless told otherwise.

Fetching

thewpfeeds_feed_refreshed (action)

Fires after a feed's cache is refreshed. Receives ( Feed $feed, ItemCollection $items ). Use it to purge page caches, trigger webhooks, mirror content:

add_action( 'thewpfeeds_feed_refreshed', function ( $feed, $items ) {
    if ( function_exists( 'wp_cache_clear_cache' ) ) {
        wp_cache_clear_cache(); // or a targeted purge of pages embedding $feed->slug
    }
}, 10, 2 );

Licensing

thewpfeeds_license (filter)

The active license implementation. Receives the default (the remote-validating license) — return any object implementing TheWPFeeds\License\LicenseInterface (isPro(), maxFeeds(), canCreateFeed()). This is the seam agencies can use to pre-license client installs from an mu-plugin.

thewpfeeds_license_server (filter)

Base URL of the license server. Exists for local development against a staging server; production sites shouldn't touch it.


Something you'd hook that isn't listed? Say so — adding a filter is cheap, guessing wrong about where you need one isn't.