You are here

Home » API reference » Permissions Lock 7

README.txt in Permissions Lock 7

Same filename and directory in other branches
  1. 8 README.txt
Description
-----------
This module provides the ability to have more fine-grained control over what users with the permission 'administer permissions' can configure.
You can decide which user roles will see a limited permissions table at admin/user/permissions, and who has unrestricted access to it.
The modules allows you to lock certain permissions and / or certain roles. This means that these permissions / roles will not be available for configuration to a user with limited permission configuration rights.

This module could be useful if you want to allow a client to control website permissions for relatively harmless things like posting comments, creating content, administering taxonomy etc..., 
but you don't want the client to have the opportunity to change permissions for things like Views, content types, themes, ...

Installation
------------
1) Place the module folder in your sites/all/modules folder
2) Activate the module via admin/build/modules

Configuration
-------------
1) Optionally, go to admin/user/permissions and configure the permissions:
   - 'manage permission locks': users with this permission set can decide which permissions will be locked for users with limited access to the permission settings.
   - 'manage permissions unrestricted': users without this permission will have no right to configure permissions that are locked, while users with this permission are not restricted.
2) Go to Admin > Users > Permissions and click the tab 'Lock permissions'.
3) On this configuration page, you can decide what users with limited permission configuration rights can and cannot configure.
   You can both choose to lock certain permissions from being configured, as well as disallowing the ability to modify permissions for one or more roles.
4) Users with the 'administer permissions' permission, but without the 'manage permissions unrestricted' permissions, will now see a limited set a of permissions / roles to configure permissions for, based on the 'Lock permissions' settings.

Using hook_permissions_lock
---------------------------
This module supports a hook that lets you set permission locks through other modules. This allows you to specify the lock settings through code rather than through the database.
This could be useful to avoid repetition or migration problems in your projects.

Usage example:

/**
 * Implementation of hook_permissions_lock().
 */
function <modulename>_permissions_lock($type) {
  switch ($type) {
    case 'permission':
      return array('use PHP for block visibility', 'select different theme', 'administer views'); // specify permissions
    break;
    case 'role':
      return array(1, 2); // specify role ids
    break;
  }
}

Author
------
Sven Decabooter (http://drupal.org/user/35369)
The author can be contacted for paid customizations of this module as well as Drupal consulting and development.

File

README.txt
View source 
  1. 

  2. Description

  3. -----------

  4. This module provides the ability to have more fine-grained control over what users with the permission 'administer permissions' can configure.

  5. You can decide which user roles will see a limited permissions table at admin/user/permissions, and who has unrestricted access to it.

  6. The modules allows you to lock certain permissions and / or certain roles. This means that these permissions / roles will not be available for configuration to a user with limited permission configuration rights.

  7. 

  8. This module could be useful if you want to allow a client to control website permissions for relatively harmless things like posting comments, creating content, administering taxonomy etc..., 

  9. but you don't want the client to have the opportunity to change permissions for things like Views, content types, themes, ...

  10. 

  11. Installation

  12. ------------

  13. 1) Place the module folder in your sites/all/modules folder

  14. 2) Activate the module via admin/build/modules

  15. 

  16. Configuration

  17. -------------

  18. 1) Optionally, go to admin/user/permissions and configure the permissions:

  19.    - 'manage permission locks': users with this permission set can decide which permissions will be locked for users with limited access to the permission settings.

  20.    - 'manage permissions unrestricted': users without this permission will have no right to configure permissions that are locked, while users with this permission are not restricted.

  21. 2) Go to Admin > Users > Permissions and click the tab 'Lock permissions'.

  22. 3) On this configuration page, you can decide what users with limited permission configuration rights can and cannot configure.

  23.    You can both choose to lock certain permissions from being configured, as well as disallowing the ability to modify permissions for one or more roles.

  24. 4) Users with the 'administer permissions' permission, but without the 'manage permissions unrestricted' permissions, will now see a limited set a of permissions / roles to configure permissions for, based on the 'Lock permissions' settings.

  25. 

  26. Using hook_permissions_lock

  27. ---------------------------

  28. This module supports a hook that lets you set permission locks through other modules. This allows you to specify the lock settings through code rather than through the database.

  29. This could be useful to avoid repetition or migration problems in your projects.

  30. 

  31. Usage example:

  32. 

  33. /**

  34.  * Implementation of hook_permissions_lock().

  35.  */

  36. function _permissions_lock($type) {

  37.   switch ($type) {

  38.     case 'permission':

  39.       return array('use PHP for block visibility', 'select different theme', 'administer views'); // specify permissions

  40.     break;

  41.     case 'role':

  42.       return array(1, 2); // specify role ids

  43.     break;

  44.   }

  45. }

  46. 

  47. Author

  48. ------

  49. Sven Decabooter (http://drupal.org/user/35369)

  50. The author can be contacted for paid customizations of this module as well as Drupal consulting and development.