diff --git src/bp-core/bp-core-dependency.php src/bp-core/bp-core-dependency.php index 6120ab0..591de96 100644 --- src/bp-core/bp-core-dependency.php +++ src/bp-core/bp-core-dependency.php @@ -13,8 +13,6 @@ * The following functions are wrappers for hooks, allowing them to be * manually called and/or piggy-backed on top of other hooks if needed. * - * @todo use anonymous functions when PHP minimum requirement allows (5.3) - * * @package BuddyPress * @subpackage Core * @since 1.7.0 @@ -23,190 +21,152 @@ /** * Fire the 'bp_include' action, where plugins should include files. * + * @deprecated No longer used in core. + * * @since 1.2.5 */ function bp_include() { - /** - * Fires inside the 'bp_include' function, where plugins should include files. - * - * @since 1.2.5 - */ - do_action( 'bp_include' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_setup_components' action, where plugins should initialize components. * + * @deprecated No longer used in core. + * * @since 1.6.0 */ function bp_setup_components() { - /** - * Fires inside the 'bp_setup_components' function, where plugins should initialize components. - * - * @since 1.6.0 - */ - do_action( 'bp_setup_components' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_setup_canonical_stack' action, where plugins should set up their canonical URL. * + * @deprecated No longer used in core. + * * @since 2.1.0 */ function bp_setup_canonical_stack() { - /** - * Fires inside the 'bp_setup_canonical_stack' function, where plugins should set up their canonical URL. - * - * @since 2.1.0 - */ - do_action( 'bp_setup_canonical_stack' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_register_taxonomies' action, where plugins should register taxonomies. * + * @deprecated No longer used in core. + * * @since 2.2.0 */ function bp_register_taxonomies() { - /** - * Fires inside the 'bp_register_taxonomies' function, where plugins should register taxonomies. - * - * @since 2.2.0 - */ - do_action( 'bp_register_taxonomies' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_register_post_types' action, where plugins should register post types. * + * @deprecated No longer used in core. + * * @since 2.5.0 */ function bp_register_post_types() { - /** - * Fires inside the 'bp_register_post_types' function, where plugins should register post types. - * - * @since 2.5.0 - */ - do_action( 'bp_register_post_types' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_setup_globals' action, where plugins should initialize global settings. * + * @deprecated No longer used in core. + * * @since 1.2.0 */ function bp_setup_globals() { - /** - * Fires inside the 'bp_setup_globals' function, where plugins should initialize global settings. - * - * @since 1.2.0 - */ - do_action( 'bp_setup_globals' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_setup_nav' action, where plugins should register their navigation items. * + * @deprecated No longer used in core. + * * @since 1.2.0 */ function bp_setup_nav() { - /** - * Fires inside the 'bp_setup_nav' function, where plugins should register their navigation items. - * - * @since 1.2.0 - */ - do_action( 'bp_setup_nav' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_setup_admin_bar' action, where plugins should add items to the WP admin bar. * + * @deprecated No longer used in core. + * * @since 1.5.0 */ function bp_setup_admin_bar() { - if ( bp_use_wp_admin_bar() ) { - /** - * Fires inside the 'bp_setup_admin_bar' function, 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' ); - } + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_setup_title' action, where plugins should modify the page title. * + * @deprecated No longer used in core. + * * @since 1.5.0 */ function bp_setup_title() { - /** - * Fires inside the 'bp_setup_title' function, where plugins should modify the page title. - * - * @since 1.5.0 - */ - do_action( 'bp_setup_title' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_register_widgets' action, where plugins should register widgets. * + * @deprecated No longer used in core. + * * @since 1.2.0 */ function bp_setup_widgets() { - /** - * Fires inside the 'bp_register_widgets' function, where plugins should register widgets. - * - * @since 1.2.0 - */ - do_action( 'bp_register_widgets' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_register_member_types' action, where plugins should register member types. * + * @deprecated No longer used in core. + * * @since 2.3.0 */ function bp_register_member_types() { - /** - * Fires inside bp_register_member_types(), so plugins can register member types. - * - * @since 2.3.0 - */ - do_action( 'bp_register_member_types' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_setup_cache_groups' action, where cache groups are registered. * + * @deprecated No longer used in core. + * * @since 2.2.0 */ function bp_setup_cache_groups() { - /** - * Fires inside the 'bp_setup_cache_groups' function, where cache groups are registered. - * - * @since 2.2.0 - */ - do_action( 'bp_setup_cache_groups' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Set up the currently logged-in user. * + * @deprecated No longer used in core. + * * @since 1.7.0 * * @link https://buddypress.trac.wordpress.org/ticket/6046 @@ -214,62 +174,46 @@ function bp_setup_cache_groups() { */ function bp_setup_current_user() { - /** - * Fires to set up the current user setup process. - * - * @since 1.7.0 - */ - do_action( 'bp_setup_current_user' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_init' action, BuddyPress's main initialization hook. * + * @deprecated No longer used in core. + * * @since 1.2.5 */ function bp_init() { - /** - * Fires inside the 'bp_init' function, BuddyPress' main initialization hook. - * - * @since 1.2.0 - */ - do_action( 'bp_init' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_rest_api_init' action, where BuddyPress registers REST API endpoints. * + * @deprecated No longer used in core. + * * @since 2.6.0 */ function bp_rest_api_init() { - /** - * Fires the 'bp_rest_api_init' function, where BuddyPress registers REST API endpoints. - * - * @since 2.6.0 - */ - do_action( 'bp_rest_api_init' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_customize_register' action when the Customizer has loaded, * allowing scripts and styles to be initialized. * + * @deprecated No longer used in core. + * * @since 2.5.0 * * @param WP_Customize_Manager $customizer Customizer instance. */ function bp_customize_register( 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 ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** @@ -277,16 +221,13 @@ function bp_customize_register( WP_Customize_Manager $customizer ) { * * Attached to 'plugins_loaded'. * + * @deprecated No longer used in core. + * * @since 1.2.0 */ function bp_loaded() { - /** - * Fires inside the 'bp_loaded' function, which fires after BP's core plugin files have been loaded. - * - * @since 1.2.5 - */ - do_action( 'bp_loaded' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** @@ -294,16 +235,13 @@ function bp_loaded() { * * Attached to 'wp'. * + * @deprecated No longer used in core. + * * @since 1.6.0 */ function bp_ready() { - /** - * Fires inside the 'bp_ready' function, which runs after BP is set up and the page is about to render. - * - * @since 1.6.0 - */ - do_action( 'bp_ready' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** @@ -312,16 +250,13 @@ function bp_ready() { * Attach potential template actions, such as catching form requests or routing * custom URLs. * + * @deprecated No longer used in core. + * * @since 1.5.0 */ function bp_actions() { - /** - * Fires inside the 'bp_actions' function, which runs just before rendering. - * - * @since 1.5.0 - */ - do_action( 'bp_actions' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** @@ -330,18 +265,13 @@ function bp_actions() { * Runs just after 'bp_actions'. Use this hook to attach your template * loaders. * + * @deprecated No longer used in core. + * * @since 1.5.0 */ function bp_screens() { - /** - * Fires inside the 'bp_screens' function, which runs just before rendering. - * - * Runs just after 'bp_actions'. Use this hook to attach your template loaders. - * - * @since 1.5.0 - */ - do_action( 'bp_screens' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** @@ -349,18 +279,13 @@ function bp_screens() { * * Hooked to 'widgets_init'. * + * @deprecated No longer used in core. + * * @since 1.6.0 */ function bp_widgets_init() { - /** - * Fires inside the 'bp_widgets_init' function, which runs after widgets have been set up. - * - * Hooked to 'widgets_init'. - * - * @since 1.6.0 - */ - do_action( 'bp_widgets_init' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** @@ -368,16 +293,13 @@ function bp_widgets_init() { * * Hooked to 'wp_head'. * + * @deprecated No longer used in core. + * * @since 1.6.0 */ function bp_head() { - /** - * Fires inside the 'bp_head' function, which runs on 'wp_head'. - * - * @since 1.6.0 - */ - do_action( 'bp_head' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** Theme Permissions *********************************************************/ @@ -389,16 +311,13 @@ function bp_head() { * template. The main purpose of this hook in BuddyPress is to redirect users * who do not have the proper permission to access certain content. * + * @deprecated No longer used in core. + * * @since 1.6.0 */ function bp_template_redirect() { - /** - * Fires inside the 'bp_template_redirect' function. - * - * @since 1.6.0 - */ - do_action( 'bp_template_redirect' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** Theme Helpers *************************************************************/ @@ -408,18 +327,13 @@ function bp_template_redirect() { * * The main action used registering theme directories. * + * @deprecated No longer used in core. + * * @since 1.5.0 */ function bp_register_theme_directory() { - /** - * Fires inside the 'bp_register_theme_directory' function. - * - * The main action used registering theme directories. - * - * @since 1.7.0 - */ - do_action( 'bp_register_theme_directory' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** @@ -427,94 +341,73 @@ function bp_register_theme_directory() { * * The main action used registering theme packages. * + * @deprecated No longer used in core. + * * @since 1.7.0 */ function bp_register_theme_packages() { - /** - * Fires inside the 'bp_register_theme_packages' function. - * - * @since 1.7.0 - */ - do_action( 'bp_register_theme_packages' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_enqueue_scripts' action, where BP enqueues its CSS and JS. * + * @deprecated No longer used in core. + * * @since 1.6.0 */ function bp_enqueue_scripts() { - /** - * Fires inside the 'bp_enqueue_scripts' function, where BP enqueues its CSS and JS. - * - * @since 1.6.0 - */ - do_action( 'bp_enqueue_scripts' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fires the 'bp_enqueue_embed_scripts' action in the for BP oEmbeds. * + * @deprecated No longer used in core. + * * @since 2.6.0 */ function bp_enqueue_embed_scripts() { - if ( ! is_buddypress() ) { - return; - } - /** - * Enqueue CSS and JS files for BuddyPress embeds. - * - * @since 2.6.0 - */ - do_action( 'bp_enqueue_embed_scripts' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_add_rewrite_tag' action, where BP adds its custom rewrite tags. * + * @deprecated No longer used in core. + * * @since 1.8.0 */ function bp_add_rewrite_tags() { - /** - * Fires inside the 'bp_add_rewrite_tags' function, where BP adds its custom rewrite tags. - * - * @since 1.8.0 - */ - do_action( 'bp_add_rewrite_tags' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_add_rewrite_rules' action, where BP adds its custom rewrite rules. * + * @deprecated No longer used in core. + * * @since 1.9.0 */ function bp_add_rewrite_rules() { - /** - * Fires inside the 'bp_add_rewrite_rules' function, where BP adds its custom rewrite rules. - * - * @since 1.9.0 - */ - do_action( 'bp_add_rewrite_rules' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * Fire the 'bp_add_permastructs' action, where BP adds its BP-specific permalink structure. * + * @deprecated No longer used in core. + * * @since 1.9.0 */ function bp_add_permastructs() { - /** - * Fires inside the 'bp_add_permastructs' function, where BP adds its BP-specific permalink structure. - * - * @since 1.9.0 - */ - do_action( 'bp_add_permastructs' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** @@ -523,16 +416,13 @@ function bp_add_permastructs() { * The main purpose of 'bp_setup_theme' is give themes a place to load their * BuddyPress-specific functionality. * + * @deprecated No longer used in core. + * * @since 1.6.0 */ function bp_setup_theme() { - /** - * Fires inside the 'bp_setup_theme' function. - * - * @since 1.6.0 - */ - do_action( 'bp_setup_theme' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** @@ -545,16 +435,13 @@ function bp_setup_theme() { * time for other themes to load their features, such as BuddyPress support, * before our theme compatibility layer kicks in. * + * @deprecated No longer used in core. + * * @since 1.6.0 */ function bp_after_setup_theme() { - /** - * Fires inside the 'bp_after_setup_theme' function. - * - * @since 1.7.0 - */ - do_action( 'bp_after_setup_theme' ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** Theme Compatibility Filter ************************************************/ @@ -562,6 +449,8 @@ function bp_after_setup_theme() { /** * Fire the 'bp_request' filter, a piggy-back of WP's 'request'. * + * @deprecated No longer used in core. + * * @since 1.7.0 * * @see WP::parse_request() for a description of parameters. @@ -571,19 +460,14 @@ function bp_after_setup_theme() { */ function bp_request( $query_vars = array() ) { - /** - * Filters the query_vars for the current request. - * - * @since 1.7.0 - * - * @param array $query_vars Array of query variables. - */ - return apply_filters( 'bp_request', $query_vars ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_filter.' ); } /** * Fire the 'bp_login_redirect' filter, a piggy-back of WP's 'login_redirect'. * + * @deprecated No longer used in core. + * * @since 1.7.0 * * @param string $redirect_to See 'login_redirect'. @@ -593,16 +477,7 @@ function bp_request( $query_vars = array() ) { */ function bp_login_redirect( $redirect_to = '', $redirect_to_raw = '', $user = false ) { - /** - * Filters the URL to redirect to after login. - * - * @since 1.7.0 - * - * @param string $redirect_to The redirect destination URL. - * @param string $redirect_to_raw The requested redirect destination URL passed as a parameter. - * @param WP_User|WP_Error $user WP_User object if login was successful, WP_Error object otherwise. - */ - return apply_filters( 'bp_login_redirect', $redirect_to, $redirect_to_raw, $user ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_filter.' ); } /** @@ -610,6 +485,8 @@ function bp_login_redirect( $redirect_to = '', $redirect_to_raw = '', $user = fa * * Hooked to 'template_include'. * + * @deprecated No longer used in core. + * * @since 1.6.0 * * @param string $template See 'template_include'. @@ -617,33 +494,21 @@ function bp_login_redirect( $redirect_to = '', $redirect_to_raw = '', $user = fa */ function bp_template_include( $template = '' ) { - /** - * Filters the template to use with template_include. - * - * @since 1.6.0 - * - * @param string $template The path of the template to include. - */ - return apply_filters( 'bp_template_include', $template ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_filter.' ); } /** * Fire the 'bp_generate_rewrite_rules' action, where BP generates its rewrite rules. * + * @deprecated No longer used in core. + * * @since 1.7.0 * * @param WP_Rewrite $wp_rewrite See 'generate_rewrite_rules'. */ function bp_generate_rewrite_rules( $wp_rewrite ) { - /** - * Fires inside the 'bp_generate_rewrite_rules' function. - * - * @since 1.7.0 - * - * @param WP_Rewrite $wp_rewrite WP_Rewrite object. Passed by reference. - */ - do_action_ref_array( 'bp_generate_rewrite_rules', array( &$wp_rewrite ) ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** @@ -673,83 +538,23 @@ function bp_allowed_themes( $themes ) { /** * The main action used for handling theme-side POST requests. * + * @deprecated No longer used in core. + * * @since 1.9.0 */ function bp_post_request() { - // Bail if not a POST action. - if ( ! bp_is_post_request() ) { - return; - } - - // Bail if no action. - if ( empty( $_POST['action'] ) ) { - return; - } - - // Sanitize the POST action. - $action = sanitize_key( $_POST['action'] ); - - /** - * Fires at the end of the bp_post_request function. - * - * This dynamic action is probably the one you want to use. It narrows down - * the scope of the 'action' without needing to check it in your function. - * - * @since 1.9.0 - */ - do_action( 'bp_post_request_' . $action ); - - /** - * Fires at the end of the bp_post_request function. - * - * Use this static action if you don't mind checking the 'action' yourself. - * - * @since 1.9.0 - * - * @param string $action The action being run. - */ - do_action( 'bp_post_request', $action ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); } /** * The main action used for handling theme-side GET requests. * + * @deprecated No longer used in core. + * * @since 1.9.0 */ function bp_get_request() { - // Bail if not a POST action. - if ( ! bp_is_get_request() ) { - return; - } - - // Bail if no action. - if ( empty( $_GET['action'] ) ) { - return; - } - - // Sanitize the GET action. - $action = sanitize_key( $_GET['action'] ); - - /** - * Fires at the end of the bp_get_request function. - * - * This dynamic action is probably the one you want to use. It narrows down - * the scope of the 'action' without needing to check it in your function. - * - * @since 1.9.0 - */ - do_action( 'bp_get_request_' . $action ); - - /** - * Fires at the end of the bp_get_request function. - * - * Use this static action if you don't mind checking the 'action' yourself. - * - * @since 1.9.0 - * - * @param string $action The action being run. - */ - do_action( 'bp_get_request', $action ); + _deprecated_function( __FUNCTION__, '2.8.0', 'Callback has been moved to an anonymous function for the associated add_action.' ); }