Network Admin – Make WordPress Documentation

Welcome to the official home of the WordPress Documentation Team.

This team is responsible for coordinating all documentation initiatives around WordPress, including the handbooks and other general wordsmithing across the WordPress project.

Want to get involved?

Start here to find out more about what we do and how to contribute:

Onboarding to Documentation Team: An overview of what we do and how to collaborate
Documentation Issue Tracker on GitHub: Submit any Documentation Team-related issues on GitHubGitHub GitHub is a website that offers online implementation of git repositories that can easily be shared, copied and modified by other developers. Public repositories are free to host, private repositories require a paid subscription. GitHub introduced the concept of the ‘pull request’ where code changes done in branches by contributors can be reviewed and discussed before being merged be the repository owner. https://github.com/

Weekly meetings

Join our discussions of documentation issues here on the blog and on Slack.

The documentation team holds weekly office hours and monthly Contributor Days on each Tuesday of the month in the #docs SlackSlack Slack is a Collaborative Group Chat Platform https://slack.com/. The WordPress community has its own Slack Channel at https://make.wordpress.org/chat/. channel. It’s also where you can contact the team at any time outside meetings.

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.

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.
On that note, I’m almost finished with my tutorial for making Help Text patches in the make/docs handbook. Updates on that soon.
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

I’ve submitted changes for the first set of text to be refreshed/rewritten in Network Admin on the tracking ticket: #23163

The hope is to maintain a balance between action and description text.

For the main Network Admin index I propose this initial draft. Feedback is encouraged!

Before:

Tab: Overview:

Until WordPress 3.0, running multiple sites required using WordPress MU instead of regular WordPress. In version 3.0, these applications have merged. If you are a former MU user, you should be aware of the following changes:

Site Admin is now Super Admin (we highly encourage you to get yourself a cape!).
Blogs are now called Sites; Site is now called Network.

The Right Now box provides the network administrator with links to the screens to either create a new site or user, or to search existing users and sites. Screens for Sites and Users are also accessible through the left-hand navigation in the Network Admin section.

After:

Tab: Overview:

Welcome to your Network Admin. This area of the Dashboard is used for managing all aspects of 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.

The menus on the left side allow you to:

Add and manage sites or users
Install and activate themes or plugins
Update your network
Modify global network settings

Tab: Quick Tasks:

The Right Now widgetWidget A WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget-ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user. on this screen provides current user and site counts on your network. New users and sites are easily created by clicking the ‘Create a New Site’ or ‘Create a New User’ links.

You can also search for any user or site in your network by using the search boxes. Users can be searched by entering all or part of a username or email address. Sites are searchable by path or domain, depending on which type of network you have.

#contextual-help, #multisite, #network-admin

Want to get involved?

Weekly meetings

Tag Archives: Network Admin

Network Help Text: An update + sites.php

Got the ball rolling on Network Admin help text