From 268c7cdd7132bbfea9578fe393713f3891f0556a Mon Sep 17 00:00:00 2001
From: azaozz <azaozz@1a063a9b-81f0-0310-95a4-ce76da25c4cd>
Date: Thu, 6 Nov 2008 08:13:50 +0000
Subject: [PATCH] Help tab

git-svn-id: http://svn.automattic.com/wordpress/trunk@9545 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-admin/categories.php           |  2 +-
 wp-admin/edit-comments.php        |  2 +-
 wp-admin/edit-form-advanced.php   |  3 +-
 wp-admin/edit-link-categories.php |  2 +-
 wp-admin/edit-link-form.php       |  2 +-
 wp-admin/edit-page-form.php       |  2 +-
 wp-admin/edit-pages.php           |  2 +-
 wp-admin/edit-tags.php            |  2 +-
 wp-admin/edit.php                 |  2 +-
 wp-admin/includes/template.php    | 62 ++++++++++++++++++++++++++++---
 wp-admin/index.php                |  2 +-
 wp-admin/js/settings-box.js       | 19 +++++++++-
 wp-admin/link-manager.php         |  2 +-
 wp-admin/upload.php               |  2 +-
 wp-admin/users.php                |  2 +-
 wp-admin/wp-admin.css             | 42 +++++++++++++--------
 16 files changed, 113 insertions(+), 37 deletions(-)

diff --git a/wp-admin/categories.php b/wp-admin/categories.php
index f821ed517f..0803ea5c27 100644
--- a/wp-admin/categories.php
+++ b/wp-admin/categories.php
@@ -131,7 +131,7 @@ $messages[4] = __('Category not added.');
 $messages[5] = __('Category not updated.');
 ?>
 
-<?php screen_options('category') ?>
+<?php screen_meta('category') ?>
 
 <div class="wrap nosubsub">
 <h2><?php echo wp_specialchars( $title ); ?></h2> 
diff --git a/wp-admin/edit-comments.php b/wp-admin/edit-comments.php
index 5556e67994..091da30e8d 100644
--- a/wp-admin/edit-comments.php
+++ b/wp-admin/edit-comments.php
@@ -81,7 +81,7 @@ $post_id = isset($_GET['p']) ? (int) $_GET['p'] : 0;
 $search_dirty = ( isset($_GET['s']) ) ? $_GET['s'] : '';
 $search = attribute_escape( $search_dirty ); ?>
 
-<?php screen_options('comment') ?>
+<?php screen_meta('comment') ?>
 
 <div class="wrap">
 <h2><?php echo wp_specialchars( $title ); ?></h2>
diff --git a/wp-admin/edit-form-advanced.php b/wp-admin/edit-form-advanced.php
index f97e70b974..48ce303c9d 100644
--- a/wp-admin/edit-form-advanced.php
+++ b/wp-admin/edit-form-advanced.php
@@ -471,8 +471,7 @@ add_meta_box('revisionsdiv', __('Post Revisions'), 'post_revisions_meta_box', 'p
 endif;
 
 ?>
-
-<?php screen_options('post', 1) ?>
+<?php screen_meta('post', 1, 'edit-post'); ?>
 
 <?php if ( (isset($mode) && 'bookmarklet' == $mode) || isset($_GET['popupurl']) ): ?>
 <input type="hidden" name="mode" value="bookmarklet" />
diff --git a/wp-admin/edit-link-categories.php b/wp-admin/edit-link-categories.php
index 10a274d2ee..25aa95871e 100644
--- a/wp-admin/edit-link-categories.php
+++ b/wp-admin/edit-link-categories.php
@@ -60,7 +60,7 @@ $messages[4] = __('Category not added.');
 $messages[5] = __('Category not updated.');
 $messages[6] = __('Categories deleted.'); ?>
 
-<?php screen_options('link-category') ?>
+<?php screen_meta('link-category') ?>
 
 <div class="wrap nosubsub">
 <h2><?php echo wp_specialchars( $title ); ?></h2> 
diff --git a/wp-admin/edit-link-form.php b/wp-admin/edit-link-form.php
index 6a84c2750a..e4399e5b98 100644
--- a/wp-admin/edit-link-form.php
+++ b/wp-admin/edit-link-form.php
@@ -309,7 +309,7 @@ function link_advanced_meta_box($link) {
 }
 add_meta_box('linkadvanceddiv', __('Advanced'), 'link_advanced_meta_box', 'link', 'normal', 'core'); ?>
 
-<?php screen_options('link', 1) ?>
+<?php screen_meta('link', 1) ?>
 
 <div class="wrap">
 <h2><?php echo wp_specialchars( $title ); ?></h2> 
diff --git a/wp-admin/edit-page-form.php b/wp-admin/edit-page-form.php
index 573d805f05..be51e5f01c 100644
--- a/wp-admin/edit-page-form.php
+++ b/wp-admin/edit-page-form.php
@@ -376,7 +376,7 @@ add_meta_box('revisionsdiv', __('Page Revisions'), 'page_revisions_meta_box', 'p
 endif;
 ?>
 
-<?php screen_options('page', 1); ?>
+<?php screen_meta('page', 1); ?>
 
 <div class="wrap">
 <h2><?php echo wp_specialchars( $title ); ?></h2> 
diff --git a/wp-admin/edit-pages.php b/wp-admin/edit-pages.php
index 302bf8bcee..17d0e90026 100644
--- a/wp-admin/edit-pages.php
+++ b/wp-admin/edit-pages.php
@@ -100,7 +100,7 @@ if ( is_singular() ) {
 
 require_once('admin-header.php'); ?>
 
-<?php screen_options('page') ?>
+<?php screen_meta('page') ?>
 
 <div class="wrap">
 <h2><?php echo wp_specialchars( $title ); ?></h2>
diff --git a/wp-admin/edit-tags.php b/wp-admin/edit-tags.php
index 526b41b95e..02bc1e19a0 100644
--- a/wp-admin/edit-tags.php
+++ b/wp-admin/edit-tags.php
@@ -129,7 +129,7 @@ $messages[4] = __('Tag not added.');
 $messages[5] = __('Tag not updated.');
 $messages[6] = __('Tags deleted.'); ?>
 
-<?php screen_options('tag') ?>
+<?php screen_meta('tag') ?>
 
 <div class="wrap nosubsub">
 <h2><?php echo wp_specialchars( $title ); ?></h2> 
diff --git a/wp-admin/edit.php b/wp-admin/edit.php
index f7a8ae443e..021c31359f 100644
--- a/wp-admin/edit.php
+++ b/wp-admin/edit.php
@@ -90,7 +90,7 @@ if ( empty($_GET['mode']) )
 else
 	$mode = attribute_escape($_GET['mode']); ?>
 
-<?php screen_options('post') ?>
+<?php screen_meta('post') ?>
 
 <div class="wrap">
 <h2><?php echo wp_specialchars( $title ); ?></h2>
diff --git a/wp-admin/includes/template.php b/wp-admin/includes/template.php
index 9b3cb8d803..25c7f1e50f 100644
--- a/wp-admin/includes/template.php
+++ b/wp-admin/includes/template.php
@@ -3122,10 +3122,10 @@ function _post_states($post) {
 	}
 }
 
-function screen_options($screen, $metabox = false) {
+function screen_meta($screen, $metabox = false, $page = '') {
 ?>
-<div id="screen-options">
-	<div id="screen-options-wrap" class="hidden">
+<div id="screen-meta">
+<div id="screen-options-wrap" class="hidden">
 	<h5><?php _e('Show on screen') ?></h5>
 	<form id="adv-settings" action="" method="get">
 	<div class="metabox-prefs">
@@ -3139,13 +3139,63 @@ function screen_options($screen, $metabox = false) {
 ?>
 	<br class="clear" />
 	</div></form>
-	</div>
+</div>
 
-	<div id="screen-options-link-wrap" class="hide-if-no-js screen-options-closed">
-	<a href="#screen-options" id="show-settings-link" class="show-settings"><?php _e('Screen Options') ?></a>
+<?php
+	if ( '' != $page ) {
+// Allow a plugin to short-circuit
+		$help = apply_filters('contextual_help', '', $page);
+		if ( !empty($help) )
+			return;
+	
+		global $title;
+	
+		$help['edit-post'] =  __('<a href="http://codex.wordpress.org/Writing_Posts">Writing Posts</a>');
+		$help['general-settings'] =  __('<a href="http://codex.wordpress.org/Settings_General_SubPanel">General Settings</a>');
+	?>
+	<div id="contextual-help-wrap" class="hidden">
+	<?php
+		if ( isset($help[$page]) ) {
+			if ( isset($title) && 'edit-post' != $page )
+				echo '<h5>' . sprintf(__('Get help with "%s"'), $title) . '</h5>';
+			else
+				echo '<h5>' . __('Get help with this page') . '</h5>';
+			echo '<div class="metabox-prefs">' . $help[$page] . "</div>\n";
+	
+			echo '<h5>' . __('Other Help') . '</h5>';
+		} else {
+			echo '<h5>' . __('Help') . '</h5>';
+		}
+	
+		echo '<div class="metabox-prefs">';
+		_e('<a href="http://codex.wordpress.org/">Documentation</a>');
+		echo '<br />';
+		_e('<a href="http://wordpress.org/support/">Support Forums</a>');
+		echo "</div>\n";
+	?>
 	</div>
+	<?php
+	}
+?>
+
+
+<div id="screen-meta-links">
+<?php if ( '' != $page ) { ?>
+<div id="contextual-help-link-wrap" class="hide-if-no-js screen-meta-toggle">
+<a href="#contextual-help" id="contextual-help-link" class="show-settings"><?php _e('Help') ?></a>
+</div>
+<?php } ?>
+<div id="screen-options-link-wrap" class="hide-if-no-js screen-meta-toggle">
+<a href="#screen-options" id="show-settings-link" class="show-settings"><?php _e('Screen Options') ?></a>
+</div>
+</div>
 </div>
 <?php
+
+}
+
+function contextual_help(  ) {
+	
 }
 
 ?>
diff --git a/wp-admin/index.php b/wp-admin/index.php
index b2cb3b2deb..f8456e9ac0 100644
--- a/wp-admin/index.php
+++ b/wp-admin/index.php
@@ -28,7 +28,7 @@ require_once('admin-header.php');
 $today = current_time('mysql', 1);
 ?>
 
-<?php screen_options('dashboard', 1); ?>
+<?php screen_meta('dashboard', 1); ?>
 
 <div class="wrap">
 <h2><?php echo wp_specialchars( $title ); ?></h2>
diff --git a/wp-admin/js/settings-box.js b/wp-admin/js/settings-box.js
index c01ca7390a..dc5115d927 100644
--- a/wp-admin/js/settings-box.js
+++ b/wp-admin/js/settings-box.js
@@ -1,14 +1,31 @@
 jQuery(document).ready( function($) {
 	$('#show-settings-link').click(function () {
-		$('#screen-options-wrap').slideToggle('normal', function(){
+		$('#screen-options-wrap').slideToggle('fast', function(){
 			if ( $(this).hasClass('screen-options-open') ) {
 				$('#show-settings-link').css({'backgroundImage':'url("images/screen-options-right.gif")'});
+				$('#contextual-help-link-wrap').removeClass('invisible');
 				$(this).removeClass('screen-options-open');
+				
 			} else {
 				$('#show-settings-link').css({'backgroundImage':'url("images/screen-options-right-up.gif")'});
+				$('#contextual-help-link-wrap').addClass('invisible');
 				$(this).addClass('screen-options-open');
 			}
 		});
 		return false;
+	}).parent();
+	$('#contextual-help-link').click(function () {
+		$('#contextual-help-wrap').slideToggle('fast', function(){
+			if ( $(this).hasClass('contextual-help-open') ) {
+				$('#contextual-help-link').css({'backgroundImage':'url("images/screen-options-right.gif")'});
+				$('#screen-options-link-wrap').removeClass('invisible');
+				$(this).removeClass('contextual-help-open');
+			} else {
+				$('#contextual-help-link').css({'backgroundImage':'url("images/screen-options-right-up.gif")'});
+				$('#screen-options-link-wrap').addClass('invisible');
+				$(this).addClass('contextual-help-open');
+			}
+		});
+		return false;
 	});
 });
\ No newline at end of file
diff --git a/wp-admin/link-manager.php b/wp-admin/link-manager.php
index 2bf070ed01..c6d00ab87c 100644
--- a/wp-admin/link-manager.php
+++ b/wp-admin/link-manager.php
@@ -74,7 +74,7 @@ switch ($order_by) {
 		break;
 } ?>
 
-<?php screen_options('link') ?>
+<?php screen_meta('link') ?>
 
 <div class="wrap nosubsub">
 <h2><?php echo wp_specialchars( $title ); ?></h2> 
diff --git a/wp-admin/upload.php b/wp-admin/upload.php
index f9a8e13a52..392a5c040a 100644
--- a/wp-admin/upload.php
+++ b/wp-admin/upload.php
@@ -145,7 +145,7 @@ if ( is_singular() ) {
 
 require_once('admin-header.php'); ?>
 
-<?php screen_options('media') ?>
+<?php screen_meta('media') ?>
 
 <?php
 if ( isset($_GET['posted']) && (int) $_GET['posted'] ) {
diff --git a/wp-admin/users.php b/wp-admin/users.php
index c048090a63..6043474161 100644
--- a/wp-admin/users.php
+++ b/wp-admin/users.php
@@ -237,7 +237,7 @@ default:
 		}
 	endif; ?>
 
-<?php screen_options('user') ?>
+<?php screen_meta('user') ?>
 
 <?php if ( isset($errors) && is_wp_error( $errors ) ) : ?>
 	<div class="error">
diff --git a/wp-admin/wp-admin.css b/wp-admin/wp-admin.css
index 349debd0ec..f00e4223db 100644
--- a/wp-admin/wp-admin.css
+++ b/wp-admin/wp-admin.css
@@ -1,3 +1,10 @@
+
+
+
+#wpbody {
+	clear: both;
+}
+
 .plugins .name,
 #pass-strength-result.strong,
 #pass-strength-result.short,
@@ -1494,6 +1501,7 @@ table.form-table td .updated {
 	font-weight: bold;
 	padding: 6px 7px;
 	margin: 0 0 10px;
+	line-height: 1;
 }
 
 .metabox-holder .postbox,
@@ -1502,6 +1510,7 @@ table.form-table td .updated {
 	margin-bottom: 20px;
 	border-width: 1px;
 	border-style: solid;
+	line-height: 1;
 	-moz-border-radius: 6px;
 	-khtml-border-radius: 6px;
 	-webkit-border-radius: 6px;
@@ -2355,27 +2364,30 @@ fieldset {
 
 /* show/hide settings */
 
-#screen-options {
+#screen-meta {
 	position: relative;
 	clear: both;
 }
 
-#wpbody {
-	clear: both;
+#screen-meta-links {
+	margin: 0 20px 0 0;
 }
 
-#screen-options-link-wrap {
+#screen-meta .invisible {
+	visibility: hidden;
+}
+
+#screen-options-link-wrap,
+#contextual-help-link-wrap {
 	float: right;
 	background: transparent url( images/screen-options-left.gif ) no-repeat 0 0;
 	font-family: "Lucida Grande", "Lucida Sans Unicode", Tahoma, Verdana, sans-serif;
 	height: 23px;
 	padding: 0;
-	position: relative;
-	right: 100px;
-	top: -1px;
+	margin: -1px 10px 0 0;
 }
 
-#screen-options a.show-settings {
+#screen-meta a.show-settings {
 	text-decoration: none;
 	z-index: 1;
 	padding: 0 18px 0 8px;
@@ -2388,25 +2400,23 @@ fieldset {
 	background-color: transparent;
 }
 
-#screen-options a#show-settings-link {
+#screen-meta a.show-settings {
 	background-image: url( images/screen-options-right.gif );
 }
 
-#screen-options a#hide-settings-link {
-	background-image: url( images/screen-options-right-up.gif );
-}
-
-#screen-options a.show-settings:hover {
+#screen-meta a.show-settings:hover {
 	text-decoration: none;
 }
 
-#screen-options-wrap h5 {
+#screen-options-wrap h5,
+#contextual-help-wrap h5 {
 	padding: 10px 0 0 15px;
 	margin: 0;
 	font-size: 13px;
 }
 
-#screen-options-wrap {
+#screen-options-wrap,
+#contextual-help-wrap {
 	border-style: none solid solid;
 	border-top: 0 none;
 	border-width: 0 1px 1px;