<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" />
<title>[19509] trunk/wp-admin: Help tweaks for users, tools.</title>
</head>
<body>
<style type="text/css"><!--
#msg dl.meta { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dl.meta dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer, #logmsg { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fa0 solid; padding: 6px; }
#logmsg { background: #ffc; border: 1px #fa0 solid; padding: 1em 1em 0 1em; }
#logmsg p, #logmsg pre, #logmsg blockquote { margin: 0 0 1em 0; }
#logmsg p, #logmsg li, #logmsg dt, #logmsg dd { line-height: 14pt; }
#logmsg h1, #logmsg h2, #logmsg h3, #logmsg h4, #logmsg h5, #logmsg h6 { margin: .5em 0; }
#logmsg h1:first-child, #logmsg h2:first-child, #logmsg h3:first-child, #logmsg h4:first-child, #logmsg h5:first-child, #logmsg h6:first-child { margin-top: 0; }
#logmsg ul, #logmsg ol { padding: 0; list-style-position: inside; margin: 0 0 0 1em; }
#logmsg > ul, #logmsg > ol { margin-left: 0; margin: 0 0 1em 0; }
#logmsg pre { background: #eee; padding: 1em; }
#logmsg blockquote { border: 1px solid #fa0; border-left-width: 10px; padding: 1em 1em 0 1em; background: white;}
#logmsg dl { margin: 0; }
#logmsg dt { font-weight: bold; }
#logmsg dd { margin: 0; padding: 0 0 0.5em 0; }
#logmsg dd:before { content:'\00bb';}
#logmsg table { border-spacing: 0px; border-collapse: collapse; border-top: 4px solid #fa0; border-bottom: 1px solid #fa0; background: #fff; }
#logmsg table th { text-align: left; font-weight: normal; padding: 0.2em 0.5em; border-top: 1px dotted #fa0; }
#logmsg table td { text-align: right; border-top: 1px dotted #fa0; padding: 0.2em 0.5em; }
#logmsg table thead th { text-align: center; border-bottom: 1px solid #fa0; }
#logmsg table th.Corner { text-align: left; }
#logmsg hr { border: none 0; border-top: 2px dashed #fa0; height: 1px; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<div id="msg">
<dl class="meta">
<dt>Revision</dt> <dd><a href="http://core.trac.wordpress.org/changeset/19509">19509</a></dd>
<dt>Author</dt> <dd>nacin</dd>
<dt>Date</dt> <dd>2011-12-01 01:17:14 +0000 (Thu, 01 Dec 2011)</dd>
</dl>
<h3>Log Message</h3>
<pre>Help tweaks for users, tools. props jane, see <a href="http://core.trac.wordpress.org/ticket/19020">#19020</a>.</pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkwpadminexportphp">trunk/wp-admin/export.php</a></li>
<li><a href="#trunkwpadminimportphp">trunk/wp-admin/import.php</a></li>
<li><a href="#trunkwpadmintoolsphp">trunk/wp-admin/tools.php</a></li>
<li><a href="#trunkwpadminusereditphp">trunk/wp-admin/user-edit.php</a></li>
<li><a href="#trunkwpadminusernewphp">trunk/wp-admin/user-new.php</a></li>
<li><a href="#trunkwpadminusersphp">trunk/wp-admin/users.php</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkwpadminexportphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/export.php (19508 => 19509)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/export.php 2011-12-01 01:07:43 UTC (rev 19508)
+++ trunk/wp-admin/export.php 2011-12-01 01:17:14 UTC (rev 19509)
</span><span class="lines">@@ -39,8 +39,8 @@
</span><span class="cx"> add_action( 'admin_head', 'add_js' );
</span><span class="cx">
</span><span class="cx"> get_current_screen()->add_help_tab( array(
</span><del>- 'id' => 'export',
- 'title' => __('Export'),
</del><ins>+ 'id' => 'overview',
+ 'title' => __('Overview'),
</ins><span class="cx"> 'content' => '<p>' . __('You can export a file of your site&#8217;s content in order to import it into another installation or platform. The export file will be an XML file format called WXR. Posts, pages, comments, custom fields, categories, and tags can be included. You can choose for the WXR file to include only certain posts or pages by setting the dropdown filters to limit the export by category, author, date range by month, or publishing status.') . '</p>' .
</span><span class="cx"> '<p>' . __('Once generated, your WXR file can be imported by another WordPress site or by another blogging platform able to access this format.') . '</p>',
</span><span class="cx"> ) );
</span><span class="lines">@@ -125,7 +125,7 @@
</span><span class="cx">
</span><span class="cx"> <p><?php _e('When you click the button below WordPress will create an XML file for you to save to your computer.'); ?></p>
</span><span class="cx"> <p><?php _e('This format, which we call WordPress eXtended RSS or WXR, will contain your posts, pages, comments, custom fields, categories, and tags.'); ?></p>
</span><del>-<p><?php _e('Once you&#8217;ve saved the download file, you can use the Import function in another WordPress installation to import this site.'); ?></p>
</del><ins>+<p><?php _e('Once you&#8217;ve saved the download file, you can use the Import function in another WordPress installation to import the content from this site.'); ?></p>
</ins><span class="cx">
</span><span class="cx"> <h3><?php _e( 'Choose what to export' ); ?></h3>
</span><span class="cx"> <form action="" method="get" id="export-filters">
</span></span></pre></div>
<a id="trunkwpadminimportphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/import.php (19508 => 19509)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/import.php 2011-12-01 01:07:43 UTC (rev 19508)
+++ trunk/wp-admin/import.php 2011-12-01 01:17:14 UTC (rev 19509)
</span><span class="lines">@@ -17,8 +17,8 @@
</span><span class="cx"> $title = __('Import');
</span><span class="cx">
</span><span class="cx"> get_current_screen()->add_help_tab( array(
</span><del>- 'id' => 'import',
- 'title' => __('Import'),
</del><ins>+ 'id' => 'overview',
+ 'title' => __('Overview'),
</ins><span class="cx"> 'content' => '<p>' . __('This screen lists links to plugins to import data from blogging/content management platforms. Choose the platform you want to import from, and click Install Now when you are prompted in the popup window. If your platform is not listed, click the link to search the plugin directory for other importer plugins to see if there is one for your platform.') . '</p>' .
</span><span class="cx"> '<p>' . __('In previous versions of WordPress, all importers were built-in. They have been turned into plugins since most people only use them once or infrequently.') . '</p>',
</span><span class="cx"> ) );
</span><span class="lines">@@ -130,7 +130,7 @@
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> if ( current_user_can('install_plugins') )
</span><del>- echo '<p>' . sprintf( __('If the importer you need is not listed, <a href="%s">search the plugins directory</a> to see if an importer is available.'), esc_url( network_admin_url( 'plugin-install.php?tab=search&type=tag&s=importer' ) ) ) . '</p>';
</del><ins>+ echo '<p>' . sprintf( __('If the importer you need is not listed, <a href="%s">search the plugin directory</a> to see if an importer is available.'), esc_url( network_admin_url( 'plugin-install.php?tab=search&type=tag&s=importer' ) ) ) . '</p>';
</ins><span class="cx"> ?>
</span><span class="cx">
</span><span class="cx"> </div>
</span></span></pre></div>
<a id="trunkwpadmintoolsphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/tools.php (19508 => 19509)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/tools.php 2011-12-01 01:07:43 UTC (rev 19508)
+++ trunk/wp-admin/tools.php 2011-12-01 01:17:14 UTC (rev 19509)
</span><span class="lines">@@ -18,8 +18,9 @@
</span><span class="cx"> ) );
</span><span class="cx"> get_current_screen()->add_help_tab( array(
</span><span class="cx"> 'id' => 'converter',
</span><del>- 'title' => __('Categories Tags Converter'),
- 'content' => '<p>' . __('The &#8220;Use This&#8221; link for the Categories and Tags Converter will take you to the Import page, where that Converter is one of the plugins you can download. Once that plugin is installed, the link on this page takes you to a screen where you can choose to convert tags into categories or vice versa.') . '</p>',
</del><ins>+ 'title' => __('Categories and Tags Converter'),
+ 'content' => '<p>' . __('Categories have hierarchy, meaning that you can nest sub-categories. Tags do not have hierachy and cannot be nested. Sometimes people start out using one on their posts, then later realize that the other would work better for their content.' ) . '</p>' .
+ '<p>' . __( 'The Categories and Tags Converter link on this screen will take you to the Import screen, where that Converter is one of the plugins you can install. Once that plugin is installed, return to this screen and the link will take you to a screen where you can choose to convert tags into categories or vice versa.' ) . '</p>',
</ins><span class="cx"> ) );
</span><span class="cx">
</span><span class="cx"> get_current_screen()->set_help_sidebar(
</span><span class="lines">@@ -57,7 +58,7 @@
</span><span class="cx"> if ( current_user_can($cats->cap->manage_terms) || current_user_can($tags->cap->manage_terms) ) : ?>
</span><span class="cx"> <div class="tool-box">
</span><span class="cx"> <h3 class="title"><?php _e( 'Categories and Tags Converter' ) ?></h3>
</span><del>- <p><?php printf( __('<a href="%s">Use this</a> to convert categories to tags or tags to categories.'), 'import.php' ); ?></p>
</del><ins>+ <p><?php printf( __('If you want to convert your categories to tags (or vice versa), use the <a href="%s">Categories and Tags Converter</a> available from the Import screen.'), 'import.php' ); ?></p>
</ins><span class="cx"> </div>
</span><span class="cx"> <?php
</span><span class="cx"> endif;
</span></span></pre></div>
<a id="trunkwpadminusereditphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/user-edit.php (19508 => 19509)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/user-edit.php 2011-12-01 01:07:43 UTC (rev 19508)
+++ trunk/wp-admin/user-edit.php 2011-12-01 01:17:14 UTC (rev 19509)
</span><span class="lines">@@ -44,8 +44,8 @@
</span><span class="cx"> '<p>' . __('Remember to click the Update Profile button when you are finished.') . '</p>';
</span><span class="cx">
</span><span class="cx"> get_current_screen()->add_help_tab( array(
</span><del>- 'id' => 'your-profile',
- 'title' => __('Your Profile'),
</del><ins>+ 'id' => 'overview',
+ 'title' => __('Overview'),
</ins><span class="cx"> 'content' => $profile_help,
</span><span class="cx"> ) );
</span><span class="cx">
</span></span></pre></div>
<a id="trunkwpadminusernewphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/user-new.php (19508 => 19509)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/user-new.php 2011-12-01 01:07:43 UTC (rev 19508)
+++ trunk/wp-admin/user-new.php 2011-12-01 01:17:14 UTC (rev 19509)
</span><span class="lines">@@ -139,20 +139,35 @@
</span><span class="cx"> if ( is_multisite() && current_user_can('promote_users') && current_user_can('create_users') )
</span><span class="cx"> $do_both = true;
</span><span class="cx">
</span><ins>+$help = '<p>' . __('To add a new user to your site, fill in the form on this screen and click the Add New User button at the bottom.') . '</p>';
+
+if ( is_multisite() ) {
+ $help .= '<p>' . __('Because this is a multisite installation, you may add accounts that already exist on the Network by specifying a username or email, and defining a role. For more options, such as specifying a password, you have to be a Network Administrator and use the hover link under an existing user&#8217;s name to Edit the user profile under Network Admin > All Users.') . '</p>' .
+ '<p>' . __('New users will receive an email letting them know they&#8217;ve been added as a user for your site. This email will also contain their password. Check the box if you don&#8217;t want the user to recieve a welcome email.') . '</p>';
+} else {
+ $help .= '<p>' . __('You must assign a password to the new user, which they can change after logging in. The username, however, cannot be changed.') . '</p>' .
+ '<p>' . __('New users will receive an email letting them know they&#8217;ve been added as a user for your site. By default, this email will also contain their password. Uncheck the box if you don&#8217;t want the password to be included in the welcome email.') . '</p>';
+}
+
+$help .= '<p>' . __('Remember to click the Add New User button at the bottom of this screen when you are finished.') . '</p>';
+
</ins><span class="cx"> get_current_screen()->add_help_tab( array(
</span><del>-'id' => 'add-new-user',
-'title' => __('Adding New Users'),
-'content' => '<p>' . __('To add a new user to your site, fill in the form on this screen. If you&#8217;re not sure which role to assign, you can use the link below to review the different roles and their capabilities. Here is a basic overview of roles:') . '</p>' .
</del><ins>+ 'id' => 'overview',
+ 'title' => __('Overview'),
+ 'content' => $help,
+) );
+
+get_current_screen()->add_help_tab( array(
+'id' => 'user-roles',
+'title' => __('User Roles'),
+'content' => '<p>' . __('Here is a basic overview of the different user roles and the permissions associated with each one:') . '</p>' .
</ins><span class="cx"> '<ul>' .
</span><span class="cx"> '<li>' . __('Administrators have access to all the administration features.') . '</li>' .
</span><span class="cx"> '<li>' . __('Editors can publish posts, manage posts as well as manage other people&#8217;s posts, etc.') . '</li>' .
</span><del>- '<li>' . __('Authors can publish and manage their own posts.') . '</li>' .
</del><ins>+ '<li>' . __('Authors can publish and manage their own posts, and are able to upload files.') . '</li>' .
</ins><span class="cx"> '<li>' . __('Contributors can write and manage their posts but not publish posts or upload media files.') . '</li>' .
</span><del>- '<li>' . __('Subscribers can read comments/comment/receive newsletters, etc.') . '</li>' .
- '</ul>' .
- ( is_multisite() ? '<p>' . __('Because this is a multisite installation, you may add accounts that already exist on the Network by specifying a username or email, and defining a role. For more options, such as specifying a password, you have to be a Network Administrator and use the hover link under an existing user&#8217;s name to Edit the user profile under Network Admin > All Users.') . '</p>' : '<p>' . __('You must assign a password to the new user, but don&#8217;t worry; when they log in for the first time they will be prompted to change it. The username, however, cannot be changed.') . '</p>' ).
- ( is_multisite() ? '<p>' . __('New users will receive an email letting them know they&#8217;ve been added as a user for your site. This email will also contain their password. Check the box if you don&#8217;t want the user to recieve a welcome email.') . '</p>' : '<p>' . __('New users will receive an email letting them know they&#8217;ve been added as a user for your site. By default, this email will also contain their password. Uncheck the box if you don&#8217;t want the password to be included in the welcome email.') . '</p>' ) .
- '<p>' . __('Remember to click the Add User button at the bottom of this screen when you are finished.') . '</p>'
</del><ins>+ '<li>' . __('Subscribers can read comments/comment/receive newsletters, etc. but cannot create regular site content.') . '</li>' .
+ '</ul>'
</ins><span class="cx"> ) );
</span><span class="cx">
</span><span class="cx"> get_current_screen()->set_help_sidebar(
</span></span></pre></div>
<a id="trunkwpadminusersphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/users.php (19508 => 19509)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/users.php 2011-12-01 01:07:43 UTC (rev 19508)
+++ trunk/wp-admin/users.php 2011-12-01 01:17:14 UTC (rev 19509)
</span><span class="lines">@@ -21,15 +21,15 @@
</span><span class="cx">
</span><span class="cx"> // contextual help - choose Help on the top right of admin panel to preview this.
</span><span class="cx"> get_current_screen()->add_help_tab( array(
</span><del>- 'id' => 'screen-info',
- 'title' => __('Users List'),
</del><ins>+ 'id' => 'overview',
+ 'title' => __('Overview'),
</ins><span class="cx"> 'content' => '<p>' . __('This screen lists all the existing users for your site. Each user has one of five defined roles as set by the site admin: Site Administrator, Editor, Author, Contributor, or Subscriber. Users with roles other than Administrator will see fewer options in the dashboard navigation when they are logged in, based on their role.') . '</p>' .
</span><span class="cx"> '<p>' . __('To add a new user for your site, click the Add New button at the top of the screen or Add New in the Users menu section.') . '</p>'
</span><span class="cx"> ) ) ;
</span><span class="cx">
</span><span class="cx"> get_current_screen()->add_help_tab( array(
</span><del>- 'id' => 'customize-display',
- 'title' => __('Customizing This Display'),
</del><ins>+ 'id' => 'screen-display',
+ 'title' => __('Screen Display'),
</ins><span class="cx"> 'content' => '<p>' . __('You can customize the display of this screen in a number of ways:') . '</p>' .
</span><span class="cx"> '<ul>' .
</span><span class="cx"> '<li>' . __('You can hide/display columns based on your needs and decide how many users to list per screen using the Screen Options tab.') . '</li>' .
</span><span class="lines">@@ -38,16 +38,24 @@
</span><span class="cx"> '</ul>'
</span><span class="cx"> ) );
</span><span class="cx">
</span><ins>+$help = '<p>' . __('Hovering over a row in the users list will display action links that allow you to manage users. You can perform the following actions:') . '</p>' .
+ '<ul>' .
+ '<li>' . __('Edit takes you to the editable profile screen for that user. You can also reach that screen by clicking on the username.') . '</li>';
+
+if ( is_multisite() )
+ $help .= '<li>' . __( 'Remove allows you to remove a user from your site. It does not delete their posts. You can also remove multiple users at once by using Bulk Actions.' ) . '</li>';
+else
+ $help .= '<li>' . __( 'Delete brings you to the Delete Users screen for confirmation, where you can permanently remove a user from your site and delete their posts. You can also delete multiple users at once by using Bulk Actions.' ) . '</li>';
+
+$help .= '</ul>';
+
</ins><span class="cx"> get_current_screen()->add_help_tab( array(
</span><del>- 'id' => 'row-actions',
- 'title' => __('Action Links'),
- 'content' => '<p>' . __('Hovering over a row in the users list will display action links that allow you to manage users. You can perform the following actions:') . '</p>' .
- '<ul>' .
- '<li>' . __('Edit takes you to the editable profile screen for that user. You can also reach that screen by clicking on the username.') . '</li>' .
- ( is_multisite() ? '<li>' . __('Remove allows you to remove a user from your site. It does not delete their posts.') . '</li>' : '<li>' . __('Delete brings you to the Delete Users screen for confirmation, where you can permanently remove a user from your site and delete their posts.') . '</li>' ) .
- '</ul>'
</del><ins>+ 'id' => 'actions',
+ 'title' => __('Actions'),
+ 'content' => $help,
</ins><span class="cx"> ) );
</span><del>-
</del><ins>+unset( $help );
+
</ins><span class="cx"> get_current_screen()->set_help_sidebar(
</span><span class="cx"> '<p><strong>' . __('For more information:') . '</strong></p>' .
</span><span class="cx"> '<p>' . __('<a href="http://codex.wordpress.org/Users_Screen" target="_blank">Documentation on Managing Users</a>') . '</p>' .
</span></span></pre>
</div>
</div>
</body>
</html>