Issue #3176742 by jhodgdon, eojthebrave: 9.1.x compatibility for User Guide -- menu links not items

(((Manage administrative menu,overview)))

(((Toolbar,overview)))

(((Contextual link,overview)))

(((Content menu entry,administrative menu)))

(((Structure menu entry,administrative menu)))

(((Appearance menu entry,administrative menu)))

(((Extend menu entry,administrative menu)))

(((Configuration menu entry,administrative menu)))

(((People menu entry,administrative menu)))

(((Reports menu entry,administrative menu)))

(((Help menu entry,administrative menu)))

(((Content menu link,administrative menu)))

(((Structure menu link,administrative menu)))

(((Appearance menu link,administrative menu)))

(((Extend menu link,administrative menu)))

(((Configuration menu link,administrative menu)))

(((People menu link,administrative menu)))

(((Reports menu link,administrative menu)))

(((Help menu link,administrative menu)))

==== Prerequisite knowledge

The toolbar provided by the core Toolbar module displays the _Manage_

administrative menu at the top or left side of the site, for users with

permission to see it. This menu provides access to all of the administrative

areas of the site. The menu entries will vary depending on which modules are

areas of the site. The menu links will vary depending on which modules are

active on your site and the permissions of the person viewing the menu; if you

install using the core Standard installation profile and have full

administrative permissions, the top-level entries are as follows:

administrative permissions, the top-level links are as follows:

// Top navigation bar on any admin page, with Manage menu showing.

image:images/config-overview-toolbar.png["Administrative menu in horizontal mode",width="100%"]

to _Structure_ > _Menus_ (_admin/structure/menu_). Click _Translate_ in the

dropdown button for the menu whose name you want to translate.

** Menu items within a menu are considered to be content (not configuration);

** Menu links within a menu are considered to be content (not configuration);

see <<language-content-config>> to enable translation. Once translation is

enabled, navigate in the _Manage_ administrative menu to _Structure_ > _Menus_

(_admin/structure/menu_). Click _Edit menu_ in the dropdown button for the menu

==== What is a menu?

Menus are a collection of links (menu items) used to navigate a website. The

Menus are a collection of links used to navigate a website. The

core Menu UI module provides an interface to control and customize the menu

system. Menus are primarily displayed as a hierarchical list of links. By

default, new menu items are placed inside a built-in menu labeled _Main

default, new menu links are placed inside a built-in menu labeled _Main

navigation_, but administrators can also create custom menus.

The core Standard installation profile contains five menus:

* Creating new custom menus.

* Adding new menu items.

* Adding new menu links.

* Reordering menu items by setting their "weight" or by dragging them into

* Reordering menu links by setting their "weight" or by dragging them into

place.

* Renaming menu items.

* Renaming menu links.

* Changing the link title (the tooltip that appears when you mouse over a menu

item).

link).

* Moving a menu item into a different menu by editing its _Parent_ property.

* Moving a menu link into a different menu by editing its _Parent link_

property.

A menu item will only be shown to a visitor if they have the rights to view the

page it links to. For example, the admin menu item is not shown to visitors who

A menu link will only be shown to a visitor if they have the rights to view the

page it links to. For example, the admin menu link is not shown to visitors who

are not logged in.

==== Related topics

|Menu link title |Title that will be displayed in the menu | About

|Description |Text that will be displayed when a visitor hovers over the link

  |History of the market

|Parent item |Location of the page in the menu hierarchy. For example,

|Parent link |Location of the page in the menu hierarchy. For example,

  if you choose _<Main navigation>_, the page will appear in the highest

  level of the navigation. By choosing another menu item as parent, you can

  level of the navigation. By choosing another menu link as parent, you can

  create a menu hierarchy of multiple levels. |<Main navigation>

|Weight|The order in which the page should appear in the menu (lower-weighted

  menu items will be shown before higher-weighted menu items) | -2

  menu links will be shown before higher-weighted menu links) | -2

|================================

+

--

=== Changing the Order of Navigation

[role="summary"]

How to reorder items in a menu.

How to reorder links in a menu.

(((Menu items,reordering)))

(((Navigation,changing the order of menu items)))

(((Menu links,reordering)))

(((Navigation,changing the order of menu links)))

==== Goal

Reorder the items in a menu.

Reorder the links in a menu.

==== Prerequisite knowledge

image:images/menu-reorder_menu_titles.png["List of menus on the site with 'Main navigation' highlighted",width="100%"]

--

. The _Edit menu_ page will display a list of each item in the menu you

. The _Edit menu_ page will display a list of each link in the menu you

chose (_Main navigation_).

+

--

// Menu links section of admin/structure/menu/manage/main.

image:images/menu-reorder_edit_menu.png["List of menus items under _Main navigation_"]

image:images/menu-reorder_edit_menu.png["List of menu links under _Main navigation_"]

--

. Drag the cross bar handles of menu items to change their order: Home, then

. Drag the cross bar handles of menu links to change their order: Home, then

About. As an alternative to dragging, you can click the _Show row weights_ link

at the top of the table and select numerical weights (menu items with lower or

at the top of the table and select numerical weights (menu links with lower or

more negative weights will be shown first).

+

--

// Menu links section of admin/structure/menu/manage/main, after

// changing the order.

image:images/menu-reorder_reorder.png["Reordered menu items with warning message about unsaved changes and the _Save_ button"]

image:images/menu-reorder_reorder.png["Reordered menu links with warning message about unsaved changes and the _Save_ button"]

--

. Click _Save_.

. The home page now displays the main navigation with the Home menu

item displayed first.

link displayed first.

+

--

// Header section of Home page with reordered menu items.

image:images/menu-reorder_final_order.png["Reordered menu items on the home page with 'Home' first and then 'About'"]

// Header section of Home page with reordered menu links.

image:images/menu-reorder_final_order.png["Reordered menu links on the home page with 'Home' first and then 'About'"]

--

==== Expand your understanding

Add a menu item called _Contact_, leading to the _/contact_ page, to your Main

Add a menu link called _Contact_, leading to the _/contact_ page, to your Main

navigation menu. The contact page is provided by the core Contact module; you

may want to edit its layout and fields (see <<structure-form-editing>>).