Mercurial > hg > isophonics-drupal-site
comparison core/modules/user/src/RoleInterface.php @ 0:4c8ae668cc8c
Initial import (non-working)
author | Chris Cannam |
---|---|
date | Wed, 29 Nov 2017 16:09:58 +0000 |
parents | |
children |
comparison
equal
deleted
inserted
replaced
-1:000000000000 | 0:4c8ae668cc8c |
---|---|
1 <?php | |
2 | |
3 namespace Drupal\user; | |
4 | |
5 use Drupal\Core\Config\Entity\ConfigEntityInterface; | |
6 use Drupal\Core\Session\AccountInterface; | |
7 | |
8 /** | |
9 * Provides an interface defining a user role entity. | |
10 * | |
11 * @ingroup user_api | |
12 */ | |
13 interface RoleInterface extends ConfigEntityInterface { | |
14 | |
15 /** | |
16 * Role ID for anonymous users; should match what's in the "role" table. | |
17 */ | |
18 const ANONYMOUS_ID = AccountInterface::ANONYMOUS_ROLE; | |
19 | |
20 /** | |
21 * Role ID for authenticated users; should match what's in the "role" table. | |
22 */ | |
23 const AUTHENTICATED_ID = AccountInterface::AUTHENTICATED_ROLE; | |
24 | |
25 /** | |
26 * Returns a list of permissions assigned to the role. | |
27 * | |
28 * @return array | |
29 * The permissions assigned to the role. | |
30 */ | |
31 public function getPermissions(); | |
32 | |
33 /** | |
34 * Checks if the role has a permission. | |
35 * | |
36 * @param string $permission | |
37 * The permission to check for. | |
38 * | |
39 * @return bool | |
40 * TRUE if the role has the permission, FALSE if not. | |
41 */ | |
42 public function hasPermission($permission); | |
43 | |
44 /** | |
45 * Grant permissions to the role. | |
46 * | |
47 * @param string $permission | |
48 * The permission to grant. | |
49 * | |
50 * @return $this | |
51 */ | |
52 public function grantPermission($permission); | |
53 | |
54 /** | |
55 * Revokes a permissions from the user role. | |
56 * | |
57 * @param string $permission | |
58 * The permission to revoke. | |
59 * | |
60 * @return $this | |
61 */ | |
62 public function revokePermission($permission); | |
63 | |
64 /** | |
65 * Indicates that a role has all available permissions. | |
66 * | |
67 * @return bool | |
68 * TRUE if the role has all permissions. | |
69 */ | |
70 public function isAdmin(); | |
71 | |
72 /** | |
73 * Sets the role to be an admin role. | |
74 * | |
75 * @param bool $is_admin | |
76 * TRUE if the role should be an admin role. | |
77 * | |
78 * @return $this | |
79 */ | |
80 public function setIsAdmin($is_admin); | |
81 | |
82 /** | |
83 * Returns the weight. | |
84 * | |
85 * @return int | |
86 * The weight of this role. | |
87 */ | |
88 public function getWeight(); | |
89 | |
90 /** | |
91 * Sets the weight to the given value. | |
92 * | |
93 * @param int $weight | |
94 * The desired weight. | |
95 * | |
96 * @return $this | |
97 */ | |
98 public function setWeight($weight); | |
99 | |
100 } |