switch_to_blog

函式
switch_to_blog ( $new_blog_id, $deprecated = null )
引數
  • (int) $new_blog_id The ID of the blog to switch to. Default: current blog.
    Required:
  • (bool) $deprecated Not used.
    Required:
    Default: null
返回值
  • (true) Always returns true.
相關
  • restore_current_blog()
定義位置
相關方法
switch_to_localewp_cache_switch_to_blogthe_custom_logoswitch_themeadd_user_to_blog
引入
-
棄用
-

switch_to_blog: 這是一個WordPress函式,允許你在WordPress多站點安裝中把當前站點切換到不同的站點: 這個函式只需要一個引數,即你想切換到的網站的ID。一旦切換完成,所有後續的WordPress函式和查詢將被引導到新的站點,直到你切換回原來的站點。

切換當前部落格。

如果你需要從其他部落格中提取文章,或其他資訊,這個函式很有用。你可以在事後用restore_current_blog()切換回來。

沒有被切換的東西。 – plugins. See #14941

function switch_to_blog( $new_blog_id, $deprecated = null ) {
	global $wpdb;

	$prev_blog_id = get_current_blog_id();
	if ( empty( $new_blog_id ) ) {
		$new_blog_id = $prev_blog_id;
	}

	$GLOBALS['_wp_switched_stack'][] = $prev_blog_id;

	/*
	 * 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
	 */
	if ( $new_blog_id == $prev_blog_id ) {
		/**
		 * Fires when the blog is switched.
		 *
		 * @since MU (3.0.0)
		 * @since 5.4.0 The `$context` parameter was added.
		 *
		 * @param int    $new_blog_id  New blog ID.
		 * @param int    $prev_blog_id Previous blog ID.
		 * @param string $context      Additional context. Accepts 'switch' when called from switch_to_blog()
		 *                             or 'restore' when called from restore_current_blog().
		 */
		do_action( 'switch_blog', $new_blog_id, $prev_blog_id, 'switch' );

		$GLOBALS['switched'] = true;

		return true;
	}

	$wpdb->set_blog_id( $new_blog_id );
	$GLOBALS['table_prefix'] = $wpdb->get_blog_prefix();
	$GLOBALS['blog_id']      = $new_blog_id;

	if ( function_exists( 'wp_cache_switch_to_blog' ) ) {
		wp_cache_switch_to_blog( $new_blog_id );
	} else {
		global $wp_object_cache;

		if ( is_object( $wp_object_cache ) && isset( $wp_object_cache->global_groups ) ) {
			$global_groups = $wp_object_cache->global_groups;
		} else {
			$global_groups = false;
		}

		wp_cache_init();

		if ( function_exists( 'wp_cache_add_global_groups' ) ) {
			if ( is_array( $global_groups ) ) {
				wp_cache_add_global_groups( $global_groups );
			} else {
				wp_cache_add_global_groups(
					array(
						'blog-details',
						'blog-id-cache',
						'blog-lookup',
						'blog_meta',
						'global-posts',
						'networks',
						'sites',
						'site-details',
						'site-options',
						'site-transient',
						'rss',
						'users',
						'useremail',
						'userlogins',
						'usermeta',
						'user_meta',
						'userslugs',
					)
				);
			}

			wp_cache_add_non_persistent_groups( array( 'counts', 'plugins' ) );
		}
	}

	/** This filter is documented in wp-includes/ms-blogs.php */
	do_action( 'switch_blog', $new_blog_id, $prev_blog_id, 'switch' );

	$GLOBALS['switched'] = true;

	return true;
}

常見問題

FAQs
檢視更多 >