Kama и campusboy3 месяца назад1 EN

grant_super_admin() │ WP 3.0.0

Устанавливает указанному пользователю права супер администратора.

«Супер-администратор» - это не отдельная роль как Редактор, Администратор, а просто набор прав расширяющих возможности текущей роли.

Если у пользователя была роль ниже «Администратор», например «Редактор», то после установки ему прав супер-админа, он получит возможность управлять всем.

Эта функция добавляет логин пользователя в опцию site_admins в таблице wp_sitemeta:

$super_admins = get_site_option( 'site_admins' );

Супер-админа также можно указать в глобальной переменной $super_admins. Если она установлена, то она имеет приоритет над опцией site_admins и эта функция становится нерабочей, а все управление супер-админами переходит в глоб. опцию $super_admins

Используйте функцию revoke_super_admin(), чтобы отменить действие этой функции (удалить права супер-админа у указанного пользователя).

Также смотрите WP-CLI команды связанные с супер-админом: wp super-admin.

Работает на основе: update_site_option()
Хуки из функции

Возвращает

true|false.

  • true - Удалось сделать из пользователя супер-админа.
  • false - Не удалось сделать из пользователя супер-админа.
    Или если указанный пользователь уже супер-админ.
    Или если установлена глобальная переменная $super_admins.

Использование

grant_super_admin( $user_id );
$user_id(число) (обязательный)
ID пользователя, которому нужно дать права супер-админа.

Примеры

0

#1 Дадим права супер-админа пользователя с ID 5

Рекомендуется вызывать функцию всего один раз, а не при каждой генерации страницы. Потому что она меняет значение опции.

grant_super_admin( 5 );
0

#2 Установим права супер-админа и удалим их при активации/деактиванции плагина 

// дадим права
register_activation_hook( __FILE__, 'myplugin_activate' );
function myplugin_activate() {
	grant_super_admin( 5 );
}

// отберем права
register_deactivation_hook( __FILE__, 'myplugin_deactivate' );
function myplugin_deactivate(){
	revoke_super_admin( 5 );
}

Заметки

  • Global. Массив. $super_admins

Список изменений

С версии 3.0.0 Введена.

Код grant_super_admin() WP 6.9.4

wp-includes/capabilities.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, true ) ) {
		$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;
}

Роли и возможности (role capabilities)

Мультисайт

1 комментарий