Ticket #7335: 7335-anonymous-actions.diff

src/bp-core/bp-core-actions.php

@@ -30 +30 @@
  *
  *           v--WordPress Actions       v--BuddyPress Sub-actions
  */
-add_action( 'plugins_loaded',          'bp_loaded',                 10    );
-add_action( 'init',                    'bp_init',                   10    );
-add_action( 'rest_api_init',           'bp_rest_api_init',          20    ); // After WP core.
-add_action( 'customize_register',      'bp_customize_register',     20    ); // After WP core.
+add_action( 'plugins_loaded',          function() {
+
+        /**
+         * Fires on the 'plugins_loaded' hook, which fires after BP's core plugin files have been loaded.
+         *
+         * @since 1.2.5
+         */
+        do_action( 'bp_loaded' );
+}, 10 );
+add_action( 'init',                    function() {
+
+        /**
+         * Fires on the 'init' hook, BuddyPress' main initialization hook.
+         *
+         * @since 1.2.0
+         */
+        do_action( 'bp_init' );
+}, 10 );
+add_action( 'rest_api_init',           function() {
+
+        /**
+         * Fires the 'bp_rest_api_init' function, where BuddyPress registers REST API endpoints.
+         *
+         * @since 2.6.0
+         */
+        do_action( 'bp_rest_api_init' );
+}, 20 ); // After WP core.
+add_action( 'customize_register',      function( WP_Customize_Manager $customizer ) {
+
+        /**
+         * Fires once the Customizer has loaded, allow scripts and styles to be initialized.
+         *
+         * @since 2.5.0
+         *
+         * @param WP_Customize_Manager $customizer Customizer instance.
+         */
+        do_action( 'bp_customize_register', $customizer );
+}, 20 ); // After WP core.
 add_action( 'parse_query',             'bp_parse_query',            2     ); // Early for overrides.
 add_action( 'wp',                      'bp_ready',                  10    );
-add_action( 'set_current_user',        'bp_setup_current_user',     10    );
+add_action( 'set_current_user',        function() {
+
+        /**
+         * Fires to set up the current user setup process.
+         *
+         * @since 1.7.0
+         */
+        do_action( 'bp_setup_current_user' );
+}, 10 );
 add_action( 'setup_theme',             'bp_setup_theme',            10    );
 add_action( 'after_setup_theme',       'bp_after_setup_theme',      100   ); // After WP themes.
 add_action( 'wp_enqueue_scripts',      'bp_enqueue_scripts',        10    );
 add_action( 'enqueue_embed_scripts',   'bp_enqueue_embed_scripts',  10    );
-add_action( 'admin_bar_menu',          'bp_setup_admin_bar',        20    ); // After WP core.
+add_action( 'admin_bar_menu',          function() {
+        if ( bp_use_wp_admin_bar() ) {
+
+                /**
+                 * Fires on the 'admin_bar_menu' hook, where plugins should add items to the WP admin bar.
+                 * This hook will only fire if bp_use_wp_admin_bar() returns true.
+                 * @since 1.5.0
+                 */
+                do_action( 'bp_setup_admin_bar' );
+        }
+}, 20 ); // After WP core.
 add_action( 'template_redirect',       'bp_template_redirect',      10    );
 add_action( 'widgets_init',            'bp_widgets_init',           10    );
 add_action( 'generate_rewrite_rules',  'bp_generate_rewrite_rules', 10    );
@@ -53 +105 @@
  * The load order helps to execute code at the correct time.
  *                                                      v---Load order
  */
-add_action( 'bp_loaded', 'bp_setup_components',         2  );
-add_action( 'bp_loaded', 'bp_include',                  4  );
-add_action( 'bp_loaded', 'bp_setup_cache_groups',       5  );
-add_action( 'bp_loaded', 'bp_setup_widgets',            6  );
+add_action( 'bp_loaded', function() {
+
+        /**
+         * Fires on the 'bp_loaded' action, where plugins should initialize components.
+         *
+         * @since 1.6.0
+         */
+        do_action( 'bp_setup_components' );
+}, 2 );
+
+add_action( 'bp_loaded', function() {
+
+        /**
+         * Fires on the 'bp_loaded' action, where plugins should include files.
+         *
+         * @since 1.2.5
+         */
+         do_action( 'bp_include' );
+}, 4 );
+add_action( 'bp_loaded', function() {
+
+        /**
+         * Fires on the 'bp_loaded' hook, where cache groups are registered.
+         *
+         * @since 2.2.0
+         */
+        do_action( 'bp_setup_cache_groups' );
+}, 5 );
+add_action( 'bp_loaded', function() {
+
+        /**
+         * Fires on the 'bp_loaded' hook, where plugins should register widgets.
+         *
+         * @since 1.2.0
+         */
+        do_action( 'bp_register_widgets' );
+}, 6 );
 add_action( 'bp_loaded', 'bp_register_theme_packages',  12 );
 add_action( 'bp_loaded', 'bp_register_theme_directory', 14 );
 
@@ -67 +152 @@
  * The load order helps to execute code at the correct time.
  *                                                   v---Load order
  */
-add_action( 'bp_init', 'bp_register_post_types',     2  );
-add_action( 'bp_init', 'bp_register_taxonomies',     2  );
+add_action( 'bp_init', function() {
+
+        /**
+         * Fires on the 'bp_init' hook, where plugins should register post types.
+         *
+         * @since 2.5.0
+         */
+        do_action( 'bp_register_post_types' );
+}, 2 );
+
+add_action( 'bp_init', function() {
+
+        /**
+         * Fires on the 'bp_init' hook, where plugins should register taxonomies.
+         *
+         * @since 2.2.0
+         */
+        do_action( 'bp_register_taxonomies' );
+}, 2 );
+
 add_action( 'bp_init', 'bp_core_set_uri_globals',    2  );
-add_action( 'bp_init', 'bp_setup_globals',           4  );
-add_action( 'bp_init', 'bp_setup_canonical_stack',   5  );
-add_action( 'bp_init', 'bp_setup_nav',               6  );
-add_action( 'bp_init', 'bp_setup_title',             8  );
+add_action( 'bp_init', function() {
+
+        /**
+         * Fires on the 'bp_init' hook, where plugins should initialize global settings.
+         *
+         * @since 1.2.0
+         */
+        do_action( 'bp_setup_globals' );
+}, 4 );
+add_action( 'bp_init', function() {
+
+        /**
+         * Fires on the 'bp_init' hook, where plugins should set up their canonical URL.
+         *
+         * @since 2.1.0
+         */
+        do_action( 'bp_setup_canonical_stack' );
+}, 5 );
+add_action( 'bp_init', function() {
+
+        /**
+         * Fires on the 'bp_init' hook, where plugins should register their navigation items.
+         *
+         * @since 1.2.0
+         */
+        do_action( 'bp_setup_nav' );
+}, 6 );
+add_action( 'bp_init', function() {
+
+        /**
+         * Fires on the 'bp_init' hook, where plugins should modify the page title.
+         *
+         * @since 1.5.0
+         */
+        do_action( 'bp_setup_title' );
+}, 8 );
 add_action( 'bp_init', 'bp_core_load_admin_bar_css', 12 );
 add_action( 'bp_init', 'bp_add_rewrite_tags',        20 );
 add_action( 'bp_init', 'bp_add_rewrite_rules',       30 );
@@ -82 +217 @@
 /**
  * The bp_register_taxonomies hook - Attached to 'bp_init' @ priority 2 above.
  */
-add_action( 'bp_register_taxonomies', 'bp_register_member_types' );
+add_action( 'bp_register_taxonomies', function() {
+
+        /**
+         * Fires on the bp_register_taxonomies hook, so plugins can register member types.
+         *
+         * @since 2.3.0
+         */
+        do_action( 'bp_register_member_types' );
+} );
 
 /**
  * The bp_template_redirect hook - Attached to 'template_redirect' above.