You are here

interface PermissionHandlerInterface in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 core/modules/user/src/PermissionHandlerInterface.php \Drupal\user\PermissionHandlerInterface

Defines an interface to list available permissions.

Hierarchy

Expanded class hierarchy of PermissionHandlerInterface

All classes that implement PermissionHandlerInterface

4 files declare their use of PermissionHandlerInterface
ModulesListForm.php in core/modules/system/src/Form/ModulesListForm.php
Contains \Drupal\system\Form\ModulesListForm.
Permission.php in core/modules/user/src/Plugin/views/access/Permission.php
Contains \Drupal\user\Plugin\views\access\Permission.
Permissions.php in core/modules/user/src/Plugin/views/filter/Permissions.php
Contains \Drupal\user\Plugin\views\filter\Permissions.
UserPermissionsForm.php in core/modules/user/src/Form/UserPermissionsForm.php
Contains \Drupal\user\Form\UserPermissionsForm.

File

core/modules/user/src/PermissionHandlerInterface.php, line 13
Contains \Drupal\user\PermissionHandlerInterface.

Namespace

Drupal\user
View source
interface PermissionHandlerInterface {

  /**
   * Gets all available permissions.
   *
   * @return array
   *   An array whose keys are permission names and whose corresponding values
   *   are arrays containing the following key-value pairs:
   *   - title: The human-readable name of the permission, to be shown on the
   *     permission administration page. This should be wrapped in the t()
   *     function so it can be translated.
   *   - description: (optional) A description of what the permission does. This
   *     should be wrapped in the t() function so it can be translated.
   *   - restrict access: (optional) A boolean which can be set to TRUE to
   *     indicate that site administrators should restrict access to this
   *     permission to trusted users. This should be used for permissions that
   *     have inherent security risks across a variety of potential use cases
   *     (for example, the "administer filters" and "bypass node access"
   *     permissions provided by Drupal core). When set to TRUE, a standard
   *     warning message defined in user_admin_permissions() will be displayed
   *     with the permission on the permission administration page. Defaults
   *     to FALSE.
   *   - warning: (optional) A translated warning message to display for this
   *     permission on the permission administration page. This warning
   *     overrides the automatic warning generated by 'restrict access' being
   *     set to TRUE. This should rarely be used, since it is important for all
   *     permissions to have a clear, consistent security warning that is the
   *     same across the site. Use the 'description' key instead to provide any
   *     information that is specific to the permission you are defining.
   *   - provider: (optional) The provider name of the permission.
   */
  public function getPermissions();

  /**
   * Determines whether a module provides some permissions.
   *
   * @param string $module_name
   *   The module name.
   *
   * @return bool
   *   Returns TRUE if the module provides some permissions, otherwise FALSE.
   */
  public function moduleProvidesPermissions($module_name);

}

Members

Namesort descending Modifiers Type Description Overrides
PermissionHandlerInterface::getPermissions public function Gets all available permissions. 1
PermissionHandlerInterface::moduleProvidesPermissions public function Determines whether a module provides some permissions. 1