function user_role_grant_permissions

Same name and namespace in other branches
  1. 11.x core/modules/user/user.module \user_role_grant_permissions()
  2. 10 core/modules/user/user.module \user_role_grant_permissions()
  3. 9 core/modules/user/user.module \user_role_grant_permissions()
  4. 8.9.x core/modules/user/user.module \user_role_grant_permissions()
  5. 7.x modules/user/user.module \user_role_grant_permissions()

Grant permissions to a user role.

Parameters

mixed $rid: The ID of a user role to alter.

array $permissions: (optional) A list of permission names to grant.

Deprecated

in drupal:11.5.0 and is removed from drupal:13.0.0. Use \Drupal\user\RoleInterface::grantPermissions() instead.

See also

RoleInterface::changePermissions()

RoleInterface::revokePermissions()

https://www.drupal.org/node/3348027

5 calls to user_role_grant_permissions()
ContactPersonalTest::testAdminContact in core/modules/contact/tests/src/Functional/ContactPersonalTest.php
Tests the personal contact form based access when an admin adds users.
ContactPersonalTest::testPersonalContactAccess in core/modules/contact/tests/src/Functional/ContactPersonalTest.php
Tests access to the personal contact form.
ContactSitewideTest::testAutoReply in core/modules/contact/tests/src/Functional/ContactSitewideTest.php
Tests auto-reply on the site-wide contact form.
ContactSitewideTest::testSiteWideContact in core/modules/contact/tests/src/Functional/ContactSitewideTest.php
Tests configuration options and the site-wide contact form.
ContactStorageTest::testContactStorage in core/modules/contact/tests/src/Functional/ContactStorageTest.php
Tests configuration options and the site-wide contact form.

File

core/modules/user/user.module, line 358

Code

function user_role_grant_permissions($rid, array $permissions = []) : void {
  @trigger_error(__METHOD__ . '() is deprecated in drupal:11.5.0 and is removed from drupal:13.0.0. Use \\Drupal\\user\\RoleInterface::grantPermissions() instead. See https://www.drupal.org/node/3348027', E_USER_DEPRECATED);
  $role_storage = \Drupal::entityTypeManager()->getStorage('user_role');
  if ($role = $role_storage->loadOverrideFree($rid)) {
    $role->grantPermissions($permissions);
    $role->save();
  }
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.