From 4c566cebc6609b81f6240d9e37c8f36a62342832 Mon Sep 17 00:00:00 2001 From: nacin Date: Thu, 1 Dec 2011 00:52:31 +0000 Subject: [PATCH] Help text tweaks for the Settings screens. props jane. see #19020. git-svn-id: http://svn.automattic.com/wordpress/trunk@19507 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-admin/options-discussion.php | 4 ++-- wp-admin/options-general.php | 4 ++-- wp-admin/options-media.php | 13 +++++++++---- wp-admin/options-permalink.php | 24 +++++++++++++++++++----- wp-admin/options-privacy.php | 9 ++++----- wp-admin/options-reading.php | 4 ++-- wp-admin/options-writing.php | 6 +++--- 7 files changed, 41 insertions(+), 23 deletions(-) diff --git a/wp-admin/options-discussion.php b/wp-admin/options-discussion.php index b511f5a291..6270f99f98 100644 --- a/wp-admin/options-discussion.php +++ b/wp-admin/options-discussion.php @@ -16,8 +16,8 @@ $title = __('Discussion Settings'); $parent_file = 'options-general.php'; get_current_screen()->add_help_tab( array( - 'id' => 'options-discussion', - 'title' => __('Discussion Options'), + 'id' => 'overview', + 'title' => __('Overview'), 'content' => '

' . __('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’t all fit here! :) Use the documentation links to get information on what each discussion setting does.') . '

' . '

' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '

', ) ); diff --git a/wp-admin/options-general.php b/wp-admin/options-general.php index 29cf3ae517..e2d120b8dc 100644 --- a/wp-admin/options-general.php +++ b/wp-admin/options-general.php @@ -70,8 +70,8 @@ $options_help .= '

' . __('UTC means Coordinated Universal Time.') . '

' . '

' . __('Remember to click the Save Changes button at the bottom of the screen for new settings to take effect.') . '

'; get_current_screen()->add_help_tab( array( - 'id' => 'options', - 'title' => __('Options'), + 'id' => 'overview', + 'title' => __('Overview'), 'content' => $options_help, ) ); diff --git a/wp-admin/options-media.php b/wp-admin/options-media.php index 7ecfa32488..83eacabed5 100644 --- a/wp-admin/options-media.php +++ b/wp-admin/options-media.php @@ -16,17 +16,22 @@ $title = __('Media Settings'); $parent_file = 'options-general.php'; $media_options_help = '

' . __('You can set maximum sizes for images inserted into your written content; you can also insert an image as Full Size.') . '

' . - '

' . __('The Embed option allows you embed a video, image, or other media content into your content automatically by typing the URL (of the web page where the file lives) on its own line when you create your content.') . '

'; + '

' . __('The Embed option allows you embed a video, image, or other media content into your content automatically by typing the URL (of the web page where the file lives) on its own line when you create your content.'); + +if ( ! empty( $content_width ) ) + $media_options_help .= ' ' . __( 'If you do not set the maximum embed size, it will be automatically sized to fit into your content area.' ); + +$media_options_help .= '

'; if ( ! is_multisite() ) { - $media_options_help .= '

' . __('Uploading Options gives you folder and path choices for storing your files in your installation’s directory.') . '

'; + $media_options_help .= '

' . __('Uploading Files allows you to choose the folder and path for storing your uploaded files.') . '

'; } $media_options_help .= '

' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '

'; get_current_screen()->add_help_tab( array( - 'id' => 'options-media', - 'title' => __('Media Options'), + 'id' => 'overview', + 'title' => __('Overview'), 'content' => $media_options_help, ) ); diff --git a/wp-admin/options-permalink.php b/wp-admin/options-permalink.php index dd2b494825..96d0f0ddcd 100644 --- a/wp-admin/options-permalink.php +++ b/wp-admin/options-permalink.php @@ -16,12 +16,26 @@ $title = __('Permalink Settings'); $parent_file = 'options-general.php'; get_current_screen()->add_help_tab( array( - 'id' => 'options-permalinks', - 'title' => __('Permalink Options'), - 'content' => '

' . __('This screen provides some common options for your default permalinks URL structure.') . '

' . + 'id' => 'overview', + 'title' => __('Overview'), + 'content' => '

' . __('Permalinks are the permanent URLs to your individual pages and blog posts, as well as your category and tag archives. A permalink is the web address used to link to your content. The URL to each post should be permanent, and never change — hence the name permalink.') . '

' . + '

' . __('This screen provides allows you to choose your default permalink structure. You can choose from common settings or create custom URL structures.') . '

' . + '

' . __('When making changes, you must click the Save Changes button at the bottom of the screen for the new settings to take effect.') . '

', +) ); + +get_current_screen()->add_help_tab( array( + 'id' => 'common-settings', + 'title' => __('Common Settings'), + 'content' => '

' . __('Many people choose to use “pretty permalinks,” URLs that contain useful information such as the post title rather than generic post ID numbers. You can choose from any of the permalink formats under Common Settings, or can craft your own if you select Custom Structure.') . '

' . '

' . __('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.') . '

' . '

' . __('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%.') . '

' . - '

' . __('The Optional fields let you customize the “category” and “tag” base names that will appear in archive URLs. For example, the page listing all posts in the “Uncategorized” category could be /topics/uncategorized instead of /category/uncategorized.') . '

' . + '

' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '

', +) ); + +get_current_screen()->add_help_tab( array( + 'id' => 'custom-structures', + 'title' => __('Custom Structures'), + 'content' => '

' . __('The Optional fields let you customize the “category” and “tag” base names that will appear in archive URLs. For example, the page listing all posts in the “Uncategorized” category could be /topics/uncategorized instead of /category/uncategorized.') . '

' . '

' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '

', ) ); @@ -176,7 +190,7 @@ $structures = array( 4 => $prefix . '/%postname%/', ); ?> -

+

diff --git a/wp-admin/options-privacy.php b/wp-admin/options-privacy.php index 7811d25414..d0d4336e28 100644 --- a/wp-admin/options-privacy.php +++ b/wp-admin/options-privacy.php @@ -16,11 +16,10 @@ $title = __('Privacy Settings'); $parent_file = 'options-general.php'; get_current_screen()->add_help_tab( array( - 'id' => 'options-privacy', - 'title' => __('Privacy Options'), - 'content' => '

' . __('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.') . '

' . - '

' . __('When this setting is in effect a reminder is shown in the Right Now box of the Dashboard that says, “Search Engines Blocked,” to remind you that your site is not being crawled.') . '

' . - '

' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '

', + 'id' => 'overview', + 'title' => __('Overview'), + 'content' => '

' . __('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 radio button next to “Ask search engines not to index this site” and click the Save Changes button at the bottom of the screen. Note that your privacy is not complete; your site is still visible on the web.') . '

' . + '

' . __('When this setting is in effect a reminder is shown in the Right Now box of the Dashboard that says, “Search Engines Blocked,” to remind you that your site is not being crawled.') . '

', ) ); get_current_screen()->set_help_sidebar( diff --git a/wp-admin/options-reading.php b/wp-admin/options-reading.php index b699cb83a4..e87348095c 100644 --- a/wp-admin/options-reading.php +++ b/wp-admin/options-reading.php @@ -42,8 +42,8 @@ function add_js() { add_action('admin_head', 'add_js'); get_current_screen()->add_help_tab( array( - 'id' => 'options-reading', - 'title' => __('Reading Options'), + 'id' => 'overview', + 'title' => __('Overview'), 'content' => '

' . __('This screen contains the settings that affect the display of your content.') . '

' . '

' . sprintf(__('You can choose what’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 Pages. One will become the front page, and the other will be where your posts are displayed.'), 'post-new.php?post_type=page') . '

' . '

' . __('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.') . '

' . diff --git a/wp-admin/options-writing.php b/wp-admin/options-writing.php index c03e91fbfc..15fd1d1115 100644 --- a/wp-admin/options-writing.php +++ b/wp-admin/options-writing.php @@ -16,9 +16,9 @@ $title = __('Writing Settings'); $parent_file = 'options-general.php'; get_current_screen()->add_help_tab( array( - 'id' => 'options-writing', - 'title' => __('Writing Options'), - 'content' => '

' . __('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.') . '

' . + 'id' => 'overview', + 'title' => __('Overview'), + 'content' => '

' . __('You can submit content in several different ways; this screen holds the settings for all of them. The top section controls the editor within the dashboard, while the rest control external publishing methods. For more information on any of these methods, use the documentation links.') . '

' . '

' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '

', ) );