We want to record experiences of people building contrib modules for Drupal 8 websites, where they have added to the structure of the admin menu. We would like to understand three things:

  1. What you added
  2. What that added menu did - did it manipulate content or config entities, for example?
  3. Why you added it where you did. == important!
  4. Was there anything about the current admin menu structure that prevented you placing the items where you really thought they should be

Okay - that was four things.

And the fifth thing is, if you have any images you can share, please do feel free to add them.

Do check the overall issue for more info.

Finally - the scope of this issue is to only add experiences of what menus you have added. We definitely don't want comments about other people's experiences here. We will open a further issue to work on that.

Comments

rachel_norfolk created an issue. See original summary.

rachel_norfolk’s picture

Issue tags: +DevDaysSeville
kristiaanvandeneynde’s picture

StatusFileSize
new15.65 KB
  1. A menu link to the Group configuration section
  2. It does not manipulate anything, merely add to the admin menu
  3. The Group module does more than just defining a new entity type or adding content; it takes the existing permission layer and adds a whole new level to it. Given this will affect the security of the website, I figured it would be too obscure when being split up into several screens under Structure, Content and Configuration.
  4. The current admin menu works rather well for modules that add a single entity type with a specific purpose. For more complex modules such as Group (and Commerce for example), it makes it hard to find the right admin pages.

See attached screenshot of what it looks like. I figured it was best suited to have it sit right next to People, as both People and Groups define access across the site.

roderik’s picture

Issue summary: View changes
StatusFileSize
new242.41 KB
new295.02 KB
new233.34 KB

Context: I maintain a module that does single-sign-on (via SAML): users log into your Drupal site through an external 'identity provider' rather than the user/password screen.

1. Added a link to the configuration screen, at At Configuration > People.
2. Site-wide configuration settings for site admins, to make the module work.
3. This seems like the best place because it is about managing users and the way they are created/manipulated.
4. Nothing prevented us from placing it where we wanted but there was some contention about the position: Someone rewrote the module and put it at Configuration > Web Services instead. (There is a point to this: the single sign-on login flow is redirecting users to an external service.) The consensus with the original maintainer was to move it back.

imiksu’s picture

So far, I haven't actually done D8 contrib just yet, but I think this can be answered also for custom module development also.

  1. Menu link to a configuration
  2. Manipulates the order of entities that is listed in frontpage (manual sort)
  3. Under admin/content as an action tab
  4. Not at this case, but we needed to be careful with the permissions that editors (what should access this menu item) would have sensible route to this configuration
ifrik’s picture

Problems with adding more granular permissions

Issue #1975064: Add more granular block content permissions is an example that by adding pages as tabs (tasks) on other pages makes it difficult to add appropriate permissions.
Adding a separate permission to edit existing Custom block content, means that users need to be able to access the Custom block library page. It's possible to add a permission for that, but users still won't see any navigation (menu item etc) to get to the page because for that they need the permission to administer blocks (to get to the Block layout page) and in order to see that they need access to the whole Structure and Configuration section.

Version: 8.4.x-dev » 8.5.x-dev

Drupal 8.4.0-alpha1 will be released the week of July 31, 2017, which means new developments and disruptive changes should now be targeted against the 8.5.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.5.x-dev » 8.6.x-dev

Drupal 8.5.0-alpha1 will be released the week of January 17, 2018, which means new developments and disruptive changes should now be targeted against the 8.6.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.6.x-dev » 8.7.x-dev

Drupal 8.6.0-alpha1 will be released the week of July 16, 2018, which means new developments and disruptive changes should now be targeted against the 8.7.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.7.x-dev » 8.8.x-dev

Drupal 8.7.0-alpha1 will be released the week of March 11, 2019, which means new developments and disruptive changes should now be targeted against the 8.8.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.8.x-dev » 8.9.x-dev

Drupal 8.8.0-alpha1 will be released the week of October 14th, 2019, which means new developments and disruptive changes should now be targeted against the 8.9.x-dev branch. (Any changes to 8.9.x will also be committed to 9.0.x in preparation for Drupal 9’s release, but some changes like significant feature additions will be deferred to 9.1.x.). For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Version: 8.9.x-dev » 9.1.x-dev

Drupal 8.9.0-beta1 was released on March 20, 2020. 8.9.x is the final, long-term support (LTS) minor release of Drupal 8, which means new developments and disruptive changes should now be targeted against the 9.1.x-dev branch. For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Version: 9.1.x-dev » 9.2.x-dev

Drupal 9.1.0-alpha1 will be released the week of October 19, 2020, which means new developments and disruptive changes should now be targeted for the 9.2.x-dev branch. For more information see the Drupal 9 minor version schedule and the Allowed changes during the Drupal 9 release cycle.

Version: 9.2.x-dev » 9.3.x-dev

Drupal 9.2.0-alpha1 will be released the week of May 3, 2021, which means new developments and disruptive changes should now be targeted for the 9.3.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.3.x-dev » 9.4.x-dev

Drupal 9.3.0-rc1 was released on November 26, 2021, which means new developments and disruptive changes should now be targeted for the 9.4.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.4.x-dev » 9.5.x-dev

Drupal 9.4.0-alpha1 was released on May 6, 2022, which means new developments and disruptive changes should now be targeted for the 9.5.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.5.x-dev » 10.1.x-dev

Drupal 9.5.0-beta2 and Drupal 10.0.0-beta2 were released on September 29, 2022, which means new developments and disruptive changes should now be targeted for the 10.1.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 10.1.x-dev » 11.x-dev

Drupal core is moving towards using a “main” branch. As an interim step, a new 11.x branch has been opened, as Drupal.org infrastructure cannot currently fully support a branch named main. New developments and disruptive changes should now be targeted for the 11.x branch, which currently accepts only minor-version allowed changes. For more information, see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

smustgrave’s picture

Status: Active » Postponed (maintainer needs more info)
Issue tags: +stale-issue-cleanup

Thank you for creating this issue to improve Drupal.

We are working to decide if this task is still relevant to a currently supported version of Drupal. There hasn't been any discussion here for over 8 years which suggests that this has either been implemented or is no longer relevant. Your thoughts on this will allow a decision to be made.

Since we need more information to move forward with this issue, the status is now Postponed (maintainer needs more info). If we don't receive additional information to help with the issue, it may be closed after three months.

Thanks!

Version: 11.x-dev » main

Drupal core is now using the main branch as the primary development branch. New developments and disruptive changes should now be targeted to the main branch.

Read more in the announcement.

smustgrave’s picture

Status: Postponed (maintainer needs more info) » Closed (outdated)

Since this was about gathering experience and there's been no follow up in 8 years think we are safe to close out. Am assigning credit to everyone.

Now that this issue is closed, review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, credit people who helped resolve this issue.