interface PermissionHandlerInterface

Same name in other branches
  1. 9 core/modules/user/src/PermissionHandlerInterface.php \Drupal\user\PermissionHandlerInterface
  2. 8.9.x core/modules/user/src/PermissionHandlerInterface.php \Drupal\user\PermissionHandlerInterface
  3. 11.x 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

8 files declare their use of PermissionHandlerInterface
EntityPermissionsForm.php in core/modules/user/src/Form/EntityPermissionsForm.php
EntityPermissionsFormTest.php in core/modules/user/tests/src/Unit/Form/EntityPermissionsFormTest.php
ModulesListForm.php in core/modules/system/src/Form/ModulesListForm.php
Permission.php in core/modules/user/src/Plugin/views/access/Permission.php
Permissions.php in core/modules/user/src/Plugin/views/filter/Permissions.php

... See full list

File

core/modules/user/src/PermissionHandlerInterface.php, line 8

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.
     *   - dependencies: (optional) An array of dependency entities used when
     *     building this permission, structured in the same way as the return
     *     of ConfigEntityInterface::calculateDependencies(). For example, if this
     *     permission was generated as effect of the existence of node type
     *     'article', then value of the dependency key is:
     *     @code
     *     'dependencies' => ['config' => ['node.type.article']]
     *     @endcode
     *     The module providing this permission doesn't have to be added as a
     *     dependency. It is automatically parsed, stored and retrieved from the
     *     'provider' key.
     *   - provider: The provider name of the permission. This is set
     *     automatically to the module that provides the permission.yml file.
     *
     * @see \Drupal\Core\Config\Entity\ConfigDependencyManager
     */
    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

Title Sort descending Modifiers Object type Summary
PermissionHandlerInterface::getPermissions public function Gets all available permissions.
PermissionHandlerInterface::moduleProvidesPermissions public function Determines whether a module provides some permissions.

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