From 720667d914e76ece742a469b0d8e54c00b0b6eca Mon Sep 17 00:00:00 2001
From: nacin <nacin@1a063a9b-81f0-0310-95a4-ce76da25c4cd>
Date: Thu, 27 May 2010 23:10:26 +0000
Subject: [PATCH] Users help. props dragoonis. see #13467.

git-svn-id: http://svn.automattic.com/wordpress/trunk@15011 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-admin/user-edit.php | 13 +++++++++++++
 wp-admin/user-new.php  | 17 +++++++++++++++++
 wp-admin/users.php     | 11 +++++++++++
 3 files changed, 41 insertions(+)

diff --git a/wp-admin/user-edit.php b/wp-admin/user-edit.php
index 368437aa39..2aae64b60f 100644
--- a/wp-admin/user-edit.php
+++ b/wp-admin/user-edit.php
@@ -33,6 +33,19 @@ else
 	$submenu_file = 'profile.php';
 $parent_file = 'users.php';
 
+// contextual help - choose Help on the top right of admin panel to preview this.
+add_contextual_help($current_screen,
+    '<p>' . __('Your profile contains information about you (your "account") as well as some personal options related to using WordPress.') . '</p>' .
+    '<p>' . __('You can change your password, turn on keyboard shortcuts, change the color scheme of your WordPress administration screens, and turn off the WYSIWYG (Visual) editor, among other things.') . '</p>' . 
+    '<p>' . __('Your username cannot be changed, but you can use other fields to enter your real name or a nickname, and change which name to display on your posts.') . '</p>' .
+    '<p>' . __('Required fields are indicated; the rest are optional. Profile information will only be displayed if your theme is set up to do so.') . '</p>' .
+    '<p>' . __('Remember to click the Update Profile button when you are finished.') . '</p>' . 
+    '<p><strong>' . __('For more information:') . '</strong></p>' . 
+    '<p>' . __('<a target="_blank" href="http://codex.wordpress.org/Users_Your_Profile_SubPanel">User Profile</a>') . '</p>' .
+    '<p>' . __('<a target="_blank" href="http://wordpress.org/support/">Support Forums</a>') . '</p>' 
+);
+
+
 $wp_http_referer = remove_query_arg(array('update', 'delete_count'), stripslashes($wp_http_referer));
 
 $all_post_caps = array('posts', 'pages');
diff --git a/wp-admin/user-new.php b/wp-admin/user-new.php
index 9486241013..3663110f62 100644
--- a/wp-admin/user-new.php
+++ b/wp-admin/user-new.php
@@ -108,6 +108,23 @@ if ( isset($_REQUEST['action']) && 'adduser' == $_REQUEST['action'] ) {
 $title = __('Add New User');
 $parent_file = 'users.php';
 
+add_contextual_help($current_screen, 
+    '<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>' . 
+    '<ul style="list-style: inside;">' . 
+        '<li>' . __('Administrators have access to all the administration features') . '</li>' .
+        '<li>' . __('Editors can publish posts, manage posts as well as manage other people&#8217;s posts, etc.')  . '</li>' . 
+        '<li>' . __('Authors can publish and manage their own posts') . '</li>' .
+        '<li>' . __('Contributors can write and manage their posts but not publish posts or upload media files') . '</li>' . 
+        '<li>' . __('Subscribers can read comments/comment/receive newsletters, etc.') . '</li>' .  
+    '</ul>' .
+    '<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>' .
+    '<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 do not 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>' .
+    '<p><strong>' . __('For more information:') . '</strong></p>' .
+    '<p>' . __('<a target="_blank" href="http://codex.wordpress.org/Users_Add_New_SubPanel">Add New Users</a>') . '</p>' . 
+    '<p>' . __('<a target="_blank" href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 wp_enqueue_script('wp-ajax-response');
 wp_enqueue_script('user-profile');
 wp_enqueue_script('password-strength-meter');
diff --git a/wp-admin/users.php b/wp-admin/users.php
index 065a472c63..0c33290b75 100644
--- a/wp-admin/users.php
+++ b/wp-admin/users.php
@@ -18,6 +18,17 @@ if ( !current_user_can('list_users') )
 $title = __('Users');
 $parent_file = 'users.php';
 
+// contextual help - choose Help on the top right of admin panel to preview this.
+add_contextual_help($current_screen,
+    '<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 when they are logged in, based on their role.') . '</p>' .
+    '<p>' . __('You can customize the display of information on this screen as you can on other screens, by using the Screen Options tab and the on-screen filters.') . '</p>' . 
+    '<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 Appearance menu section.') . '</p>' . 
+    '<p><strong>' . __('For more information:') . '</strong></p>' .
+    '<p>' . __('<a target="_blank" href=http://codex.wordpress.org/Users_Authors_and_Users_SubPanel">Documentation on Authors and Users</a>') . '</p>' .
+    '<p>' . __('<a target="_blank" href="http://codex.wordpress.org/Roles_and_Capabilities">Roles and Capabilities Descriptions</a>') . '</p>' .
+    '<p>' . __('<a target="_blank" href="http://wordpress.org/support/">Support Forums</a>') . '</p>' 
+);
+
 $update = $doaction = '';
 if ( isset($_REQUEST['action']) )
 	$doaction = $_REQUEST['action'] ? $_REQUEST['action'] : $_REQUEST['action2'];