WPSEO_Role_Manager_VIP::add_role()protectedYoast 1.0

Устарела с версии 19.9. Больше не поддерживается и может быть удалена. Рекомендуется заменить эту функцию на аналог.

Adds a role to the system.

Метод класса: WPSEO_Role_Manager_VIP{}

Хуков нет.

Возвращает

null. Ничего.

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

// protected - в коде основоного (родительского) или дочернего класса
$result = $this->add_role( $role, $display_name, $capabilities );
$role(строка) (обязательный)
Role to add.
$display_name(строка) (обязательный)
Name to display for the role.
$capabilities(массив)
Capabilities to add to the role.
По умолчанию: []

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

Устарела с 19.9

Код WPSEO_Role_Manager_VIP::add_role() Yoast 19.11

protected function add_role( $role, $display_name, array $capabilities = [] ) {
	_deprecated_function( __METHOD__, 'WPSEO 19.9' );

	$enabled_capabilities  = [];
	$disabled_capabilities = [];

	// Build lists of enabled and disabled capabilities.
	foreach ( $capabilities as $capability => $grant ) {
		if ( $grant ) {
			$enabled_capabilities[] = $capability;
		}

		if ( ! $grant ) {
			$disabled_capabilities[] = $capability;
		}
	}

	wpcom_vip_add_role( $role, $display_name, $enabled_capabilities );
	if ( $disabled_capabilities !== [] ) {
		wpcom_vip_remove_role_caps( $role, $disabled_capabilities );
	}
}