Network Help Text: An update + sites.php

On top of everything else, revising the Network Admin help text got kinda of got pushed to the side. I’m working this weekend to get a better handle on the project.

  1. On the tracking ticket, #23163, I incorporated changes from @raggedrobins in the patch for /network/index.php as previously discussed on make/docs. Note the initials notation in the patch name. I fully intend to get credit for contributors, whether they’re making patches or not. So we need to try to keep track of that.
  2. On that note, I’m almost finished with my tutorial for making Help Text patches in the make/docs handbook. Updates on that soon.
  3. I also took the opportunity today to start additionally working on the /network/sites.php (Sites) screen help text. The following is the first pass:

Before:

Tab: Overview

Add New takes you to the Add New Site screen. You can search for a site by Name, ID number, or IP address. Screen Options allows you to choose how many sites to display on one page.

This is the main table of all sites on this network. Switch between list and excerptExcerpt An excerpt is the description of the blog post or page that will by default show on the blog archive page, in search results (SERPs), and on social media. With an SEO plugin, the excerpt may also be in that plugin’s metabox. views by using the icons above the right side of the table.

Hovering over each site reveals seven options (three for the primary site):

  • An Edit link to a separate Edit Site screen.
  • Dashboard leads to the Dashboard for that site.
  • Deactivate, Archive, and Spam which lead to confirmation screens. These actions can be reversed later.
    Delete which is a permanent action after the confirmation screens.
  • Visit to go to the frontend site live.

The site ID is used internally, and is not shown on the front end of the site or to users/viewers.

Clicking on bold headings can re-sort this table.

After:

Tab: Overview

This area of the Administration Screens is used for managing the sites in your MultisiteMultisite Multisite is a WordPress feature which allows users to create a network of sites on a single WordPress installation. Available since WordPress version 3.0, Multisite is a continuation of WPMU or WordPress Multiuser project. WordPress MultiUser project was discontinued and its features were included into WordPress core.https://codex.wordpress.org/Create_A_Network. Network.

From here you can:

  • Add, modify or remove sites from your network
  • Search for sites in your network
  • Perform bulk actions on multiple sites at once

Tab: Site Management

The site management screen allows you to modify aspects of one or many of your sites at once.

Hovering over each site reveals seven options (three for the primary site):

  • Clicking Edit takes you to a multi-part settings screen for that site
  • Clicking Dashboard takes you to the Dashboard screen for that site
  • Clicking Deactivate, Archive, or Spam performs the specified action with a confirmation screen
  • Clicking Delete deletes a site from your network, following a confirmation screen
  • Clicking Visit takes you to the front-end view of the site

Going forward: It should be noted that from the Sites screen, there is also an ‘Add Site’ button in the admin menu and in the headerHeader The header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes.. Should that be covered in some way in the Overview tab?

#contextual-help, #network-admin, #site-management