Help for multisite. props andrea_r, dougwrites, duck_. see #13467.

git-svn-id: http://svn.automattic.com/wordpress/trunk@15004 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-admin/ms-admin.php

@@ -18,6 +18,16 @@ if ( ! current_user_can( 'manage_network' ) )
 $title = __( 'Network Admin' );
 $parent_file = 'ms-admin.php';
 
+add_contextual_help($current_screen, 
+	'<p>' . __('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:') . '</p>' .
+	'<ul><li>' . __('Site Admin is now Super Admin (we highly encourage you to get yourself a cape!)') . '</li>' .
+	'<li>' . __('Blogs are now called Sites; Site is now called Network') . '</li></ul>' .
+	'<p>' . __('This screen provides the network administrator with links to the screens for Sites and Users to either create a new site or user, or to search existing users and sites. Those screens are also accessible through the left-hand navigation in the Super Admin section.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Super_Admin_Super_Admin_Menu">Network Admin Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 require_once( './admin-header.php' );
 
 $c_users = get_user_count();

wp-admin/ms-options.php

@@ -18,6 +18,21 @@ if ( ! current_user_can( 'manage_network_options' ) )
 $title = __( 'Network Options' );
 $parent_file = 'ms-admin.php';
 
+add_contextual_help($current_screen, 
+	'<p>' . __('This screen sets and changes options for the network as a whole. The first site is the main site in the network and network options are pulled from that original site&#8217;s options.') . '</p>' .
+	'<p>' . __('Operational settings has fields for the network&#8217;s name, admin email, and whether global terms will be disabled (the default) or maintained across all sites on the network.') . '</p>' .
+	'<p>' . __('Dashboard Site is an option to give a site to users who do not have a site on the system. Their default role is subscribed but that default can be changed. The Admin Notice Feed can provide a notice on all dashboards of the latest post via RSS or Atom, or provide no such notice if left blank.') . '</p>' .
+	'<p>' . __('Registration settings can disable/enable public signups. If you let others sign up for a site, install spam plugins. Spaces, not commas, should separate names banned as sites for this network.') . '</p>' .
+	'<p>' . __('New site settings are defaults applied when a new site is created in the network. These include welcome email for when a new site or user account is registered, and what&#8127;s put in the first post, page, comment, comment author, and comment URL.') . '</p>' .
+	'<p>' . __('Upload settings control the size of the uploaded files and the amount of available upload space for each site You can change the default value for specific sites when you edit a particular site. Allowed file types are also listed (space separated only).') . '</p>' .
+	'<p>' . __('Checkboxes for media upload buttons set which are shown in the visual editor. If unchecked, a generic upload button is still visible; other media types can still be uploaded if on the allowed file types list.') . '</p>' .
+	'<p>' . __('Menu setting enables/disables the plugin menus from appearing for non super admins, so that only super admins, not site admins, have access to activate plugins.') . '</p>' .
+	'<p>' . __('Super admins can no longer be added on the Options screen. You must now go to the list of existing users on Super Admin > Users and click on Username or the Edit hover link below that name. This goes to an Edit User page where you can check a box to grant super admin privileges.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Super_Admin_Options_SubPanel">Network Options Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 include( './admin-header.php' );
 
 if (isset($_GET['updated'])) {

wp-admin/ms-sites.php

@@ -18,6 +18,35 @@ if ( ! current_user_can( 'manage_sites' ) )
 $title = __( 'Sites' );
 $parent_file = 'ms-admin.php';
 
+if ( isset( $_GET['action'] ) && 'editblog' == $_GET['action'] ) {
+	add_contextual_help($current_screen, 
+		'<p>' . __('The network admin arrives at this screen to make choices for a given site by clicking on the Edit link on the Sites screen available to them in the Super Admin navigation menu.') . '</p>' .
+		'<p>' . __('This extensive list of options has five modules: Site Info, Site Options, allowing Site Themes for this given site, changing the Site User(s) roles and passwords for that site, Adding a new user, and Miscellaneous Site Actions (upload size limits).') . '</p>' .
+		'<p>' . __('Note that some fields in Site Options are grayed out and say Serialized Data. These are stored values in the database which you cannot change from here.') . '</p>' .
+		'<p><strong>' . __('For more information:') . '</strong></p>' .
+		'<p>' . __('<a href="http://codex.wordpress.org/Super_Admin_Sites_Edit_Site">Site Editing Documentation</a>') . '</p>' .
+		'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+	);
+} else {
+	add_contextual_help($current_screen, 
+		'<p>' . __('Add New takes you farther down on this same page. 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.') . '</p>' .
+		'<p>' . __('This is the main table of all sites on this network. Switch between list and excerpt views by using the icons above the right side of the table.') . '</p>' .
+		'<p>' . __('Hovering over each site reveals seven options (only three for the primary or originating site for the network):') . '</p>' .
+		'<ul><li>' . __('an Edit link to a separate Edit Site screen') . '</li>' .
+		'<li>' . __('Backend means the Dashboard for that site') . '</li>' .
+		'<li>' . __('Deactivate, Archive, and Spam which lead to confirmation screens. These actions can be reversed later by hover links attached to those sites in this table.') . '</li>' .
+		'<li>' . __('Delete which is a permanent action after the confirmations screen.') . '</li>' .
+		'<li>' . __('Visit to go the the frontend site live.') . '</li></ul>' .
+		'<p>' . __('The site ID is used internally, and not shown on the front end of the site or to users/viewers.') . '</p>' .
+		'<p>' . __('Clicking on bold settings can re-sort this table. The upper right icons switch between list and excerpt views.') . '</p>' .
+		'<p>' . __('Clicking on Add Site after filling out the address, title, and email adds that new site instantly to the network and this table. You may want to then click on the hover link to edit options for that site.') . '</p>' .
+		'<p>' . __('Make sure you do not add slashes or dots when you fill in the new site name. If the admin email for the new site does not exist in the database, a new user will also be created.') . '</p>' .
+		'<p><strong>' . __('For more information:') . '</strong></p>' .
+		'<p>' . __('<a href="http://codex.wordpress.org/Super_Admin_Sites_SubPanel">Sites Documentation</a>') . '</p>' .
+		'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+	);
+}
+
 wp_enqueue_script( 'admin-forms' );
 
 require_once( './admin-header.php' );

wp-admin/ms-themes.php

@@ -14,6 +14,16 @@ if ( ! current_user_can( 'manage_network_themes' ) )
 
 $title = __( 'Network Themes' );
 $parent_file = 'ms-admin.php';
+
+add_contextual_help($current_screen, 
+	'<p>' . __('This screen enables and disables the inclusion of themes available to choose in the Appearance menu for each site. It does not activate or deactivate which theme a site is currently using.') . '</p>' .
+	'<p>' . __('If the network admin disables a theme that is in use, it can still remain selected on that site. If another theme is chosen, the disabled theme will not appear in the site&#8217;s Appearance > Themes screen.') . '</p>' .
+	'<p>' . __('Themes can be enabled on a site by site basis by the network admin on the Edit Site screen you go to via the Edit hover link on the Sites screen.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Super_Admin_Themes_SubPanel">Network Themes Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 require_once( './admin-header.php' );
 
 if ( isset( $_GET['updated'] ) ) {

wp-admin/ms-upgrade-network.php

@@ -16,6 +16,16 @@ require_once( ABSPATH . WPINC . '/http.php' );
 
 $title = __( 'Update Network' );
 $parent_file = 'ms-admin.php';
+
+add_contextual_help($current_screen, 
+	'<p>' . __('Only use this screen once you have updated to a new version of WordPress through Dashboard > Updates. Clicking the Update Network button will step through each site in the network, five at a time, and make sure any database upgrades are applied.') . '</p>' .
+	'<p>' . __('If a version update to core has not happened, clicking this button won&#8217;t affect anything.') . '</p>' .
+	'<p>' . __('If this process fails for any reason, users logging in to their sites will force the same update.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Super_Admin_Update_SubPanel">Update Network Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 require_once('admin-header.php');
 
 if ( ! current_user_can( 'manage_network' ) )

wp-admin/ms-users.php

@@ -18,6 +18,20 @@ if ( ! current_user_can( 'manage_network_users' ) )
 $title = __( 'Users' );
 $parent_file = 'ms-admin.php';
 
+add_contextual_help($current_screen, 
+	'<p>' . __('This table shows all users across the network and the sites to which they are assigned.') . '</p>' .
+	'<p>' . __('Hover over any user on the list to make the edit links appear. The Edit link on the left will take you to his or her Edit User profile page; the Edit link on the right by any site name goes to an Edit Site screen for that site.') . '</p>' .
+	'<p>' . __('You can also go to the user&#8217;s profile page for by clicking on the individual Username.') . '</p>' .
+	'<p>' . __('You can sort the table by clicking on any of the bold headings and switch between list and excerpt views by using the icons in the upper right.') . '</p>' .
+	'<p>' . __('The bulk action will permanently delete selected users, or mark/unmark those selected as spam. Spam users will have posts removed and will be unable to sign up again with the same emails.') . '</p>' .
+	'<p>' . __('Add User will add that person to this table and send them an email.') . '</p>' .
+	'<p>' . __('Users who are signed up to the network without a site are added as subscribers to the main or primary dashboard site, giving them profile pages to manage their accounts. These users will only see Dashboard and My Sites in the main navigation until a site is created for them.') . '</p>' .
+	'<p>' . __('You can make an existing user an additional super admin by going to the Edit User profile page and checking the box to grant that privilege.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Super_Admin_Users_SubPanel">Network Users Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 wp_enqueue_script( 'admin-forms' );
 
 require_once( './admin-header.php' );

wp-admin/my-sites.php

@@ -37,6 +37,15 @@ if ( 'updateblogsettings' == $action && isset( $_POST['primary_blog'] ) ) {
 
 $title = __( 'My Sites' );
 $parent_file = 'index.php';
+
+add_contextual_help($current_screen, 
+	'<p>' . __('This screen shows an individual user all of their sites in this network, and also allows that user to set a primary site. He or she can use the links under each site to visit either the frontend or the dashboard for that site.') . '</p>' .
+	'<p>' . __('Up until WordPress version 3.0, what is now called a Multi-site Network had to be installed separately as WordPressMU (multiple user).') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Dashboard_My_Sites_SubPanel">My Sites Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 require_once( './admin-header.php' );
 
 if ( $updated ) { ?>

wp-admin/network.php

@@ -87,8 +87,18 @@ if ( ! network_domain_check() && ( ! defined( 'WP_ALLOW_MULTISITE' ) || ! WP_ALL
 $title = __( 'Create a Network of WordPress Sites' );
 $parent_file = 'tools.php';
 
-// @todo: Documentation?
+add_contextual_help($current_screen, 
-// add_contextual_help( $current_screen, ... );
+	'<p>' . __('This screen allows you to configure a network as having subdomains (site1.example.com) or subdirectories (example.com/site1). Subdomains require wildcard subdomains to be enabled in Apache and DNS records, if your host allows it.') . '</p>' .
+	'<p>' . __('Choose subdomains or subdirectories; this can only be switched afterwards by reconfiguring your install. Fill out the network details, and click install. If this does not work, you may have to add a wildcard DNS record (for subdomains) or change to another setting in Permalinks (for subdirectories).') . '</p>' .
+	'<p>' . __('The next screen for Network will give you individually-generated lines of code to add to your wp-config.php and .htaccess files. Make sure the settings of your FTP client make files starting with a dot visible, so that you can find .htaccess; you may have to create this file if it really is not there. Make backup copies of those two files.') . '</p>' .
+	'<p>' . __('Add a blogs.dir directory under /wp-content/ and add the designated lines of code to wp.config.php (just before /*...stop editing...*/) and .htaccess (replacing the existing text).') . '</p>' .
+	'<p>' . __('Refreshing your browser will take you to a screen with an archive of those added lines of code. A set of six links under Super Admin will appear at the top of the main left navigation menu. The multisite network is now enabled.') . '</p>' .
+	'<p>' . __('The choice of subdirectory sites is disabled if this setup is more than a month old because of permalink problems with &#8220;/blog/&#8221; from the main site. This disabling will be addressed soon in a future version.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Create_A_Network">General Network Creation Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Tools_Network_SubPanel">Tools > Network Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
 
 include( './admin-header.php' );
 ?>