bp_core_get_root_options()
Fetch global BP options.
Description
BuddyPress uses common options to store configuration settings. Many of these settings are needed at run time. Instead of fetching them all and adding many initial queries to each page load, let’s fetch them all in one go.
Return
(array) $root_blog_options_meta List of options.
Source
File: bp-core/bp-core-options.php
397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 | function bp_core_get_root_options() { global $wpdb; // Get all the BuddyPress settings, and a few useful WP ones too. $root_blog_options = bp_get_default_options(); $root_blog_options['registration'] = '0'; $root_blog_options['avatar_default'] = 'mysteryman'; $root_blog_option_keys = array_keys( $root_blog_options ); // Do some magic to get all the root blog options in 1 swoop // Check cache first - We cache here instead of using the standard WP // settings cache because the current blog may not be the root blog, // and it's not practical to access the cache across blogs. $root_blog_options_meta = wp_cache_get( 'root_blog_options', 'bp' ); if ( false === $root_blog_options_meta ) { $blog_options_keys = "'" . join( "', '", (array) $root_blog_option_keys ) . "'"; $blog_options_table = bp_is_multiblog_mode() ? $wpdb->options : $wpdb->get_blog_prefix( bp_get_root_blog_id() ) . 'options'; $blog_options_query = "SELECT option_name AS name, option_value AS value FROM {$blog_options_table} WHERE option_name IN ( {$blog_options_keys} )"; $root_blog_options_meta = $wpdb->get_results( $blog_options_query ); // On Multisite installations, some options must always be fetched from sitemeta. if ( is_multisite() ) { /** * Filters multisite options retrieved from sitemeta. * * @since BuddyPress 1.5.0 * * @param array $value Array of multisite options from sitemeta table. */ $network_options = apply_filters( 'bp_core_network_options', array( 'tags_blog_id' => '0', 'sitewide_tags_blog' => '', 'registration' => '0', 'fileupload_maxk' => '1500' ) ); $current_site = get_current_site(); $network_option_keys = array_keys( $network_options ); $sitemeta_options_keys = "'" . join( "', '", (array) $network_option_keys ) . "'"; $sitemeta_options_query = $wpdb->prepare( "SELECT meta_key AS name, meta_value AS value FROM {$wpdb->sitemeta} WHERE meta_key IN ( {$sitemeta_options_keys} ) AND site_id = %d", $current_site->id ); $network_options_meta = $wpdb->get_results( $sitemeta_options_query ); // Sitemeta comes second in the merge, so that network 'registration' value wins. $root_blog_options_meta = array_merge( $root_blog_options_meta, $network_options_meta ); } // Loop through our results and make them usable. foreach ( $root_blog_options_meta as $root_blog_option ) { $root_blog_options[$root_blog_option->name] = $root_blog_option->value; } // Copy the options no the return val. $root_blog_options_meta = $root_blog_options; // Clean up our temporary copy. unset( $root_blog_options ); wp_cache_set( 'root_blog_options', $root_blog_options_meta, 'bp' ); } /** * Filters the global BP options. * * @since BuddyPress 1.5.0 * * @param array $root_blog_options_meta Array of global BP options. */ return apply_filters( 'bp_core_get_root_options', $root_blog_options_meta );} |
Changelog
| Version | Description |
|---|---|
| BuddyPress 1.5.0 | Introduced. |
Questions?
We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.