WordPress.org

Make WordPress Core

#23608 closed defect (bug) (fixed)

3.6-Menus Help Text changes

Reported by: DrewAPicture Owned by: markjaquith
Milestone: 3.6 Priority: normal
Severity: normal Version: 3.6
Component: Text Changes Keywords: 3.6-menus has-patch
Focuses: Cc:

Description

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.

Attachments (6)

23608.1.diff (1.2 KB) - added by Ipstenu 14 months ago.
First pass with the basic changes, totally ripped from the interface as you add menus.
23608.diff (5.5 KB) - added by DrewAPicture 14 months ago.
Full pass, including @ipstenu's starter patch
23608.2.diff (5.5 KB) - added by JerrySarcastic 14 months ago.
Changes to "Overview" help strings
23608.3.diff (5.2 KB) - added by DrewAPicture 13 months ago.
A fresh start.
23608.4.diff (5.4 KB) - added by DrewAPicture 13 months ago.
Small improvements
23608.5.diff (6.5 KB) - added by DrewAPicture 13 months ago.
Locations overview

Download all attachments as: .zip

Change History (18)

comment:2 jkudish14 months ago

  • Cc jkudish added

comment:3 JerrySarcastic14 months ago

  • Cc fittingsites@… added

Ipstenu14 months ago

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

comment:4 Ipstenu14 months ago

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

DrewAPicture14 months ago

Full pass, including @ipstenu's starter patch

comment:5 follow-ups: DrewAPicture14 months ago

  • Keywords has-patch docs-feedback added; needs-patch removed

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.

comment:6 in reply to: ↑ 5 JerrySarcastic14 months ago

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 theme, you can even use custom menus in conjunction with the Custom Menus widget on the Widgets screen. 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.

Version 0, edited 14 months ago by JerrySarcastic (next)

JerrySarcastic14 months ago

Changes to "Overview" help strings

comment:7 in reply to: ↑ 5 Ipstenu14 months ago

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.

DrewAPicture13 months ago

A fresh start.

comment:8 DrewAPicture13 months ago

  • Keywords docs-feedback removed

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.

Last edited 13 months ago by DrewAPicture (previous) (diff)

DrewAPicture13 months ago

Small improvements

comment:9 DrewAPicture13 months ago

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.

comment:10 DrewAPicture13 months ago

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.

DrewAPicture13 months ago

Locations overview

comment:11 DrewAPicture13 months ago

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

comment:12 markjaquith13 months ago

  • Owner set to markjaquith
  • Resolution set to fixed
  • Status changed from new to closed

In 23844:

Nav Menus help tab updates.

fixes #23608. props DrewAPicture, Ipstenu, JerrySarcastic.

Note: See TracTickets for help on using tickets.