Lifecycle & Boot Actions

These hooks fire once, early, with the WPFluent Application container. This is where Pro, Custom Feed for TikTok, and your own add-ons register everything else.

wp_social_reviews_loaded_v2

wp_social_reviews_loaded_v2 — The primary extension entry point

When it runs: Fires on plugins_loaded (after a PHP-version check) once the core Application has been created. Both Pro and Custom Feed for TikTok hook here to bootstrap themselves. A legacy wp_social_reviews_loaded fires alongside it — prefer the _v2 variant for new code.

Parameters:

• $app (WPSocialReviews\Framework\Foundation\Application): the service container.

Source: boot/app.php

Usage:

add_action('wp_social_reviews_loaded_v2', function ($app) {
    // Container and platforms are ready — register your hooks, routes, services here.
    add_action('wpsocialreviews/custom_review_created', 'my_addon_on_new_review');
});

wp_social_reviews_loaded

wp_social_reviews_loaded — Legacy boot action

When it runs: Fires immediately before wp_social_reviews_loaded_v2, with the same argument. Retained for backward compatibility; new code should use the _v2 variant.

Parameters:

• $app (Application): the service container.

Source: boot/app.php

wpsocialreviews/loading_app

wpsocialreviews/loading_app — The admin menu/app is loading

When it runs: Fires while the admin menu and app are being registered (AdminMenuHandler). Use it to hook admin-side registration that must run during menu setup.

Parameters: none

Source: app/Hooks/Handlers/AdminMenuHandler.php

Usage:

add_action('wpsocialreviews/loading_app', function () {
    // register an admin sub-page, enqueue admin assets, etc.
});

wpsocialreviews/booting_admin_app

wpsocialreviews/booting_admin_app — The admin Vue SPA is booting

When it runs: Fires while the admin single-page app is being prepared. Pair it with the wpsocialreviews/admin_app_vars filter to inject data into the Vue SPA.

Parameters: none

Source: app/Hooks/Handlers/AdminMenuHandler.php

Usage:

add_action('wpsocialreviews/booting_admin_app', function () {
    // enqueue an admin-only script for a custom SPA extension
});

Add-on boot actions

wp_social_ninja_pro_loaded / custom_feed_for_tiktok_loaded — Add-on containers ready

When they run: After Pro / TikTok instantiate their own Application (from within wp_social_reviews_loaded_v2). Hook these to extend a specific add-on once it is present.

Parameters:

• $app (the add-on's Application): the add-on container.

Source: Pro wp-social-ninja-pro.php; TikTok custom-feed-for-tiktok.php

Usage:

add_action('wp_social_ninja_pro_loaded', function ($app) {
    // safe to reference Pro services here — Pro is confirmed active
});

See Core ↔ Pro Coupling for the full boot sequence.