WordPress.org

Make WordPress Core

Opened 3 years ago

Closed 3 years ago

#15314 closed task (blessed) (fixed)

Contextual Help for Network Admin

Reported by: PeteMall Owned by: andrea_r
Milestone: 3.1 Priority: normal
Severity: normal Version: 3.1
Component: Network Admin Keywords: has-patch i18n-change
Focuses: multisite Cc:

Description (last modified by PeteMall)

This is the master ticket for adding contextual help for the network admin screens. See #14435

The following screens are missing contextual help:

  • Network Dashboard
  • Sites
    • Add New
    • Edit Site
      • Info
      • Options
      • Users
      • Themes
  • Users
    • Add New

More to come...

Attachments (10)

15314.diff (13.3 KB) - added by andrea_r 3 years ago.
15314.2.patch (1.5 KB) - added by vegasgeek 3 years ago.
Update to site-themes.php
15314.3.patch (1.3 KB) - added by vegasgeek 3 years ago.
Update to site-options.php
15314.site-themes.diff (1.5 KB) - added by nacin 3 years ago.
Diff off trunk from vegasgeek
15314.site-options.diff (2.8 KB) - added by nacin 3 years ago.
Diff off trunk from vegasgeek
15314.5.diff (2.2 KB) - added by andrea_r 3 years ago.
15314.6.diff (2.2 KB) - added by andrea_r 3 years ago.
15314.7.patch (5.3 KB) - added by SergeyBiryukov 3 years ago.
Fixed one misprint, removed trailing whitespace.
15314.8.patch (1.2 KB) - added by SergeyBiryukov 3 years ago.
Improved wording.
other3tabs.patch (3.5 KB) - added by dougwrites 3 years ago.
Option for if we want all the tabs to say, "see the other tabs"

Download all attachments as: .zip

Change History (53)

comment:1 PeteMall3 years ago

  • Type changed from defect (bug) to task (blessed)

comment:2 PeteMall3 years ago

  • Owner set to andrea_r
  • Status changed from new to assigned

comment:3 nacin3 years ago

  • Milestone changed from Awaiting Review to 3.1

comment:4 andrea_r3 years ago

  • Cc andrea_r added

comment:5 PeteMall3 years ago

  • Description modified (diff)

andrea_r3 years ago

comment:7 andrea_r3 years ago

  • Keywords has-patch added; needs-patch removed

First pass.

vegasgeek3 years ago

Update to site-themes.php

comment:8 vegasgeek3 years ago

  • Cc john@… added

vegasgeek3 years ago

Update to site-options.php

comment:9 zeo3 years ago

Related to #15346, use "Documentation on X" instead of "X Documentation".

comment:10 dougwrites3 years ago

  • Cc heymrpro@… added

comment:11 nacin3 years ago

(In [16981]) Network Admin contextual help. props andrea_r (!), see #15314.

nacin3 years ago

Diff off trunk from vegasgeek

nacin3 years ago

Diff off trunk from vegasgeek

comment:12 nacin3 years ago

(In [16982]) Network admin contextual help edits. props vegasgeek, see #15314.

comment:13 nacin3 years ago

(In [16983]) Move to 'Documentation on XY' in the network admin. see #15314.

comment:14 nacin3 years ago

(In [16984]) Network Admin: Rename Options to Settings. Kick the tab to the end as well. see #15314.

comment:15 nacin3 years ago

(In [16985]) A few more s/site-options/site-settings/. see #15314.

comment:16 nacin3 years ago

  • Keywords needs-patch added; has-patch removed

Kicking this back to Andrea, so text, terminology, and Codex links can be updated as appropriate, as a lot has changed.

comment:17 nacin3 years ago

  • Component changed from Multisite to Network Admin

andrea_r3 years ago

comment:18 andrea_r3 years ago

  • Keywords has-patch i18n-change added; needs-patch removed

Last minor changes. Everything looks good.

andrea_r3 years ago

comment:19 andrea_r3 years ago

not manifesting users this time. ;)

comment:21 nacin3 years ago

  • Resolution set to fixed
  • Status changed from assigned to closed

(In [17015]) Final network admin help tweaks. props andrea_r, fixes #15314.

SergeyBiryukov3 years ago

Fixed one misprint, removed trailing whitespace.

comment:22 SergeyBiryukov3 years ago

Found one more misprint and some trailing whitespace, see the patch above.

comment:23 nacin3 years ago

(In [17037]) Network admin contextual help fixes. props SergeyBiryukov, fixes #15314.

comment:24 nacin3 years ago

Thanks!

SergeyBiryukov3 years ago

Improved wording.

comment:25 SergeyBiryukov3 years ago

Help on the Settings tab says “See the contextual help on the next tab”, however there are no more tabs. I've changed the string (see the patch). Or should we remove it?

comment:26 dougwrites3 years ago

The question now is whether we want all four tabs to say, "See the contextual help on the other tabs."?

comment:27 nacin3 years ago

We reordered them so we need to make sure the third tab (which used to be last) isn't missing the text.

comment:28 SergeyBiryukov3 years ago

The text is present on the third tab too. What is the best wording then?

dougwrites3 years ago

Option for if we want all the tabs to say, "see the other tabs"

comment:29 dougwrites3 years ago

@nacin: one advantage of having all four tabs say "see the other tabs" would be if they were ever reordered again with a different one last, that last one would still be accurate.

comment:30 dougwrites3 years ago

  • Resolution fixed deleted
  • Status changed from closed to reopened

We had a nice little discussion about this a few hours ago, but forgot to re-open the ticket. I think Sergey's latest patch is more necessary than mine, but both are very simple and, in my opinion, an improvement.

comment:31 nacin3 years ago

Patch is fine. Will handle in the morning.

Sent a note to wp-docs regarding Codex link changes. I think we're going to modify the network admin codex links using a new structure. That'll be the last thing before string freeze tomorrow.

comment:32 follow-up: nacin3 years ago

I'm just going to add the same help text across all four tabs.

comment:33 nacin3 years ago

Oops, wrong ticket reference: [17044]

comment:34 nacin3 years ago

(In [17045]) Move to what will be the new Network Admin Codex page URLs. see #15314.

comment:35 nacin3 years ago

(In [17046]) Network-specific language on the plugin and theme editor help tabs. props andrea_r, see #15314.

comment:36 in reply to: ↑ 32 SergeyBiryukov3 years ago

Replying to nacin:

I'm just going to add the same help text across all four tabs.

“See the other tabs” string is left on the Themes tab. I guess it should be removed for consistency.

comment:37 nacin3 years ago

(In [17051]) Remove old string. props SergeyBiryukov, see #15314.

comment:38 nacin3 years ago

What's left:

  • A new sentence on plugins.php (when in the network admin) that explains network activation/deactivation.

That's it.

comment:39 andrea_r3 years ago

What about something like, "Click the Netowrk activate link will activate the plugin on every site. plugin options will still need to be managed on a per-site basis." and the rest of those particulars & gotchas can be codexed.

comment:40 nacin3 years ago

Should there be a network-specific Codex article to link to in this instance?

Last edited 3 years ago by nacin (previous) (diff)

comment:41 andrea_r3 years ago

Now that I think of it yes. It may exist as a blurb somewhere, might not need a whole page.

comment:42 andrea_r3 years ago

The Users menu needs a line something like "To search for user details, input the full username, or partial text with a wildcard." If it's too late, we can codex it.

comment:43 PeteMall3 years ago

  • Resolution set to fixed
  • Status changed from reopened to closed

I'm marking this as fixed after talking to Ryan. Any other details can go in the codex.

Note: See TracTickets for help on using tickets.