授予超级管理员权限。
原型
grant_super_admin( int $user_id )
参数
$user_id
(int)
(Required)
要授予超级管理员权限的用户的ID。
返回值
(bool)
成功时是真的,失败时是假的。当用户已经是超级管理员或者当用户时,这可能会失败
源文件
路径:wp-includes/capabilities.php
<?php
...
function grant_super_admin( $user_id ) {
// If global super_admins override is defined, there is nothing to do here.
if ( isset( $GLOBALS['super_admins'] ) || ! is_multisite() ) {
return false;
}
/**
* Fires before the user is granted Super Admin privileges.
*
* @since 3.0.0
*
* @param int $user_id ID of the user that is about to be granted Super Admin privileges.
*/
do_action( 'grant_super_admin', $user_id );
// Directly fetch site_admins instead of using get_super_admins()
$super_admins = get_site_option( 'site_admins', array( 'admin' ) );
$user = get_userdata( $user_id );
if ( $user && ! in_array( $user->user_login, $super_admins ) ) {
$super_admins[] = $user->user_login;
update_site_option( 'site_admins' , $super_admins );
/**
* Fires after the user is granted Super Admin privileges.
*
* @since 3.0.0
*
* @param int $user_id ID of the user that was granted Super Admin privileges.
*/
do_action( 'granted_super_admin', $user_id );
return true;
}
return false;
}
...
?>
其他
英文文档:https://developer.wordpress.org/reference/functions/grant_super_admin/