You are here

Home » API reference » Domain Menus for Domains 3.x

README.txt in Domain Menus for Domains 3.x

Same filename and directory in other branches
  1. 9.x README.txt
  2. 9.1.x README.txt
Allow menus to have domain assignment so that menu and menu link administration can be linked to domain access.

The module intention is to allow each domain to have its own set of menus like a main menu or footer menu to be administered by users with administrative permissions limited to specific domains.

Feature summary:
 * Menus can be assigned to domains
 * Configurable number of domain menu sets
 * Bulk create and delete option
 * Auto-create/auto-delete domain menus on domain create/delete
 * Active domain domain menus block

Installation:
Enable module as usual.
Then go to [admin/config/domain/domain_menus] to setup menu names and bulk create domain menus.
Checking "Create menus" and saving configuration will bulk create domain menus, one for each menu name and for each domain.

Permissions:
Users with 'Administer all domain records' can access Domain Menus settings [admin/config/domain/domain_menus].

Users with 'Administer menus and menu options' permission can edit any domain menus.

After that, Domain Menus provides two role-assignable permissions:
 1. Edit active domain menus
 2. Edit assigned domain menus

'Edit active domain menus' allows a user to edit domain menus for only the active domain. The [admin/structure/domain-menus] page will only display the active domain menus.

'Edit assigned domain menus' allows a user to edit domain menus for all domains of which the user has domain access assignment. The [admin/structure/domain-menus] page will display all the domain menus of which the user has domain access assignment.

In either permission the user must have domain access assignment as indicated by the "Domain Access" field on the Add/edit user page.

Additional information:
Users with 'Administer menus and menu options' can freely alter domain assignment of menus on the add/edit menu page. However, this is not recommended unless there's a use-case for two or more domains and its admin users to have a common menu. The assumption is that if there's a global menu it would use higher level menu permissions instead of domain permissions.

Warning:
Domain Menus creates menus with machine names like "dm[number]-[string]", eg. dm1234567-main. 
Avoid weird problems by not machine naming any other menus in such a pattern!

File

README.txt
View source 
  1. Allow menus to have domain assignment so that menu and menu link administration can be linked to domain access.

  2. 

  3. The module intention is to allow each domain to have its own set of menus like a main menu or footer menu to be administered by users with administrative permissions limited to specific domains.

  4. 

  5. Feature summary:

  6.  * Menus can be assigned to domains

  7.  * Configurable number of domain menu sets

  8.  * Bulk create and delete option

  9.  * Auto-create/auto-delete domain menus on domain create/delete

  10.  * Active domain domain menus block

  11. 

  12. Installation:

  13. Enable module as usual.

  14. Then go to [admin/config/domain/domain_menus] to setup menu names and bulk create domain menus.

  15. Checking "Create menus" and saving configuration will bulk create domain menus, one for each menu name and for each domain.

  16. 

  17. Permissions:

  18. Users with 'Administer all domain records' can access Domain Menus settings [admin/config/domain/domain_menus].

  19. 

  20. Users with 'Administer menus and menu options' permission can edit any domain menus.

  21. 

  22. After that, Domain Menus provides two role-assignable permissions:

  23.  1. Edit active domain menus

  24.  2. Edit assigned domain menus

  25. 

  26. 'Edit active domain menus' allows a user to edit domain menus for only the active domain. The [admin/structure/domain-menus] page will only display the active domain menus.

  27. 

  28. 'Edit assigned domain menus' allows a user to edit domain menus for all domains of which the user has domain access assignment. The [admin/structure/domain-menus] page will display all the domain menus of which the user has domain access assignment.

  29. 

  30. In either permission the user must have domain access assignment as indicated by the "Domain Access" field on the Add/edit user page.

  31. 

  32. Additional information:

  33. Users with 'Administer menus and menu options' can freely alter domain assignment of menus on the add/edit menu page. However, this is not recommended unless there's a use-case for two or more domains and its admin users to have a common menu. The assumption is that if there's a global menu it would use higher level menu permissions instead of domain permissions.

  34. 

  35. Warning:

  36. Domain Menus creates menus with machine names like "dm[number]-[string]", eg. dm1234567-main. 

  37. Avoid weird problems by not machine naming any other menus in such a pattern!