WP_Roles::for_site │ public │ WP 4.9.0

Sets the site to operate on. Defaults to the current site.

Method of the class: WP_Roles{}

No Hooks.

Returns

null. Nothing (null).

Usage

global $wp_roles;
$wp_roles->for_site( $site_id );
$site_id(int)
Site ID to initialize roles for.
Default: current site

Notes

  • Global. wpdb. $wpdb WordPress database abstraction object.

Changelog

Since 4.9.0 Introduced.

WP_Roles::for_site() code WP 6.9

wp-includes/class-wp-roles.php 
public function for_site( $site_id = null ) {
	global $wpdb;

	if ( ! empty( $site_id ) ) {
		$this->site_id = absint( $site_id );
	} else {
		$this->site_id = get_current_blog_id();
	}

	$this->role_key = $wpdb->get_blog_prefix( $this->site_id ) . 'user_roles';

	if ( ! empty( $this->roles ) && ! $this->use_db ) {
		return;
	}

	$this->roles = $this->get_roles_data();

	$this->init_roles();
}