hook_perm

• Drupal 4.6
• Drupal 4.7
• Drupal 5
• Drupal 6
• Drupal 7

developer/hooks/core.php, line 1030

Versions

4.6 – 7

hook_perm()

Define user permissions.

This hook can supply permissions that the module defines, so that they can be selected on the user permissions page and used to restrict access to actions the module performs.

The permissions in the array do not need to be wrapped with the function t(), since the string extractor takes care of extracting permission names defined in the perm hook for translation.

Permissions are checked using user_access().

For a detailed usage example, see page_example.module.

Return value

An array of permissions strings.

Related topics

Hooks

Allow modules to interact with the Drupal core.

Code

<?php
function hook_perm() {
  return array('administer my module');
}
?>