2010-02-13 23:35:11 +01:00
< ? php
/**
* Site / blog functions that work with the blogs table and related data .
*
* @ package WordPress
2010-02-15 02:08:23 +01:00
* @ subpackage Multisite
2010-10-01 03:32:31 +02:00
* @ since MU
2010-02-13 23:35:11 +01:00
*/
2010-10-01 03:32:31 +02:00
/**
* Update the last_updated field for the current blog .
*
* @ since MU
*/
2010-02-13 23:35:11 +01:00
function wpmu_update_blogs_date () {
global $wpdb ;
2011-08-25 20:01:49 +02:00
update_blog_details ( $wpdb -> blogid , array ( 'last_updated' => current_time ( 'mysql' , true )) );
2013-12-01 18:32:10 +01:00
/**
* Fires after the blog details are updated .
*
* @ since MU
*
* @ param int $blog_id Blog ID .
*/
2010-02-13 23:35:11 +01:00
do_action ( 'wpmu_blog_updated' , $wpdb -> blogid );
}
2010-10-01 03:32:31 +02:00
/**
* Get a full blog URL , given a blog id .
*
* @ since MU
*
* @ param int $blog_id Blog ID
* @ return string
*/
2010-12-16 20:48:00 +01:00
function get_blogaddress_by_id ( $blog_id ) {
2010-02-13 23:35:11 +01:00
$bloginfo = get_blog_details ( ( int ) $blog_id , false ); // only get bare details!
2010-12-16 20:48:00 +01:00
return esc_url ( 'http://' . $bloginfo -> domain . $bloginfo -> path );
2010-02-13 23:35:11 +01:00
}
2010-10-01 03:32:31 +02:00
/**
* Get a full blog URL , given a blog name .
*
* @ since MU
*
* @ param string $blogname The ( subdomain or directory ) name
* @ return string
*/
2010-02-13 23:35:11 +01:00
function get_blogaddress_by_name ( $blogname ) {
if ( is_subdomain_install () ) {
if ( $blogname == 'main' )
$blogname = 'www' ;
2010-05-17 00:21:06 +02:00
$url = rtrim ( network_home_url (), '/' );
if ( ! empty ( $blogname ) )
2013-03-13 17:00:38 +01:00
$url = preg_replace ( '|^([^\.]+://)|' , " \$ { 1} " . $blogname . '.' , $url );
2010-02-13 23:35:11 +01:00
} else {
2010-05-17 00:21:06 +02:00
$url = network_home_url ( $blogname );
2010-02-13 23:35:11 +01:00
}
2010-05-17 00:21:06 +02:00
return esc_url ( $url . '/' );
2010-02-13 23:35:11 +01:00
}
2010-10-01 03:32:31 +02:00
/**
2012-12-20 16:55:32 +01:00
* Given a blog ' s ( subdomain or directory ) slug , retrieve its id .
2010-10-01 03:32:31 +02:00
*
* @ since MU
*
2012-09-24 21:31:37 +02:00
* @ param string $slug
2010-10-01 03:32:31 +02:00
* @ return int A blog id
*/
2012-09-24 21:31:37 +02:00
function get_id_from_blogname ( $slug ) {
2013-11-13 04:23:10 +01:00
global $wpdb ;
2012-09-24 21:31:37 +02:00
2013-11-13 04:23:10 +01:00
$current_site = get_current_site ();
2012-09-24 21:31:37 +02:00
$slug = trim ( $slug , '/' );
$blog_id = wp_cache_get ( 'get_id_from_blogname_' . $slug , 'blog-details' );
2010-02-13 23:35:11 +01:00
if ( $blog_id )
return $blog_id ;
if ( is_subdomain_install () ) {
2012-09-24 21:31:37 +02:00
$domain = $slug . '.' . $current_site -> domain ;
2010-02-13 23:35:11 +01:00
$path = $current_site -> path ;
} else {
$domain = $current_site -> domain ;
2012-09-24 21:31:37 +02:00
$path = $current_site -> path . $slug . '/' ;
2010-02-13 23:35:11 +01:00
}
2012-09-24 21:31:37 +02:00
2010-02-13 23:35:11 +01:00
$blog_id = $wpdb -> get_var ( $wpdb -> prepare ( " SELECT blog_id FROM { $wpdb -> blogs } WHERE domain = %s AND path = %s " , $domain , $path ) );
2012-09-24 21:31:37 +02:00
wp_cache_set ( 'get_id_from_blogname_' . $slug , $blog_id , 'blog-details' );
2010-02-13 23:35:11 +01:00
return $blog_id ;
}
/**
* Retrieve the details for a blog from the blogs table and blog options .
*
2010-10-01 03:32:31 +02:00
* @ since MU
2010-10-19 09:48:22 +02:00
*
2012-10-04 14:40:09 +02:00
* @ param int | string | array $fields A blog ID , a blog slug , or an array of fields to query against . Optional . If not specified the current blog ID is used .
2010-02-13 23:35:11 +01:00
* @ param bool $get_all Whether to retrieve all details or only the details in the blogs table . Default is true .
* @ return object Blog details .
*/
2012-10-04 14:40:09 +02:00
function get_blog_details ( $fields = null , $get_all = true ) {
2010-02-13 23:35:11 +01:00
global $wpdb ;
2010-02-14 00:09:54 +01:00
if ( is_array ( $fields ) ) {
if ( isset ( $fields [ 'blog_id' ]) ) {
$blog_id = $fields [ 'blog_id' ];
} elseif ( isset ( $fields [ 'domain' ]) && isset ( $fields [ 'path' ]) ) {
$key = md5 ( $fields [ 'domain' ] . $fields [ 'path' ] );
$blog = wp_cache_get ( $key , 'blog-lookup' );
if ( false !== $blog )
return $blog ;
2010-05-03 01:33:02 +02:00
if ( substr ( $fields [ 'domain' ], 0 , 4 ) == 'www.' ) {
$nowww = substr ( $fields [ 'domain' ], 4 );
2010-05-02 23:34:11 +02:00
$blog = $wpdb -> get_row ( $wpdb -> prepare ( " SELECT * FROM $wpdb->blogs WHERE domain IN (%s,%s) AND path = %s ORDER BY CHAR_LENGTH(domain) DESC " , $nowww , $fields [ 'domain' ], $fields [ 'path' ] ) );
} else {
$blog = $wpdb -> get_row ( $wpdb -> prepare ( " SELECT * FROM $wpdb->blogs WHERE domain = %s AND path = %s " , $fields [ 'domain' ], $fields [ 'path' ] ) );
}
2010-02-14 00:09:54 +01:00
if ( $blog ) {
wp_cache_set ( $blog -> blog_id . 'short' , $blog , 'blog-details' );
$blog_id = $blog -> blog_id ;
} else {
return false ;
}
} elseif ( isset ( $fields [ 'domain' ]) && is_subdomain_install () ) {
$key = md5 ( $fields [ 'domain' ] );
$blog = wp_cache_get ( $key , 'blog-lookup' );
if ( false !== $blog )
return $blog ;
2010-05-02 23:40:31 +02:00
if ( substr ( $fields [ 'domain' ], 0 , 4 ) == 'www.' ) {
$nowww = substr ( $fields [ 'domain' ], 4 );
$blog = $wpdb -> get_row ( $wpdb -> prepare ( " SELECT * FROM $wpdb->blogs WHERE domain IN (%s,%s) ORDER BY CHAR_LENGTH(domain) DESC " , $nowww , $fields [ 'domain' ] ) );
2010-05-02 23:34:11 +02:00
} else {
$blog = $wpdb -> get_row ( $wpdb -> prepare ( " SELECT * FROM $wpdb->blogs WHERE domain = %s " , $fields [ 'domain' ] ) );
}
2010-02-14 00:09:54 +01:00
if ( $blog ) {
wp_cache_set ( $blog -> blog_id . 'short' , $blog , 'blog-details' );
$blog_id = $blog -> blog_id ;
} else {
return false ;
}
} else {
return false ;
}
} else {
2012-10-04 14:40:09 +02:00
if ( ! $fields )
$blog_id = get_current_blog_id ();
elseif ( ! is_numeric ( $fields ) )
2010-02-14 00:09:54 +01:00
$blog_id = get_id_from_blogname ( $fields );
else
$blog_id = $fields ;
}
2010-02-13 23:35:11 +01:00
$blog_id = ( int ) $blog_id ;
$all = $get_all == true ? '' : 'short' ;
$details = wp_cache_get ( $blog_id . $all , 'blog-details' );
if ( $details ) {
if ( ! is_object ( $details ) ) {
2010-04-13 14:43:40 +02:00
if ( $details == - 1 ) {
2010-02-13 23:35:11 +01:00
return false ;
2010-04-13 14:43:40 +02:00
} else {
2010-02-13 23:35:11 +01:00
// Clear old pre-serialized objects. Cache clients do better with that.
wp_cache_delete ( $blog_id . $all , 'blog-details' );
2010-04-13 14:43:40 +02:00
unset ( $details );
}
} else {
return $details ;
2010-02-13 23:35:11 +01:00
}
}
2010-02-14 00:09:54 +01:00
// Try the other cache.
if ( $get_all ) {
$details = wp_cache_get ( $blog_id . 'short' , 'blog-details' );
} else {
$details = wp_cache_get ( $blog_id , 'blog-details' );
// If short was requested and full cache is set, we can return.
if ( $details ) {
if ( ! is_object ( $details ) ) {
2010-04-13 14:43:40 +02:00
if ( $details == - 1 ) {
2010-02-14 00:09:54 +01:00
return false ;
2010-04-13 14:43:40 +02:00
} else {
2010-02-14 00:09:54 +01:00
// Clear old pre-serialized objects. Cache clients do better with that.
2010-04-13 14:43:40 +02:00
wp_cache_delete ( $blog_id , 'blog-details' );
unset ( $details );
}
} else {
return $details ;
2010-02-14 00:09:54 +01:00
}
}
}
2010-04-13 14:43:40 +02:00
if ( empty ( $details ) ) {
$details = $wpdb -> get_row ( $wpdb -> prepare ( " SELECT * FROM $wpdb->blogs WHERE blog_id = %d /* get_blog_details */ " , $blog_id ) );
2010-02-14 00:09:54 +01:00
if ( ! $details ) {
// Set the full cache.
wp_cache_set ( $blog_id , - 1 , 'blog-details' );
return false ;
}
2010-02-13 23:35:11 +01:00
}
if ( ! $get_all ) {
wp_cache_set ( $blog_id . $all , $details , 'blog-details' );
return $details ;
}
2012-08-03 19:51:42 +02:00
switch_to_blog ( $blog_id );
$details -> blogname = get_option ( 'blogname' );
$details -> siteurl = get_option ( 'siteurl' );
$details -> post_count = get_option ( 'post_count' );
restore_current_blog ();
2010-02-13 23:35:11 +01:00
2013-12-01 18:32:10 +01:00
/**
* Filter a blog ' s details .
*
* @ since MU
*
* @ param object $details The blog details .
*/
2010-02-13 23:35:11 +01:00
$details = apply_filters ( 'blog_details' , $details );
wp_cache_set ( $blog_id . $all , $details , 'blog-details' );
$key = md5 ( $details -> domain . $details -> path );
wp_cache_set ( $key , $details , 'blog-lookup' );
return $details ;
}
/**
* Clear the blog details cache .
*
2010-10-01 03:32:31 +02:00
* @ since MU
2010-02-13 23:35:11 +01:00
*
* @ param int $blog_id Blog ID
*/
function refresh_blog_details ( $blog_id ) {
$blog_id = ( int ) $blog_id ;
$details = get_blog_details ( $blog_id , false );
2013-03-19 06:05:19 +01:00
if ( ! $details ) {
// Make sure clean_blog_cache() gets the blog ID
// when the blog has been previously cached as
// non-existent.
$details = ( object ) array (
'blog_id' => $blog_id ,
'domain' => null ,
'path' => null
);
}
2010-02-13 23:35:11 +01:00
2012-10-01 20:03:23 +02:00
clean_blog_cache ( $details );
2012-02-09 20:53:53 +01:00
2013-12-01 18:32:10 +01:00
/**
* Fires after the blog details cache is cleared .
*
* @ since 3.4 . 0
*
* @ param int $blog_id Blog ID .
*/
2012-02-09 20:53:53 +01:00
do_action ( 'refresh_blog_details' , $blog_id );
2010-02-13 23:35:11 +01:00
}
2014-06-28 06:07:16 +02:00
/**
* Refresh blog details when an option is updated .
*
* @ access private
* @ param string $option_name
*/
function _wp_refresh_blog_details_on_updated_option ( $option_name ) {
$options = array ( 'blogname' , 'siteurl' , 'post_count' );
if ( in_array ( $option_name , $options ) ) {
refresh_blog_details ( get_current_blog_id () );
}
}
2010-02-13 23:35:11 +01:00
/**
* Update the details for a blog . Updates the blogs table for a given blog id .
*
2010-10-01 03:32:31 +02:00
* @ since MU
2010-02-13 23:35:11 +01:00
*
* @ param int $blog_id Blog ID
* @ param array $details Array of details keyed by blogs table field names .
* @ return bool True if update succeeds , false otherwise .
*/
function update_blog_details ( $blog_id , $details = array () ) {
global $wpdb ;
if ( empty ( $details ) )
return false ;
if ( is_object ( $details ) )
$details = get_object_vars ( $details );
$current_details = get_blog_details ( $blog_id , false );
if ( empty ( $current_details ) )
return false ;
$current_details = get_object_vars ( $current_details );
$details = array_merge ( $current_details , $details );
$details [ 'last_updated' ] = current_time ( 'mysql' , true );
$update_details = array ();
$fields = array ( 'site_id' , 'domain' , 'path' , 'registered' , 'last_updated' , ' public ', ' archived ', ' mature ', ' spam ', ' deleted ', ' lang_id ' );
foreach ( array_intersect ( array_keys ( $details ), $fields ) as $field )
$update_details [ $field ] = $details [ $field ];
2012-10-11 14:37:46 +02:00
$result = $wpdb -> update ( $wpdb -> blogs , $update_details , array ( 'blog_id' => $blog_id ) );
if ( false === $result )
return false ;
2010-02-13 23:35:11 +01:00
// If spam status changed, issue actions.
2013-12-01 18:32:10 +01:00
if ( $details [ 'spam' ] != $current_details [ 'spam' ] ) {
if ( $details [ 'spam' ] == 1 ) {
/**
* Fires when the blog status is changed to 'spam' .
*
* @ since MU
*
* @ param int $blog_id Blog ID .
*/
2012-10-11 14:37:46 +02:00
do_action ( 'make_spam_blog' , $blog_id );
2013-12-01 18:32:10 +01:00
} else {
/**
* Fires when the blog status is changed to 'ham' .
*
* @ since MU
*
* @ param int $blog_id Blog ID .
*/
2012-10-11 14:37:46 +02:00
do_action ( 'make_ham_blog' , $blog_id );
2013-12-01 18:32:10 +01:00
}
2012-10-11 14:37:46 +02:00
}
// If mature status changed, issue actions.
2013-12-01 18:32:10 +01:00
if ( $details [ 'mature' ] != $current_details [ 'mature' ] ) {
if ( $details [ 'mature' ] == 1 ) {
/**
* Fires when the blog status is changed to 'mature' .
*
* @ since 3.1 . 0
*
* @ param int $blog_id Blog ID .
*/
2012-10-11 14:37:46 +02:00
do_action ( 'mature_blog' , $blog_id );
2013-12-01 18:32:10 +01:00
} else {
/**
* Fires when the blog status is changed to 'unmature' .
*
* @ since 3.1 . 0
*
* @ param int $blog_id Blog ID .
*/
2012-10-11 14:37:46 +02:00
do_action ( 'unmature_blog' , $blog_id );
2013-12-01 18:32:10 +01:00
}
2012-10-11 14:37:46 +02:00
}
// If archived status changed, issue actions.
2013-12-01 18:32:10 +01:00
if ( $details [ 'archived' ] != $current_details [ 'archived' ] ) {
if ( $details [ 'archived' ] == 1 ) {
/**
* Fires when the blog status is changed to 'archived' .
*
* @ since MU
*
* @ param int $blog_id Blog ID .
*/
2012-10-11 14:37:46 +02:00
do_action ( 'archive_blog' , $blog_id );
2013-12-01 18:32:10 +01:00
} else {
/**
* Fires when the blog status is changed to 'unarchived' .
*
* @ since MU
*
* @ param int $blog_id Blog ID .
*/
2012-10-11 14:37:46 +02:00
do_action ( 'unarchive_blog' , $blog_id );
2013-12-01 18:32:10 +01:00
}
2010-02-13 23:35:11 +01:00
}
2012-10-11 14:37:46 +02:00
// If deleted status changed, issue actions.
2013-12-01 18:32:10 +01:00
if ( $details [ 'deleted' ] != $current_details [ 'deleted' ] ) {
if ( $details [ 'deleted' ] == 1 ) {
/**
* Fires when the blog status is changed to 'deleted' .
*
* @ since 3.5 . 0
*
* @ param int $blog_id Blog ID .
*/
2012-10-11 14:37:46 +02:00
do_action ( 'make_delete_blog' , $blog_id );
2013-12-01 18:32:10 +01:00
} else {
/**
* Fires when the blog status is changed to 'undeleted' .
*
* @ since 3.5 . 0
*
* @ param int $blog_id Blog ID .
*/
2012-10-11 14:37:46 +02:00
do_action ( 'make_undelete_blog' , $blog_id );
2013-12-01 18:32:10 +01:00
}
2012-11-17 16:11:29 +01:00
}
2013-12-01 18:32:10 +01:00
if ( isset ( $details [ 'public' ] ) ) {
2012-08-03 19:51:42 +02:00
switch_to_blog ( $blog_id );
2013-12-01 18:32:10 +01:00
update_option ( 'blog_public' , $details [ 'public' ] );
2012-08-03 19:51:42 +02:00
restore_current_blog ();
}
2010-02-13 23:35:11 +01:00
refresh_blog_details ( $blog_id );
return true ;
}
2012-10-01 20:03:23 +02:00
/**
* Clean the blog cache
*
* @ since 3.5 . 0
*
* @ param stdClass $blog The blog details as returned from get_blog_details ()
*/
function clean_blog_cache ( $blog ) {
$blog_id = $blog -> blog_id ;
$domain_path_key = md5 ( $blog -> domain . $blog -> path );
wp_cache_delete ( $blog_id , 'blog-details' );
wp_cache_delete ( $blog_id . 'short' , 'blog-details' );
wp_cache_delete ( $domain_path_key , 'blog-lookup' );
wp_cache_delete ( 'current_blog_' . $blog -> domain , 'site-options' );
wp_cache_delete ( 'current_blog_' . $blog -> domain . $blog -> path , 'site-options' );
wp_cache_delete ( 'get_id_from_blogname_' . trim ( $blog -> path , '/' ), 'blog-details' );
wp_cache_delete ( $domain_path_key , 'blog-id-cache' );
}
2012-08-08 19:11:15 +02:00
/**
* Retrieve option value for a given blog id based on name of option .
*
* If the option does not exist or does not have a value , then the return value
* will be false . This is useful to check whether you need to install an option
* and is commonly used during installation of plugin options and to test
* whether upgrading is required .
*
* If the option was serialized then it will be unserialized when it is returned .
*
* @ since MU
*
* @ param int $id A blog ID . Can be null to refer to the current blog .
* @ param string $option Name of option to retrieve . Expected to not be SQL - escaped .
* @ param mixed $default Optional . Default value to return if the option does not exist .
* @ return mixed Value set for the option .
*/
function get_blog_option ( $id , $option , $default = false ) {
$id = ( int ) $id ;
if ( empty ( $id ) )
$id = get_current_blog_id ();
if ( get_current_blog_id () == $id )
return get_option ( $option , $default );
switch_to_blog ( $id );
2012-08-23 18:04:39 +02:00
$value = get_option ( $option , $default );
2012-08-08 19:11:15 +02:00
restore_current_blog ();
2013-12-01 18:32:10 +01:00
/**
* Filter a blog option value .
*
* The dynamic portion of the hook name , $option , refers to the blog option name .
*
* @ since 3.5 . 0
*
* @ param string $value The option value .
* @ param int $id Blog ID .
*/
return apply_filters ( " blog_option_ { $option } " , $value , $id );
2012-08-08 19:11:15 +02:00
}
/**
* Add a new option for a given blog id .
*
* You do not need to serialize values . If the value needs to be serialized , then
* it will be serialized before it is inserted into the database . Remember ,
* resources can not be serialized or added as an option .
*
* You can create options without values and then update the values later .
* Existing options will not be updated and checks are performed to ensure that you
* aren ' t adding a protected WordPress option . Care should be taken to not name
* options the same as the ones which are protected .
*
* @ since MU
*
* @ param int $id A blog ID . Can be null to refer to the current blog .
* @ param string $option Name of option to add . Expected to not be SQL - escaped .
* @ param mixed $value Optional . Option value , can be anything . Expected to not be SQL - escaped .
* @ return bool False if option was not added and true if option was added .
*/
function add_blog_option ( $id , $option , $value ) {
$id = ( int ) $id ;
if ( empty ( $id ) )
$id = get_current_blog_id ();
if ( get_current_blog_id () == $id )
return add_option ( $option , $value );
switch_to_blog ( $id );
$return = add_option ( $option , $value );
restore_current_blog ();
return $return ;
}
/**
* Removes option by name for a given blog id . Prevents removal of protected WordPress options .
*
* @ since MU
*
* @ param int $id A blog ID . Can be null to refer to the current blog .
* @ param string $option Name of option to remove . Expected to not be SQL - escaped .
* @ return bool True , if option is successfully deleted . False on failure .
*/
function delete_blog_option ( $id , $option ) {
$id = ( int ) $id ;
if ( empty ( $id ) )
$id = get_current_blog_id ();
if ( get_current_blog_id () == $id )
return delete_option ( $option );
switch_to_blog ( $id );
$return = delete_option ( $option );
restore_current_blog ();
return $return ;
}
/**
* Update an option for a particular blog .
*
* @ since MU
*
* @ param int $id The blog id
* @ param string $option The option key
* @ param mixed $value The option value
2013-04-29 14:49:33 +02:00
* @ return bool True on success , false on failure .
2012-08-08 19:11:15 +02:00
*/
function update_blog_option ( $id , $option , $value , $deprecated = null ) {
$id = ( int ) $id ;
if ( null !== $deprecated )
_deprecated_argument ( __FUNCTION__ , '3.1' );
if ( get_current_blog_id () == $id )
return update_option ( $option , $value );
switch_to_blog ( $id );
$return = update_option ( $option , $value );
restore_current_blog ();
refresh_blog_details ( $id );
return $return ;
}
2010-10-01 03:32:31 +02:00
/**
* Switch the current blog .
*
* This function is useful if you need to pull posts , or other information ,
* from other blogs . You can switch back afterwards using restore_current_blog () .
*
* Things that aren ' t switched :
* - autoloaded options . See #14992
* - plugins . See #14941
*
* @ see restore_current_blog ()
* @ since MU
*
* @ param int $new_blog The id of the blog you want to switch to . Default : current blog
2012-08-15 17:56:14 +02:00
* @ param bool $deprecated Deprecated argument
2014-03-02 05:41:15 +01:00
* @ return bool Always returns True .
2010-10-01 03:32:31 +02:00
*/
2012-08-09 18:28:15 +02:00
function switch_to_blog ( $new_blog , $deprecated = null ) {
global $wpdb , $wp_roles ;
2010-02-13 23:35:11 +01:00
2012-08-09 18:28:15 +02:00
if ( empty ( $new_blog ) )
$new_blog = $GLOBALS [ 'blog_id' ];
2010-02-13 23:35:11 +01:00
2012-08-09 18:28:15 +02:00
$GLOBALS [ '_wp_switched_stack' ][] = $GLOBALS [ 'blog_id' ];
2010-02-13 23:35:11 +01:00
2013-12-01 18:32:10 +01:00
/*
* If we 're switching to the same blog id that we' re on ,
* set the right vars , do the associated actions , but skip
* the extra unnecessary work
*/
2012-08-09 18:28:15 +02:00
if ( $new_blog == $GLOBALS [ 'blog_id' ] ) {
2013-12-01 18:32:10 +01:00
/**
* Fires when the blog is switched .
*
* @ since MU
*
* @ param int $new_blog New blog ID .
* @ param int $new_blog Blog ID .
*/
2012-08-09 18:28:15 +02:00
do_action ( 'switch_blog' , $new_blog , $new_blog );
2012-08-22 05:34:00 +02:00
$GLOBALS [ 'switched' ] = true ;
2010-02-13 23:35:11 +01:00
return true ;
}
2012-08-09 18:28:15 +02:00
$wpdb -> set_blog_id ( $new_blog );
2013-09-25 01:41:10 +02:00
$GLOBALS [ 'table_prefix' ] = $wpdb -> get_blog_prefix ();
2012-08-09 18:28:15 +02:00
$prev_blog_id = $GLOBALS [ 'blog_id' ];
$GLOBALS [ 'blog_id' ] = $new_blog ;
2010-10-19 09:48:22 +02:00
2012-08-02 20:31:14 +02:00
if ( function_exists ( 'wp_cache_switch_to_blog' ) ) {
2012-08-09 18:28:15 +02:00
wp_cache_switch_to_blog ( $new_blog );
2012-08-02 20:31:14 +02:00
} else {
2012-08-09 18:28:15 +02:00
global $wp_object_cache ;
2012-08-02 20:31:14 +02:00
if ( is_object ( $wp_object_cache ) && isset ( $wp_object_cache -> global_groups ) )
$global_groups = $wp_object_cache -> global_groups ;
2010-02-13 23:35:11 +01:00
else
2012-08-02 20:31:14 +02:00
$global_groups = false ;
2012-11-17 16:11:29 +01:00
2012-08-02 20:31:14 +02:00
wp_cache_init ();
2012-08-09 18:28:15 +02:00
if ( function_exists ( 'wp_cache_add_global_groups' ) ) {
2012-08-02 20:31:14 +02:00
if ( is_array ( $global_groups ) )
wp_cache_add_global_groups ( $global_groups );
else
2012-10-01 20:03:23 +02:00
wp_cache_add_global_groups ( array ( 'users' , 'userlogins' , 'usermeta' , 'user_meta' , 'site-transient' , 'site-options' , 'site-lookup' , 'blog-lookup' , 'blog-details' , 'rss' , 'global-posts' , ' blog-id-cache' ) );
2012-08-09 18:28:15 +02:00
wp_cache_add_non_persistent_groups ( array ( 'comment' , 'counts' , 'plugins' ) );
2012-08-02 20:31:14 +02:00
}
2010-02-13 23:35:11 +01:00
}
2012-10-01 16:25:31 +02:00
if ( did_action ( 'init' ) ) {
$wp_roles -> reinit ();
$current_user = wp_get_current_user ();
$current_user -> for_blog ( $new_blog );
}
2013-12-01 18:32:10 +01:00
/** This filter is documented in wp-includes/ms-blogs.php */
2012-08-09 18:28:15 +02:00
do_action ( 'switch_blog' , $new_blog , $prev_blog_id );
2012-08-22 05:34:00 +02:00
$GLOBALS [ 'switched' ] = true ;
2012-08-09 18:28:15 +02:00
2010-02-13 23:35:11 +01:00
return true ;
}
2010-10-01 03:32:31 +02:00
/**
* Restore the current blog , after calling switch_to_blog ()
*
* @ see switch_to_blog ()
* @ since MU
*
2012-08-15 17:56:14 +02:00
* @ return bool True on success , false if we ' re already on the current blog
2010-10-01 03:32:31 +02:00
*/
2010-02-13 23:35:11 +01:00
function restore_current_blog () {
2012-08-09 18:28:15 +02:00
global $wpdb , $wp_roles ;
2010-02-13 23:35:11 +01:00
2012-09-26 19:02:44 +02:00
if ( empty ( $GLOBALS [ '_wp_switched_stack' ] ) )
2010-02-13 23:35:11 +01:00
return false ;
2012-08-09 18:28:15 +02:00
$blog = array_pop ( $GLOBALS [ '_wp_switched_stack' ] );
2010-02-13 23:35:11 +01:00
2012-08-09 18:28:15 +02:00
if ( $GLOBALS [ 'blog_id' ] == $blog ) {
2013-12-01 18:32:10 +01:00
/** This filter is documented in wp-includes/ms-blogs.php */
2010-02-13 23:35:11 +01:00
do_action ( 'switch_blog' , $blog , $blog );
2012-08-09 18:28:15 +02:00
// If we still have items in the switched stack, consider ourselves still 'switched'
2012-08-22 05:34:00 +02:00
$GLOBALS [ 'switched' ] = ! empty ( $GLOBALS [ '_wp_switched_stack' ] );
2010-02-13 23:35:11 +01:00
return true ;
}
2012-08-09 18:28:15 +02:00
$wpdb -> set_blog_id ( $blog );
$prev_blog_id = $GLOBALS [ 'blog_id' ];
$GLOBALS [ 'blog_id' ] = $blog ;
2013-09-25 01:41:10 +02:00
$GLOBALS [ 'table_prefix' ] = $wpdb -> get_blog_prefix ();
2010-02-13 23:35:11 +01:00
2012-08-02 20:31:14 +02:00
if ( function_exists ( 'wp_cache_switch_to_blog' ) ) {
2012-08-09 18:28:15 +02:00
wp_cache_switch_to_blog ( $blog );
2012-08-02 20:31:14 +02:00
} else {
2012-08-09 18:28:15 +02:00
global $wp_object_cache ;
2012-08-02 20:31:14 +02:00
if ( is_object ( $wp_object_cache ) && isset ( $wp_object_cache -> global_groups ) )
$global_groups = $wp_object_cache -> global_groups ;
2010-02-13 23:35:11 +01:00
else
2012-08-02 20:31:14 +02:00
$global_groups = false ;
2012-11-17 16:11:29 +01:00
2012-08-02 20:31:14 +02:00
wp_cache_init ();
2012-08-09 18:28:15 +02:00
if ( function_exists ( 'wp_cache_add_global_groups' ) ) {
2012-08-02 20:31:14 +02:00
if ( is_array ( $global_groups ) )
wp_cache_add_global_groups ( $global_groups );
else
2012-10-01 20:03:23 +02:00
wp_cache_add_global_groups ( array ( 'users' , 'userlogins' , 'usermeta' , 'user_meta' , 'site-transient' , 'site-options' , 'site-lookup' , 'blog-lookup' , 'blog-details' , 'rss' , 'global-posts' , ' blog-id-cache' ) );
2012-08-09 18:28:15 +02:00
wp_cache_add_non_persistent_groups ( array ( 'comment' , 'counts' , 'plugins' ) );
2012-08-02 20:31:14 +02:00
}
2010-02-13 23:35:11 +01:00
}
2012-10-01 16:25:31 +02:00
if ( did_action ( 'init' ) ) {
$wp_roles -> reinit ();
$current_user = wp_get_current_user ();
$current_user -> for_blog ( $blog );
}
2013-12-01 18:32:10 +01:00
/** This filter is documented in wp-includes/ms-blogs.php */
2012-08-09 18:28:15 +02:00
do_action ( 'switch_blog' , $blog , $prev_blog_id );
// If we still have items in the switched stack, consider ourselves still 'switched'
2012-08-22 05:34:00 +02:00
$GLOBALS [ 'switched' ] = ! empty ( $GLOBALS [ '_wp_switched_stack' ] );
2010-02-13 23:35:11 +01:00
return true ;
}
2012-08-20 22:48:35 +02:00
/**
* Determines if switch_to_blog () is in effect
*
* @ since 3.5 . 0
*
* @ return bool True if switched , false otherwise .
*/
2012-08-20 22:56:34 +02:00
function ms_is_switched () {
2012-09-26 19:02:44 +02:00
return ! empty ( $GLOBALS [ '_wp_switched_stack' ] );
2012-08-20 22:48:35 +02:00
}
2010-10-01 03:32:31 +02:00
/**
* Check if a particular blog is archived .
*
* @ since MU
*
* @ param int $id The blog id
2010-10-08 04:35:06 +02:00
* @ return string Whether the blog is archived or not
2010-10-01 03:32:31 +02:00
*/
2010-02-13 23:35:11 +01:00
function is_archived ( $id ) {
return get_blog_status ( $id , 'archived' );
}
2010-10-01 03:32:31 +02:00
/**
* Update the 'archived' status of a particular blog .
*
* @ since MU
*
* @ param int $id The blog id
* @ param string $archived The new status
* @ return string $archived
*/
2010-02-13 23:35:11 +01:00
function update_archived ( $id , $archived ) {
update_blog_status ( $id , 'archived' , $archived );
return $archived ;
}
/**
* Update a blog details field .
*
2010-10-01 03:32:31 +02:00
* @ since MU
2010-02-13 23:35:11 +01:00
*
* @ param int $blog_id BLog ID
* @ param string $pref A field name
* @ param string $value Value for $pref
2010-10-01 03:32:31 +02:00
* @ return string $value
2010-02-13 23:35:11 +01:00
*/
2010-12-01 23:12:09 +01:00
function update_blog_status ( $blog_id , $pref , $value , $deprecated = null ) {
2010-02-13 23:35:11 +01:00
global $wpdb ;
2010-12-01 23:12:09 +01:00
if ( null !== $deprecated )
2010-12-15 12:27:38 +01:00
_deprecated_argument ( __FUNCTION__ , '3.1' );
2010-12-01 23:12:09 +01:00
2012-10-11 14:37:46 +02:00
if ( ! in_array ( $pref , array ( 'site_id' , 'domain' , 'path' , 'registered' , 'last_updated' , 'public' , 'archived' , 'mature' , 'spam' , 'deleted' , 'lang_id' ) ) )
2010-02-13 23:35:11 +01:00
return $value ;
2012-10-11 14:37:46 +02:00
$result = $wpdb -> update ( $wpdb -> blogs , array ( $pref => $value , 'last_updated' => current_time ( 'mysql' , true )), array ( 'blog_id' => $blog_id ) );
2010-02-13 23:35:11 +01:00
2012-10-11 14:37:46 +02:00
if ( false === $result )
return false ;
refresh_blog_details ( $blog_id );
2010-02-13 23:35:11 +01:00
2013-12-01 18:32:10 +01:00
if ( 'spam' == $pref ) {
if ( $value == 1 ) {
/** This filter is documented in wp-includes/ms-blogs.php */
do_action ( 'make_spam_blog' , $blog_id );
} else {
/** This filter is documented in wp-includes/ms-blogs.php */
do_action ( 'make_ham_blog' , $blog_id );
}
} elseif ( 'mature' == $pref ) {
if ( $value == 1 ) {
/** This filter is documented in wp-includes/ms-blogs.php */
do_action ( 'mature_blog' , $blog_id );
} else {
/** This filter is documented in wp-includes/ms-blogs.php */
do_action ( 'unmature_blog' , $blog_id );
}
} elseif ( 'archived' == $pref ) {
if ( $value == 1 ) {
/** This filter is documented in wp-includes/ms-blogs.php */
do_action ( 'archive_blog' , $blog_id );
} else {
/** This filter is documented in wp-includes/ms-blogs.php */
do_action ( 'unarchive_blog' , $blog_id );
}
} elseif ( 'deleted' == $pref ) {
if ( $value == 1 ) {
/** This filter is documented in wp-includes/ms-blogs.php */
do_action ( 'make_delete_blog' , $blog_id );
} else {
/** This filter is documented in wp-includes/ms-blogs.php */
do_action ( 'make_undelete_blog' , $blog_id );
}
} elseif ( 'public' == $pref ) {
/**
* Fires after the current blog 's ' public ' setting is updated .
*
* @ since MU
*
* @ param int $blog_id Blog ID .
* @ param string $value The value of blog status .
*/
2013-03-25 10:29:58 +01:00
do_action ( 'update_blog_public' , $blog_id , $value ); // Moved here from update_blog_public().
2013-12-01 18:32:10 +01:00
}
2010-02-13 23:35:11 +01:00
return $value ;
}
2010-10-01 03:32:31 +02:00
/**
* Get a blog details field .
*
* @ since MU
*
* @ param int $id The blog id
* @ param string $pref A field name
* @ return bool $value
*/
2010-02-13 23:35:11 +01:00
function get_blog_status ( $id , $pref ) {
global $wpdb ;
$details = get_blog_details ( $id , false );
if ( $details )
return $details -> $pref ;
return $wpdb -> get_var ( $wpdb -> prepare ( " SELECT %s FROM { $wpdb -> blogs } WHERE blog_id = %d " , $pref , $id ) );
}
2010-10-01 03:32:31 +02:00
/**
* Get a list of most recently updated blogs .
*
* @ since MU
2010-10-19 09:48:22 +02:00
*
2010-11-18 20:12:48 +01:00
* @ param mixed $deprecated Not used
2010-10-01 03:32:31 +02:00
* @ param int $start The offset
* @ param int $quantity The maximum number of blogs to retrieve . Default is 40.
* @ return array The list of blogs
*/
2010-02-13 23:35:11 +01:00
function get_last_updated ( $deprecated = '' , $start = 0 , $quantity = 40 ) {
global $wpdb ;
2010-12-13 22:21:50 +01:00
2010-11-18 20:12:48 +01:00
if ( ! empty ( $deprecated ) )
_deprecated_argument ( __FUNCTION__ , 'MU' ); // never used
2010-12-13 22:21:50 +01:00
2010-02-13 23:35:11 +01:00
return $wpdb -> get_results ( $wpdb -> prepare ( " SELECT blog_id, domain, path FROM $wpdb->blogs WHERE site_id = %d AND public = '1' AND archived = '0' AND mature = '0' AND spam = '0' AND deleted = '0' AND last_updated != '0000-00-00 00:00:00' ORDER BY last_updated DESC limit %d, %d " , $wpdb -> siteid , $start , $quantity ) , ARRAY_A );
}
2011-11-03 18:06:45 +01:00
/**
* Handler for updating the blog date when a post is published or an already published post is changed .
*
* @ since 3.3 . 0
*
* @ param string $new_status The new post status
* @ param string $old_status The old post status
* @ param object $post Post object
*/
function _update_blog_date_on_post_publish ( $new_status , $old_status , $post ) {
$post_type_obj = get_post_type_object ( $post -> post_type );
2014-07-29 02:51:17 +02:00
if ( ! $post_type_obj || ! $post_type_obj -> public ) {
2011-11-03 18:06:45 +01:00
return ;
2014-07-29 02:51:17 +02:00
}
2011-11-03 18:06:45 +01:00
2014-07-29 02:51:17 +02:00
if ( 'publish' != $new_status && 'publish' != $old_status ) {
2011-11-03 18:06:45 +01:00
return ;
2014-07-29 02:51:17 +02:00
}
2011-11-03 18:06:45 +01:00
// Post was freshly published, published post was saved, or published post was unpublished.
wpmu_update_blogs_date ();
}
2012-04-13 19:30:37 +02:00
/**
* Handler for updating the blog date when a published post is deleted .
*
* @ since 3.4 . 0
*
* @ param int $post_id Post ID
*/
function _update_blog_date_on_post_delete ( $post_id ) {
$post = get_post ( $post_id );
$post_type_obj = get_post_type_object ( $post -> post_type );
2014-07-29 02:51:17 +02:00
if ( ! $post_type_obj || ! $post_type_obj -> public ) {
2012-04-13 19:30:37 +02:00
return ;
2014-07-29 02:51:17 +02:00
}
2012-04-13 19:30:37 +02:00
2014-07-29 02:51:17 +02:00
if ( 'publish' != $post -> post_status ) {
2012-04-13 19:30:37 +02:00
return ;
2014-07-29 02:51:17 +02:00
}
2012-04-13 19:30:37 +02:00
wpmu_update_blogs_date ();
}
2014-06-26 02:53:15 +02:00
/**
* Handler for updating the blog posts count date when a post is deleted .
*
2014-07-29 02:59:16 +02:00
* @ since 4.0 . 0
2014-06-26 02:53:15 +02:00
*
2014-07-14 03:02:15 +02:00
* @ param int $post_id Post ID .
2014-06-26 02:53:15 +02:00
*/
function _update_posts_count_on_delete ( $post_id ) {
if ( 'publish' !== get_post_field ( 'post_status' , $post_id ) ) {
return ;
}
2014-06-28 06:07:16 +02:00
2014-06-26 02:53:15 +02:00
update_posts_count ();
}
/**
* Handler for updating the blog posts count date when a post status changes .
*
2014-07-29 02:59:16 +02:00
* @ since 4.0 . 0
2014-06-26 02:53:15 +02:00
*
* @ param string $new_status The status the post is changing to .
* @ param string $old_status The status the post is changing from .
*/
function _update_posts_count_on_transition_post_status ( $new_status , $old_status ) {
if ( $new_status === $old_status ) {
return ;
}
if ( 'publish' !== $new_status && 'publish' !== $old_status ) {
return ;
}
update_posts_count ();
}