3.6-Menus Help Text changes

[DrewAPicture]

Due to the substantial UI changes introduced via [23441] and [23453] in #23119, we'll need to rework certain parts of the Help Tabs on the menus screen.

[JustinSainton]

Related: #23573

[Ipstenu]

First pass with the basic changes, totally ripped from the interface as you add menus.

[Ipstenu]

Added a first pass... Something to start from at least.

[DrewAPicture]

Full pass, including @ipstenu's starter patch

[DrewAPicture]

23608.diff​ takes a full pass at the Menus help text. I did my best to incorporate as many of the existing strings as possible.

There's no doubt this should be trimmed down quite a bit, I just wanted to get it out there for the rest of the docs folks to pick over.

[ Tab: Overview ]

This screen is used for managing your custom navigation menus.

Menus can be assigned to locations defined by your theme, you can even use custom menus in conjunction with the Custom Menus widget on the Widgets screen. If your theme does not support the custom menus feature (the default themes, Twenty Thirteen and Twenty Twelve, do), you can learn about adding this support by following the Documentation link to the side.

From this screen you can:

• Create, edit, and delete menus
• Add, remove, or rearrange menu items in individual menus
• Assign menus to be used in specific theme locations

[ Tab: Add & Edit Menus ]

Use the menu management box at the top of the screen to add or select existing menus to edit.

• To create your first menu, either give your default menu a name then save by clicking ’Create Menu’ or following the steps to add a new menu.
• To create a new menu click the ’Add New’ button at the top of the screen. Give your menu a name, then click ’Create Menu’.
• To edit an existing menu, choose a menu from the drop down and click ’Select’.

Custom menus may contain links to pages, categories, custom links or other content types (use the Screen Options tab to decide which ones to show on the screen). If your theme includes more than one menu location, you can choose which custom menu to associate with each.

• Add menu items by selecting links from the boxes in the left column and clicking ’Add to Menu’.
• To rearrange items, drag and drop items with your mouse or use your keyboard. Drag or move a menu item a little to the right to make it a submenu.
• Delete a menu item by expanding it and clicking the Remove link.

[ Tab: Other Settings ]

In addition to the standard menu item settings, you can also set additional attributes for each menu item. Attributes like link target, CSS classes, link relationships and link descriptions can be enabled and disabled via the Screen Options tab.

You can find more information about additional menu item attributes by following the Documentation link to the side.

[JerrySarcastic]

How about this for Overview? Just some rearranging, but it made sense to me to put the reference to links below the list. Also added the bit calling menu items "tabs" since that is what I hear users call these all the time. Arguably this reference could be removed; it makes me ::shudder:: when I hear it too.

Tab: Overview

This screen is used for managing your custom navigation menus.

Menus can be assigned to locations defined by your WordPress theme, and you can even use custom menus in conjunction with the Custom Menus widget on the Widgets screen to add them to other areas of your site. From this screen you can:

• Create and manage custom menus
• Rearrange, add, or remove menu items or "tabs" in individual menus
• Assign you menus to specific locations within your theme

The WordPress default themes all provide support for custom menus. If your theme does have this support you can learn about adding custom menus to your site using the following documentation and support links.

[JerrySarcastic]

Changes to "Overview" help strings

[Ipstenu]

Okay a small shift/cut...

[ Tab: Overview ]

This screen is used for managing your custom navigation menus.

Menus can be assigned to locations defined by your theme, you can even use custom menus in conjunction with the Custom Menus widget on the Widgets screen. If your theme does not support the custom menus feature (the default themes, Twenty Thirteen and Twenty Twelve, do), you can learn about adding this support by following the Documentation link to the side.

Custom menus may contain links to pages, categories, custom links or other content types (use the Screen Options tab to decide which ones to show on the screen).

From this screen you can:

• Create, edit, and delete menus
• Add, remove, or rearrange menu items in individual menus
• Assign menus to be used in specific theme locations

---

That removes the whole middle paragraph from Tab: Add & Edit Menus so we can then break out add/edit with headers to differentiate.

[DrewAPicture]

A fresh start.

[DrewAPicture]

23608.3.diff​ is a restart. It's more succinct, yes, but also more plain-spoken and easier to follow.

With 23608.3:

[ Tab: Overview ]

This screen is used for managing your custom navigation menus.

Menus can be displayed in locations defined by your theme, even used in sidebars by adding a Custom Menus widget on the Widgets screen. If your theme does not support the custom menus feature (the default themes, Twenty Thirteen and Twenty Twelve, do), you can learn about adding this support by following the Documentation link to the side.

From this screen you can:

• Create, edit, and delete menus
• Add, organize, and modify individual menu items

[ Tab: Menu Management ]

The menu management box at the top of the screen is used to control which menu is active in the editor below.

• To edit an existing menu, choose a menu from the drop down and click Select.
• If you haven’t yet created any menus, click the ’create a new menu’ link or the Add New button to get started.

You can assign theme locations to individual menus by selecting the desired settings at the bottom of the menu editor. To assign menus to all theme locations at once, visit the Manage Locations tab at the top of the screen.

[ Tab: Editing Menus ]

Each custom menu may contain a unique mix of links to pages, categories, custom URLs or other content types. Menu links are added by selecting items from the expanding boxes in the left-hand column below.

• Add one or several items at once by selecting the checkbox next to each item and clicking Add to Menu
• To add a custom link, expand the Links section, enter a URL and link text, and click Add to Menu
• To reorganize menu items, drag and drop items with your mouse or use your keyboard. Drag or move a menu item a little to the right to make it a submenu
• Delete a menu item by expanding it and clicking the Remove link

Additional settings such as link target, CSS classes, link relationships, and link descriptions can be enabled and disabled via the Screen Options tab.

[DrewAPicture]

Small improvements

[DrewAPicture]

23608.4.diff​ adds some small improvements suggested by @lessbloat such as adding an inline link to the Widgets screen in the 'Overview' tab and adding a blurb about expanding menu items for editing.

[DrewAPicture]

I should note that after #23770 gets dropped in, I'll also add a blurb specifically for the Manage Locations tab that ticket is introducing.

[DrewAPicture]

Locations overview

[DrewAPicture]

23608.5.diff​ adds an Overview tab for the new Manage Locations tab introduced in #23770

[Tab: Overview ]

This screen is used for globally assigning menus to locations defined by your theme.

• To assign menus to one or more theme locations, select a menu from each location’s drop down. When you’re finished, click Save Changes
• To edit a menu currently assigned to a theme location, click the adjacent ’Edit’ link
• To add a new menu instead of assigning an existing one, click the ’Use new menu’ link. Your new menu will be automatically assigned to that theme location

[markjaquith]

In 23844:

Nav Menus help tab updates.

fixes #23608. props DrewAPicture, Ipstenu, JerrySarcastic.