Settings help. props duck_, see #13467.

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

wp-admin/options-discussion.php

@@ -15,6 +15,14 @@
 $title = __('Discussion Settings');
 $parent_file = 'options-general.php';
 
+add_contextual_help($current_screen, 
+	'<p>' . __('This screen provides many options for controlling the management and display of comments and links to your posts/pages. So many, in fact, they won&#8217;t all fit here! :) Use the documentation link below to get information on what each discussion setting does.') . '</p>' .
+	'<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Settings_Discussion_SubPanel">Discussion Settings Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 include('./admin-header.php');
 ?>
 

wp-admin/options-general.php

@@ -50,7 +50,17 @@ function add_js() {
 }
 add_filter('admin_head', 'add_js');
 
-add_contextual_help($current_screen, __('<a href="http://codex.wordpress.org/Settings_General_SubPanel">General Settings Documentation</a>'));
+add_contextual_help($current_screen, 
+	'<p>' . __('The fields on this screen determine some of the basics of your site setup.') . '</p>' .
+	'<p>' . __('Most themes display the site title at the top of every page, in the title bar of the browser, and as the identifying name for syndicated feeds, unless not allowed by your theme. The tagline is also displayed by many themes.') . '</p>' .
+	'<p>' . __('The WordPress URL and the Site URL can be the same (example.com) or different; for example, having the WordPress core files (example.com/wordpress) in a subdirectory instead of the root directory.') . '</p>' .
+	'<p>' . __('If you want site visitors to be able to register themselves, as opposed to being registered by the site administrator, check the membership box. A default user role can be set for all new users, whether self-registered or registered by the site administrator.') . '</p>' .
+	'<p>' . __('UTC means Coordinated Universal Time.') . '</p>' .
+	'<p>' . __('Remember to click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Settings_General_SubPanel">General Settings Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
 
 include('./admin-header.php');
 ?>

wp-admin/options-media.php

@@ -15,6 +15,16 @@
 $title = __('Media Settings');
 $parent_file = 'options-general.php';
 
+add_contextual_help($current_screen, 
+	'<p>' . __('You can set maximum sizes for images in the Add An Image popup window which appears when you insert images into your written content. These sizes can set limits for three of your four options; you can also insert an image as Full Size.') . '</p>' .
+	'<p>' . __('The Embed option allows for any URL linking to a video, image, or other media content to automatically become embedded in your post or page. Just type that URL on its own line when you&#8217;re creating your content.') . '</p>' .
+	'<p>' . __('Uploading Options gives you folder and path choices for storing your files in your installation&#8217;s directory.') . '</p>' .
+	'<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Settings_Media_SubPanel">Media Settings Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 include('./admin-header.php');
 
 ?>

wp-admin/options-permalink.php

@@ -15,6 +15,19 @@
 $title = __('Permalink Settings');
 $parent_file = 'options-general.php';
 
+add_contextual_help($current_screen, 
+	'<p>' . __('This screen provides some common options for your default permalinks URL structure.') . '</p>' .
+	'<p>' . __('If you pick an option other than Default, your general URL path with structure tags, terms surrounded by %, will also appear in the custom structure field and your path can be further modified there.') . '</p>' .
+	'<p>' . __('When you assign multiple categories or tags to a post, only one can show up in the permalink: the lowest numbered category. This applies if your custom structure includes %category% or %tag%.') . '</p>' .
+	'<p>' . __('Note that permalinks beginning with structure tags calling Category, Tag, Author, or Postname require more advanced server resources. Double-check your hosting details to make sure those are in place or start your permalinks with other structure tags.') . '</p>' .
+	'<p>' . __('The Optional fields lets you have add a base name that will appear in archive URLs intead of &#8220;category&#8221; or &#8220;tag.&#8221; For example, the page listing all posts in the category &#8220;uncategorized&#8221; could be /topics/uncategorized instead of category/uncategorized.') . '</p>' .
+	'<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Settings_Permalinks_SubPanel">Permalinks Settings Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Using_Permalinks">Using Permalinks Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 /**
  * Display JavaScript on the page.
  *

wp-admin/options-privacy.php

@@ -15,6 +15,15 @@
 $title = __('Privacy Settings');
 $parent_file = 'options-general.php';
 
+add_contextual_help($current_screen, 
+	'<p>' . __('You can choose whether or not your site will be crawled by robots, ping services, and spiders. If you want those services to ignore your site, click the second option here. Note that your privacy is not complete; your site is still visible on the web.') . '</p>' .
+	'<p>' . __('When this setting is in effect a reminder is shown in the header of these administration screens that says, "Search Engines Blocked," to remind you that your site is not being crawled.') . '</p>' .
+	'<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Settings_Privacy_SubPanel">Privacy Settings Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 include('./admin-header.php');
 ?>
 

wp-admin/options-reading.php

@@ -15,6 +15,16 @@
 $title = __( 'Reading Settings' );
 $parent_file = 'options-general.php';
 
+add_contextual_help($current_screen, 
+	'<p>' . __('This screen contains the settings that affect the display of your content.') . '</p>' .
+	'<p>' . __('You can choose what&#8217;s displayed on the front page of your site. It can be posts in reverse chronological order (classic blog), or a fixed/static page. To set a static home page, you first need to create two <a href="post-new.php?post_type=page">Pages</a>. One will become the front page, and the other will be where your posts are displayed.') . '</p>' .
+	'<p>' . __('You can also control the display of your content in RSS feeds, including the maximum numbers of posts to display, whether to show full text or a summary, and the character set encoding.') . '</p>' .
+	'<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Settings_Reading_SubPanel">Reading Settings Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 include( './admin-header.php' );
 ?>
 

wp-admin/options-writing.php

@@ -15,6 +15,14 @@
 $title = __('Writing Settings');
 $parent_file = 'options-general.php';
 
+add_contextual_help($current_screen, 
+	'<p>' . __('You can submit content in several different ways; this screen holds the settings for all of them. The top section controls the editor within these administration screens, while the rest control external publishing methods. For more information on any of these methods, use the documentation links below.') . '</p>' .
+	'<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' .
+	'<p><strong>' . __('For more information:') . '</strong></p>' .
+	'<p>' . __('<a href="http://codex.wordpress.org/Settings_Writing_SubPanel">Writing Settings Documentation</a>') . '</p>' .
+	'<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 include('./admin-header.php');
 ?>