function user_role_grant_permissions

Same name and namespace in other branches
  1. 10 core/modules/user/user.module \user_role_grant_permissions()
  2. 9 core/modules/user/user.module \user_role_grant_permissions()
  3. 8.9.x core/modules/user/user.module \user_role_grant_permissions()
  4. 7.x modules/user/user.module \user_role_grant_permissions()
  5. main core/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

6 calls to user_role_grant_permissions()
CommentCSSTest::setUp in core/modules/history/tests/src/Functional/CommentCSSTest.php
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.

... See full list

File

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

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.