class WP_Site {}

Core class used for interacting with a multisite site.

Description

This class is used during load to populate the $current_blog global and setup the current site.

Methods

NameDescription
WP_Site::__constructCreates a new WP_Site object.
WP_Site::__getGetter.
WP_Site::__issetIsset-er.
WP_Site::__setSetter.
WP_Site::get_detailsRetrieves the details for this site.
WP_Site::get_instanceRetrieves a site from the database by its ID.
WP_Site::to_arrayConverts an object to array.

Source

final class WP_Site {	/** * Site ID. * * Named "blog" vs. "site" for legacy reasons. * * A numeric string, for compatibility reasons. * * @since 4.5.0 * @var string */	public $blog_id;	/** * Domain of the site. * * @since 4.5.0 * @var string */	public $domain = '';	/** * Path of the site. * * @since 4.5.0 * @var string */	public $path = '';	/** * The ID of the site's parent network. * * Named "site" vs. "network" for legacy reasons. An individual site's "site" is * its network. * * A numeric string, for compatibility reasons. * * @since 4.5.0 * @var string */	public $site_id = '0';	/** * The date and time on which the site was created or registered. * * @since 4.5.0 * @var string Date in MySQL's datetime format. */	public $registered = '0000-00-00 00:00:00';	/** * The date and time on which site settings were last updated. * * @since 4.5.0 * @var string Date in MySQL's datetime format. */	public $last_updated = '0000-00-00 00:00:00';	/** * Whether the site should be treated as public. * * A numeric string, for compatibility reasons. * * @since 4.5.0 * @var string */	public $public = '1';	/** * Whether the site should be treated as archived. * * A numeric string, for compatibility reasons. * * @since 4.5.0 * @var string */	public $archived = '0';	/** * Whether the site should be treated as mature. * * Handling for this does not exist throughout WordPress core, but custom * implementations exist that require the property to be present. * * A numeric string, for compatibility reasons. * * @since 4.5.0 * @var string */	public $mature = '0';	/** * Whether the site should be treated as spam. * * A numeric string, for compatibility reasons. * * @since 4.5.0 * @var string */	public $spam = '0';	/** * Whether the site should be treated as deleted. * * A numeric string, for compatibility reasons. * * @since 4.5.0 * @var string */	public $deleted = '0';	/** * The language pack associated with this site. * * A numeric string, for compatibility reasons. * * @since 4.5.0 * @var string */	public $lang_id = '0';	/** * Retrieves a site from the database by its ID. * * @since 4.5.0 * * @global wpdb $wpdb WordPress database abstraction object. * * @param int $site_id The ID of the site to retrieve. * @return WP_Site|false The site's object if found. False if not. */	public static function get_instance( $site_id ) {	global $wpdb;	$site_id = (int) $site_id;	if ( ! $site_id ) {	return false;	}	$_site = wp_cache_get( $site_id, 'sites' );	if ( false === $_site ) {	$_site = $wpdb->get_row( $wpdb->prepare( "SELECT * FROM {$wpdb->blogs} WHERE blog_id = %d LIMIT 1", $site_id ) );	if ( empty( $_site ) || is_wp_error( $_site ) ) {	$_site = -1;	}	wp_cache_add( $site_id, $_site, 'sites' );	}	if ( is_numeric( $_site ) ) {	return false;	}	return new WP_Site( $_site );	}	/** * Creates a new WP_Site object. * * Will populate object properties from the object provided and assign other * default properties based on that information. * * @since 4.5.0 * * @param WP_Site|object $site A site object. */	public function __construct( $site ) {	foreach ( get_object_vars( $site ) as $key => $value ) {	$this->$key = $value;	}	}	/** * Converts an object to array. * * @since 4.6.0 * * @return array Object as array. */	public function to_array() {	return get_object_vars( $this );	}	/** * Getter. * * Allows current multisite naming conventions when getting properties. * Allows access to extended site properties. * * @since 4.6.0 * * @param string $key Property to get. * @return mixed Value of the property. Null if not available. */	public function __get( $key ) {	switch ( $key ) {	case 'id':	return (int) $this->blog_id;	case 'network_id':	return (int) $this->site_id;	case 'blogname':	case 'siteurl':	case 'post_count':	case 'home':	default: // Custom properties added by 'site_details' filter.	if ( ! did_action( 'ms_loaded' ) ) {	return null;	}	$details = $this->get_details();	if ( isset( $details->$key ) ) {	return $details->$key;	}	}	return null;	}	/** * Isset-er. * * Allows current multisite naming conventions when checking for properties. * Checks for extended site properties. * * @since 4.6.0 * * @param string $key Property to check if set. * @return bool Whether the property is set. */	public function __isset( $key ) {	switch ( $key ) {	case 'id':	case 'network_id':	return true;	case 'blogname':	case 'siteurl':	case 'post_count':	case 'home':	if ( ! did_action( 'ms_loaded' ) ) {	return false;	}	return true;	default: // Custom properties added by 'site_details' filter.	if ( ! did_action( 'ms_loaded' ) ) {	return false;	}	$details = $this->get_details();	if ( isset( $details->$key ) ) {	return true;	}	}	return false;	}	/** * Setter. * * Allows current multisite naming conventions while setting properties. * * @since 4.6.0 * * @param string $key Property to set. * @param mixed $value Value to assign to the property. */	public function __set( $key, $value ) {	switch ( $key ) {	case 'id':	$this->blog_id = (string) $value;	break;	case 'network_id':	$this->site_id = (string) $value;	break;	default:	$this->$key = $value;	}	}	/** * Retrieves the details for this site. * * This method is used internally to lazy-load the extended properties of a site. * * @since 4.6.0 * * @see WP_Site::__get() * * @return stdClass A raw site object with all details included. */	private function get_details() {	$details = wp_cache_get( $this->blog_id, 'site-details' );	if ( false === $details ) {	switch_to_blog( $this->blog_id );	// Create a raw copy of the object for backward compatibility with the filter below.	$details = new stdClass();	foreach ( get_object_vars( $this ) as $key => $value ) {	$details->$key = $value;	}	$details->blogname = get_option( 'blogname' );	$details->siteurl = get_option( 'siteurl' );	$details->post_count = get_option( 'post_count' );	$details->home = get_option( 'home' );	restore_current_blog();	wp_cache_set( $this->blog_id, $details, 'site-details' );	}	/** This filter is documented in wp-includes/ms-blogs.php */	$details = apply_filters_deprecated( 'blog_details', array( $details ), '4.7.0', 'site_details' );	/** * Filters a site's extended properties. * * @since 4.6.0 * * @param stdClass $details The site details. */	$details = apply_filters( 'site_details', $details );	return $details;	} } 

Changelog

VersionDescription
4.5.0Introduced.

User Contributed Notes

  1. Skip to note 3 content

    A WP_Site object returned by the function get_sites() ;

    WP_Site Object ( [blog_id] => 2 [domain] => localhost [path] => /m2/sagres/ [site_id] => 1 [registered] => 2018-03-23 13:49:37 

    Last updated

    => 2019-03-05 15:52:10 [public] => 0 [archived] => 0 [mature] => 0 [spam] => 0 [deleted] => 0 [lang_id] => 0 )

You must log in before being able to contribute a note or feedback.