You are here

README.txt in Menu Item Role Access 8.2

Same filename and directory in other branches
  1. 8 README.txt
Menu Item Role Access

INTRODUCTION
------------

Provides a the ability to restrict access to menu items by the users role

REQUIREMENTS
------------

This module requires the following modules to be installed:

 * menu_link_content
 * menu_ui

INSTALLATION
------------

 * Install as you would normally install a contributed Drupal module. See:
   https://www.drupal.org/docs/8/extending-drupal-8/installing-drupal-8-modules
   for further information.

CONFIGURATION
-------------

 * Go to the menu item you wish to restrict within the admin UI and select the 
   roles which should have access to the menu item.
 * Configuration options for the way menu_item_role_access behaves can be found
   at admin/config/menu-item-role-access

TROUBLESHOOTING
---------------

Trouble:
 * User see menu item, but his role not allowed for this menu item.
 * User don't see menu item, but his role allowed for this menu item.
Fix:
 By default, Drupal permissions are used (/admin/people/permissions).
 This means that menu item will be displayed for role that have view permissions, even if you set a limit for this menu item in "Menu Item Role".
 Also, the menu item will not be shown if the role does not have a Drupal permissions to view menu item.
 To fix this:
 - Navigate to admin/config/menu-item-role-access and press "Overwrite internal link target access check".
 - Clear the cache.
 - Enjoy.

MAINTAINERS
-----------

Current maintainers:
 * Liam Hiscock (LiamPower) - https://www.drupal.org/u/liampower

File

README.txt
View source
  1. Menu Item Role Access
  2. INTRODUCTION
  3. ------------
  4. Provides a the ability to restrict access to menu items by the users role
  5. REQUIREMENTS
  6. ------------
  7. This module requires the following modules to be installed:
  8. * menu_link_content
  9. * menu_ui
  10. INSTALLATION
  11. ------------
  12. * Install as you would normally install a contributed Drupal module. See:
  13. https://www.drupal.org/docs/8/extending-drupal-8/installing-drupal-8-modules
  14. for further information.
  15. CONFIGURATION
  16. -------------
  17. * Go to the menu item you wish to restrict within the admin UI and select the
  18. roles which should have access to the menu item.
  19. * Configuration options for the way menu_item_role_access behaves can be found
  20. at admin/config/menu-item-role-access
  21. TROUBLESHOOTING
  22. ---------------
  23. Trouble:
  24. * User see menu item, but his role not allowed for this menu item.
  25. * User don't see menu item, but his role allowed for this menu item.
  26. Fix:
  27. By default, Drupal permissions are used (/admin/people/permissions).
  28. This means that menu item will be displayed for role that have view permissions, even if you set a limit for this menu item in "Menu Item Role".
  29. Also, the menu item will not be shown if the role does not have a Drupal permissions to view menu item.
  30. To fix this:
  31. - Navigate to admin/config/menu-item-role-access and press "Overwrite internal link target access check".
  32. - Clear the cache.
  33. - Enjoy.
  34. MAINTAINERS
  35. -----------
  36. Current maintainers:
  37. * Liam Hiscock (LiamPower) - https://www.drupal.org/u/liampower