Problem/Motivation

In the current version of the module, the user Navigation block situated at the bottom of the Navigation bar consists of a set of custom links defined in \Drupal\navigation\UserLazyBuilder::userOperationLinks. It is not using the "User account menu" or any other mechanism to allow a site admin to adjust the links presented within the block. @catch asked why we have this approach in the core MR (#3438895: Add the new Navigation to core as an Experimental module). Link to the specific, relevant comment:

https://git.drupalcode.org/project/drupal/-/merge_requests/7474#note_297387

It appears the current implementation has continued unchanged from early in the development lifecycle and the implementation hasn't been sufficiently scrutinized.

A couple of things would be different if we use the "User account menu". First, we would lose the "Edit profile" link. Second, the default label would be different. We currently have "View profile", core has "My account". Finally, the "User account menu" is often a user-facing menu whereas what navigation is trying to achieve would be different in many ways and may evolve differently from the "User account menu".

Proposed resolution

  • Create a new "Navigation user links" menu when installing the module
  • By default, use the same set of links in the new menu that are currently hardcoded
  • Use the new menu for the User Navigation block (\Drupal\navigation\Plugin\Block\NavigationUserBlock
  • Take care to mitigate any potential caching issues
  • Consider a fallback for the "Navigation user links" menu missing

Remaining tasks

Needs a FunctionalJavascript test.

User interface changes

Nothing visible. Only the underlying data structure / sources are changing.

API changes

None.

Data model changes

New "Navigatoin user links" menu is introduced on navigation module installation.

Release notes snippet

Issue fork drupal-3441576

Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

Comments

m4olivei created an issue. See original summary.

m4olivei’s picture

Issue summary: View changes
m4olivei’s picture

Issue summary: View changes
skaught’s picture

How User menu is made: User menu is provided by a Menu Plugin (YAML FORMAT)
https://git.drupalcode.org/project/drupal/-/blob/11.x/core/modules/user/...

user login/logout item:
https://git.drupalcode.org/project/drupal/-/blob/11.x/core/modules/user/...
items itself dynamically changes title & path. cache content 'user.roles:authenticated'


src/Plugin/NavigationBlock/UserNavigationBlock.php

#[NavigationBlock(
  id: 'user',
  admin_label: new TranslatableMarkup('User'),
)]

- We are providing our own placeable block but not placing it. which is why we see 2 user blocks 'Navigation blocks' admin (admin/config/user-interface/navigation-block)
- secondarily, we're using the same namespace 'user'. should be renamed to keep more separation for when a site may want to place the traditional list of 'Account Items'


Realization:
user.module itself provides the account links for toolbar (toolbar is not using User Menu links)
https://git.drupalcode.org/project/drupal/-/blob/11.x/core/modules/user/...
- in contrib: Gin Toolbar also provides for it's own user links.


- Navigation should have a listed dependency on User module. Catch is point to this loosely as we are using user routes.
catch’s picture

If this needs to be different to the user account menu that would normally be in the front end theme (brought up by @ckrina on the MR), then it might also be possible to define an additional menu like 'Navigation user links' so that they're separate - but that would still allow people to add an extra link or remove something if they want to.

ckrina’s picture

Issue tags: +stable blocker

Agreed. I missed the part about customizing the links. Tagging this as Stable Blocker.

ckrina’s picture

Project: Navigation » Drupal core
Version: 1.x-dev » 11.x-dev
Component: Code » navigation.module
aaronmchale’s picture

Having the "User account menu" and the user account links that appear in the toolbar being different does feel like a weird quirk, from a UX perspective I think using the "User account menu" and "modernizing" it makes a lot of sense. As noted, it also allows the user menu links in the toolbar to be customized, which is a win in my opinion. I think it would be weird if every other menu in the Navigation could be customized apart from the user links.

catch’s picture

There are sites that customize the user account menu links with links that they might not want in the navigation toolbar, however, if it's just a menu block in the layout, those sites could swap it out with a different menu block easily enough. So using the same block by default might be plenty?

aaronmchale’s picture

however, if it's just a menu block in the layout, those sites could swap it out with a different menu block easily enough. So using the same block by default might be plenty?

Agreed. We should think in terms of what's the most sensible default for the 80% use-case. As you say, they can always use a different menu on the front-end, or swap this one out for a different one in the navigation.

ckrina’s picture

plopesc’s picture

Issue tags: +Portland2024
plopesc’s picture

Adding #3443452: [PP-1] User menu block render array is cached per user as reference to deal with caching at user level issues.

My concern or question about how to integrate a menu here is because most of the links I think that could be added to this menu are user specific, like /user/XX/foo and I am not sure how we could handle routes like that from a menu.

Mostly thinking about menu links created from the UI by site admins, where it is not possible to indicate URL parameters.

Core's user routes provides shortcuts like /user or /user/edit that redirects to the user specific page, but that's something not all the contrib modules that provide user specific routes or views that use the user ID as parameter would support.

We could encourage the usage of modules like https://www.drupal.org/project/user_current_paths or https://www.drupal.org/project/me_redirect for this menu, though.

plopesc’s picture

Now that #3445993: Provide a NavigationLinkBlock Plugin and use Help as an usage example is closer and we are pushing again towards Navigation stability, I would like to make a proposal for this one:

  • Navigation would provide a Menu Navigation User Links, or a better name to be proposed
  • That Menu would include by default the same links we currently have hardcoded.
  • NavigationUserBlock class will give the ability to choose a menu to render as user links. By default we would use the Menu provided above
  • NavigationUserBlock would render by default the links from the menu stored in config. If empty, or the Menu does not exists, it would fallback to the hardcoded links we have now. In this way we will ensure that removing the menu will not lead to unexpected behaviors

Would this proposal cover all the previously mentioned needs?

catch’s picture

#14 looks good, with the slight caveat that I'm not sure about the fallback - could that be handled with validation maybe?

plopesc’s picture

Validation could be a good approach, and necessary.

My concern about validation-only approach is that selected menu could be removed from the system by accident, or deliberately, breaking the navigation. In that case, we might need to provide something.

If the concern is about cache, we could make it in a way where the block would not need to be cached per user, given that links in the fallback would be /user, /user/edit & /user/logout, which are not user-specific.

plopesc’s picture

Status: Active » Needs review

Once #3445993: Provide a NavigationLinkBlock Plugin and use Help as an usage example has been merged, started to work on this one.

Here is a brief summary of the approach taken to be validated.

  • Navigation provides a new menu navigation-user-links
  • This menu is locked, so it should not be deleted unless unlikely things happen
  • Navigation provides default links for the menu mentioned above (Same links we have now hardcoded)
  • NavigationUserBlock renders the menu, so new links could be added
  • To customize the Navigation, rendering the Username, JS is used to avoid caching issues. Small flickering that might need to be addressed.
  • If the Menu is removed for any reason, the navigation item fallbacks to a button that links to the user profile page

Please take a look and validate the approach before continue polishing and updating tests.

catch’s picture

Couple of small comments on the MR. More general thoughts here:

- I think an extra menu is a good idea, allows it to be customized separately from any visitor-facing user menu.

- the js looks fine to me (which doesn't mean much because I am bad at js), although I wonder if there's a way to do it using core's existing lazy builder/big pipe workflow without additional js, but... I've never tried to do that with a menu link. And also we could look at that in a follow-up since it wouldn't be a data model or API change at all, whereas the new menu itself feels very stable blocking.

The very minimal fallback added here seems fine.

plopesc’s picture

Tests are now green. We might need an extra FunctionalJavascript or Nightwatch test to validate the user name is replaced by JS successfully, but I would prefer to have the approval of the JS approach first.

finnsky made their first commit to this issue’s fork.

catch’s picture

One thing to check here - does the current implementation result in the render cache for this block caching per-route. If so, it would be good if we're able to avoid that. The main reasons for per-route caching are the active trail for expanded menu links and maybe the 'active' class.

finnsky’s picture

Status: Needs review » Needs work
finnsky’s picture

i fixed js but seems we need to care about reload again
https://gyazo.com/e1a88c9d32cbd215f97a11b6198d92b6

also keyboard search broken because button still has data-index-text="u". not sure it is critical. maybe we also need to move that functional out of twig to js

plopesc’s picture

Thank you for your review @catch.

Made a couple of small changes from your comments and answered to one of you MR questions.

One thing to check here - does the current implementation result in the render cache for this block caching per-route.

Checked at DB level and we are not introducing new items in the cache_render table related to this block.

m4olivei’s picture

This is looking great. Just noticed two really tiny things in the menu wording. I don't see any other issues left to deal with.

The JS looks OK to me.

Noticing that we're still set to Needs work here. Is there anything else left to do here @plopsec that I'm not seeing?

plopesc’s picture

Thank you for your review @m4olivei

It was still in NW because @finnsky noticed some possible issues with the markup and JS. Also, when the navigation is expanded a small glitch is perceived when the username replaces the "admin" label. I would like to know if there is any possibility to improve that behavior.

ckrina’s picture

Adding the "Drupal CMS release target" to see if we could hopefully get to it.

m4olivei’s picture

Status: Needs work » Needs review

This is ready for a re-revew. Summary of changes:

  • Merged latest 11.x
  • Fixed the issues noted by @finnsky around keyboard search. We now update data-index-text to match the dynamic usename
  • Changed the default text of "User" to "My Account" to better fit other places this kind of thing is needed. Updated test to match
  • Updated \Drupal\Tests\navigation\FunctionalJavascript\PerformanceTest. We're doing less isValid checks? I think this is a good thing.

I also considered @catch's comment from earlier. For the reasons he mentions, but also as a way to address the small flicker @plopesc noted.

the js looks fine to me (which doesn't mean much because I am bad at js), although I wonder if there's a way to do it using core's existing lazy builder/big pipe workflow without additional js, but... I've never tried to do that with a menu link. And also we could look at that in a follow-up since it wouldn't be a data model or API change at all, whereas the new menu itself feels very stable blocking.

The trouble is that, as far as I can tell, the title of a menu link needs to be a plain string. I tried to create a new Menu plugin (\Drupal\navigation\Plugin\Menu\MyAccountMenuLink) for use as the top level default menu link. My idea was to override \Drupal\Core\Menu\MenuLinkInterface::getTitle and return a render array like:

public function getTitle() {
  return [
    '#lazy_builder' => [
      'user.toolbar_link_builder:renderDisplayName',
      [],
    ],
    '#create_placeholder' => TRUE,
    '#lazy_builder_preview' => [
      // Add a line of whitespace to the placeholder to ensure the icon is
      // positioned in the same place it will be when the lazy loaded content
      // appears.
      '#markup' => ' ',
    ],
  ];
}

This borrows from this approach in user module. The nice thing about this if it worked, would be that BigPipe would take care of intelligently replacing the username without our own custom Javascript, and handling the no JS case well too.

However, it white screens the site. Per the docs on the interface, that method should return a string.

Ultimately I don' t think the flicker is that bad, so at the most, I'd suggest we handle that in a follow up.

m4olivei’s picture

Title: Investigate using the core "User account menu" in favor of custom Navigation Block for same » Add a new "Navigation user links" menu in favor of hardcoded links in NavigationUserBlock
Issue summary: View changes

Also, I realize the issue description doesn't accurately describe the latest developments on this issue. Here is a crack at revising it.

m4olivei’s picture

Issue summary: View changes

Added a functional javascript test.

catch’s picture

@m4olivei yeah menu link placeholder is tricky. I opened #3498922: Use a placeholder for the navigation user block to track the possibility, definitely shouldn't try to tackle it here (although thanks for trying, but I think that's enough to demonstrate that it's hard).

plopesc’s picture

Status: Needs review » Reviewed & tested by the community
  • Matt made a great job addressing the last feedback suggestions.
  • New FunctionalJavascript test has been added to ensure name replacement is working
  • MR is up to date with latest 11.x
  • A followup was created to try to address the menu link placeholder trickyness.

I think we're in a good position to mark it as RTBC.

needs-review-queue-bot’s picture

Status: Reviewed & tested by the community » Needs work
StatusFileSize
new90 bytes

The Needs Review Queue Bot tested this issue. It no longer applies to Drupal core. Therefore, this issue status is now "Needs work".

This does not mean that the patch necessarily needs to be re-rolled or the MR rebased. Read the Issue Summary, the issue tags and the latest discussion here to determine what needs to be done.

Consult the Drupal Contributor Guide to find step-by-step guides for working with issues.

plopesc’s picture

Status: Needs work » Reviewed & tested by the community

Back to RTBC once conflicts have been solved.

catch’s picture

Status: Reviewed & tested by the community » Needs work

Merge conflicts on the MR unfortunately.

plopesc’s picture

Status: Needs work » Reviewed & tested by the community

It's green again once conflicts have been solved :)

catch’s picture

Status: Reviewed & tested by the community » Needs work

Sorry it took me this long to realise this - because navigation is beta stability, we need a post update that creates the system.menu.navigation-user-links menu. Because it's beta, this doesn't need any test coverage, just the upgrade path and probably some manual testing would be good.

I was just thinking about how great it was that the MR doesn't need an upgrade path, then it hit me that it does :/

plopesc’s picture

Status: Needs work » Reviewed & tested by the community

Upgrade path added and moved back to RTBC.

catch’s picture

Status: Reviewed & tested by the community » Needs work

Pretty sure the update should be a post update, not a hook_update_N(), because it relies on the entity API. Also was it manually tested?

plopesc’s picture

Status: Needs work » Needs review

Upgrade path is now a post_update hook. Marking as Needs Review to get a valid manual review from the community.

oily made their first commit to this issue’s fork.

ironnuts’s picture

Issue summary: View changes
ironnuts’s picture

needs-review-queue-bot’s picture

Status: Needs review » Needs work
StatusFileSize
new90 bytes

The Needs Review Queue Bot tested this issue. It no longer applies to Drupal core. Therefore, this issue status is now "Needs work".

This does not mean that the patch necessarily needs to be re-rolled or the MR rebased. Read the Issue Summary, the issue tags and the latest discussion here to determine what needs to be done.

Consult the Drupal Contributor Guide to find step-by-step guides for working with issues.

plopesc’s picture

Status: Needs work » Needs review

MR updated. Back to Needs Review.

gxleano’s picture

Status: Needs review » Reviewed & tested by the community
StatusFileSize
new30.37 KB
new93.12 KB

Review steps

  1. Install Drupal 11.x
  2. Enable Navigation module
  3. Run drush updb

See evidences:

Update database
Update database

New user navigation link
New user navigation link

Everything works as expected ✅

Moving to RTBC.

catch’s picture

Updating issue credit, unfortunately this needs another rebase.

  • catch committed f77a485d on 11.x
    Issue #3441576 by plopesc, m4olivei, finnsky, catch, oily, gxleano,...
catch’s picture

Status: Reviewed & tested by the community » Fixed

Committed/pushed to 11.x, thanks!

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.