/**
 * Add a user to a blog.
 *
 * Use the 'add_user_to_blog' action to fire an event when
 * users are added to a blog.
 *
 * @since MU 1.0
 *
 * @param int    $blog_id ID of the blog you're adding the user to.
 * @param int    $user_id ID of the user you're adding.
 * @param string $role    The role you want the user to have
 * @return true|WP_Error
 */
function add_user_to_blog( $blog_id, $user_id, $role ) {
	switch_to_blog($blog_id);

	$user = get_userdata( $user_id );

	if ( ! $user ) {
		restore_current_blog();
		return new WP_Error( 'user_does_not_exist', __( 'The requested user does not exist.' ) );
	}

	if ( !get_user_meta($user_id, 'primary_blog', true) ) {
		update_user_meta($user_id, 'primary_blog', $blog_id);
		$details = get_blog_details($blog_id);
		update_user_meta($user_id, 'source_domain', $details->domain);
	}

	$user->set_role($role);

	/**
	 * Fires immediately after a user is added to a site.
	 *
	 * @since MU
	 *
	 * @param int    $user_id User ID.
	 * @param string $role    User role.
	 * @param int    $blog_id Blog ID.
	 */
	do_action( 'add_user_to_blog', $user_id, $role, $blog_id );
	wp_cache_delete( $user_id, 'users' );
	wp_cache_delete( $blog_id . '_user_count', 'blog-details' );
	restore_current_blog();
	return true;
}

absint()

absint( mixed $maybeint )将值转换为非负整数，也就是取绝对值。Convert a value to non-negative integer.目录锚点：#参数#返回#源码#笔记参数（Parameters）参数类型必填说明$maybeint（mixed）必需要转换为非负整数的数据。返回（Return）（int）非负整数。源码（Source）function absint( $maybeint ) { return abs( intval( $maybeint ) );}/** *...

activate_plugin()

activate_plugin( string $plugin, string $redirect = '', bool $network_wide = false, bool $silent = false )尝试激活插件，并在成功时重定向。Attempts activation of plugin in a “sandbox” and redirects on success.目录锚点：#说明#参数#返回#源码#笔记说明（Description）已激活的插件将不会再次尝试激活。其工作方式是在尝试包含插件...

activate_plugins()

activate_plugins( string|string[] $plugins, string $redirect = '', bool $network_wide = false, bool $silent = false )激活多个插件。Activate multiple plugins.目录锚点：#说明#参数#返回#源码说明（Description）当WP_Error返回时，并不意...

activate_sitewide_plugin()

activate_sitewide_plugin()不推荐用于激活仅网络插件的功能。Deprecated functionality for activating a network-only plugin.目录锚点：#说明#返回#源码说明（Description）另见激活插件（）返回（Return）无返回值源码（Source）更新版本源码位置使用被使用3.0.0 wp-admin/includes/ms-deprecated.php:5701 function...

addslashes_gpc()

addslashes_gpc( string $gpc )添加斜线以转义字符串。Adds slashes to escape strings.目录锚点：#说明#参数#返回#源码说明（Description）如果设置了magic_quotes_gpc，将首先删除斜线，请参见https://www.php.net/magic_quotes更多细节。参数（Parameters）参数类型必填说明 $gpc （string） ...

addslashes_strings_only()

addslashes_strings_only( mixed $value )仅当提供的值是字符串时才添加斜杠。Adds slashes only if the provided value is a string.目录锚点：#参数#返回#源码参数（Parameters）参数类型必填说明 $value （mixed） 必需 返回（Return）（mixe...

add_action()

add_action( string $tag, callable $function_to_add, int $priority = 10, int $accepted_args = 1 )将函数挂接到特定操作上。Hooks a function on to a specific action.目录锚点：#说明#参数#返回#源码#笔记说明（Description）Actions是WordPress核心在执行期间...

add_blog_option()

add_blog_option( int $id, string $option, mixed $value )为给定的博客id添加新选项。Add a new option for a given blog id.目录锚点：#说明#参数#返回#源码#笔记说明（Description）不需要序列化值。如果需要序列化该值，则在将其插入数据库之前将对其进行序列化。请记住，资源不能序列化或作为选项添加。可以创建不带值的选项，然后稍后更新这些值。现有选项将不会更新，并执行检...

add_clean_index()

add_clean_index( string $table, string $index )向指定表添加索引。Adds an index to a specified table.目录锚点：#参数#返回#源码#笔记参数（Parameters）参数类型必填说明 $table （string） 必需 数据库表名。 ...

add_comments_page()

add_comments_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '', int $position = null )将子菜单页添加到“注释”主菜单。Add submenu page to the Comments ma...