WordPress.org

Make WordPress Core

Changeset 19472


Ignore:
Timestamp:
11/29/11 16:58:58 (3 years ago)
Author:
koopersmith
Message:

Update help text on settings pages. props Ipstenu, see #19020.

Location:
trunk/wp-admin
Files:
8 edited

Legend:

Unmodified
Added
Removed
  • trunk/wp-admin/network.php

    r19122 r19472  
    104104} 
    105105 
    106 add_contextual_help($current_screen, 
    107     '<p>' . __('This screen allows you to configure a network as having subdomains (<code>site1.example.com</code>) or subdirectories (<code>example.com/site1</code>). Subdomains require wildcard subdomains to be enabled in Apache and DNS records, if your host allows it.') . '</p>' . 
     106$network_help = '<p>' . __('This screen allows you to configure a network as having subdomains (<code>site1.example.com</code>) or subdirectories (<code>example.com/site1</code>). Subdomains require wildcard subdomains to be enabled in Apache and DNS records, if your host allows it.') . '</p>' . 
    108107    '<p>' . __('Choose subdomains or subdirectories; this can only be switched afterwards by reconfiguring your install. Fill out the network details, and click install. If this does not work, you may have to add a wildcard DNS record (for subdomains) or change to another setting in Permalinks (for subdirectories).') . '</p>' . 
    109108    '<p>' . __('The next screen for Network Setup will give you individually-generated lines of code to add to your wp-config.php and .htaccess files. Make sure the settings of your FTP client make files starting with a dot visible, so that you can find .htaccess; you may have to create this file if it really is not there. Make backup copies of those two files.') . '</p>' . 
    110109    '<p>' . __('Add a <code>blogs.dir</code> directory under <code>/wp-content</code> and add the designated lines of code to wp-config.php (just before <code>/*...stop editing...*/</code>) and <code>.htaccess</code> (replacing the existing WordPress rules).') . '</p>' . 
    111     '<p>' . __('Once you add this code and refresh your browser, multisite should be enabled. This screen will keep an archive of the added code. You can toggle between Network Admin and Site Admin by clicking on the Howdy (Username) dropdown in the upper right of the administration area.') . '</p>' . 
    112     '<p>' . __('The choice of subdirectory sites is disabled if this setup is more than a month old because of permalink problems with &#8220;/blog/&#8221; from the main site. This disabling will be addressed soon in a future version.') . '</p>' 
    113 ); 
     110    '<p>' . __('Once you add this code and refresh your browser, multisite should be enabled. This screen, now in the Network Admin navigation menu, will keep an archive of the added code. You can toggle between Network Admin and Site Admin by clicking on the Network Admin or an individual site name under the My Sites dropdown in the Admin Bar.') . '</p>' . 
     111    '<p>' . __('The choice of subdirectory sites is disabled if this setup is more than a month old because of permalink problems with &#8220;/blog/&#8221; from the main site. This disabling will be addressed in a future version.') . '</p>' . 
     112    '<p><strong>' . __('For more information:') . '</strong></p>' . 
     113    '<p>' . __('<a href="http://codex.wordpress.org/Create_A_Network" target="_blank">Documentation on Creating a Network</a>') . '</p>' . 
     114    '<p>' . __('<a href="http://codex.wordpress.org/Tools_Network_Screen" target="_blank">Documentation on the Network Screen</a>') . '</p>'; 
     115 
     116get_current_screen()->add_help_tab( array( 
     117    'id'      => 'network', 
     118    'title'   => __('Network'), 
     119    'content' => $network_help, 
     120) ); 
    114121 
    115122get_current_screen()->set_help_sidebar( 
  • trunk/wp-admin/options-discussion.php

    r19119 r19472  
    1616$parent_file = 'options-general.php'; 
    1717 
    18 add_contextual_help($current_screen, 
    19     '<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>' . 
    20     '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' 
    21 ); 
     18get_current_screen()->add_help_tab( array( 
     19    'id'      => 'options-discussion', 
     20    'title'   => __('Discussion Options'), 
     21    'content' => '<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 links to get information on what each discussion setting does.') . '</p>' . 
     22        '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>', 
     23) ); 
    2224 
    2325get_current_screen()->set_help_sidebar( 
  • trunk/wp-admin/options-general.php

    r19119 r19472  
    5959add_action('admin_head', 'add_js'); 
    6060 
    61 add_contextual_help($current_screen, 
    62     '<p>' . __('The fields on this screen determine some of the basics of your site setup.') . '</p>' . 
    63     '<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. The tagline is also displayed by many themes.') . '</p>' . 
    64     '<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>' . 
    65     '<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>' . 
    66     '<p>' . __('UTC means Coordinated Universal Time.') . '</p>' . 
    67     '<p>' . __('Remember to click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' 
    68 ); 
     61get_current_screen()->add_help_tab( array( 
     62    'id'      => 'options', 
     63    'title'   => __('Options'), 
     64    'content' => '<p>' . __('The fields on this screen determine some of the basics of your site setup.') . '</p>' . 
     65        '<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. The tagline is also displayed by many themes.') . '</p>' . 
     66        '<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>' . 
     67        '<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>' . 
     68        '<p>' . __('UTC means Coordinated Universal Time.') . '</p>' . 
     69        '<p>' . __('Remember to click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>', 
     70) ); 
    6971 
    7072get_current_screen()->set_help_sidebar( 
  • trunk/wp-admin/options-media.php

    r19119 r19472  
    1616$parent_file = 'options-general.php'; 
    1717 
    18 add_contextual_help($current_screen, 
    19     '<p>' . __('You can set maximum sizes for images inserted into your written content; you can also insert an image as Full Size.') . '</p>' . 
    20     '<p>' . __('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.') . '</p>' . 
    21     ( is_multisite() ? '' : '<p>' . __('Uploading Options gives you folder and path choices for storing your files in your installation&#8217;s directory.') . '</p>' ) . 
    22     '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' 
    23 ); 
     18$media_options_help = '<p>' . __('You can set maximum sizes for images inserted into your written content; you can also insert an image as Full Size.') . '</p>' . 
     19    '<p>' . __('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.') . '</p>'; 
     20 
     21if ( ! is_multisite() ) { 
     22    $media_options_help .= '<p>' . __('Uploading Options gives you folder and path choices for storing your files in your installation&#8217;s directory.') . '</p>'; 
     23} 
     24 
     25$media_options_help .= '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>'; 
     26 
     27get_current_screen()->add_help_tab( array( 
     28    'id'      => 'options-media', 
     29    'title'   => __('Media Options'), 
     30    'content' => $media_options_help, 
     31) ); 
    2432 
    2533get_current_screen()->set_help_sidebar( 
  • trunk/wp-admin/options-permalink.php

    r19119 r19472  
    1616$parent_file = 'options-general.php'; 
    1717 
    18 add_contextual_help($current_screen, 
    19     '<p>' . __('This screen provides some common options for your default permalinks URL structure.') . '</p>' . 
    20     '<p>' . __('If you pick an option other than Default, your general URL path with structure tags, terms surrounded by <code>%</code>, will also appear in the custom structure field and your path can be further modified there.') . '</p>' . 
    21     '<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 <code>%category%</code> or <code>%tag%</code>.') . '</p>' . 
    22     '<p>' . __('The Optional fields let you customize the &#8220;category&#8221; and &#8220;tag&#8221; base names that will appear in archive URLs. For example, the page listing all posts in the &#8220;Uncategorized&#8221; category could be <code>/topics/uncategorized</code> instead of <code>/category/uncategorized</code>.') . '</p>' . 
    23     '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' 
    24 ); 
     18get_current_screen()->add_help_tab( array( 
     19    'id'      => 'options-permalinks', 
     20    'title'   => __('Permalink Options'), 
     21    'content' => '<p>' . __('This screen provides some common options for your default permalinks URL structure.') . '</p>' . 
     22        '<p>' . __('If you pick an option other than Default, your general URL path with structure tags, terms surrounded by <code>%</code>, will also appear in the custom structure field and your path can be further modified there.') . '</p>' . 
     23        '<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 <code>%category%</code> or <code>%tag%</code>.') . '</p>' . 
     24        '<p>' . __('The Optional fields let you customize the &#8220;category&#8221; and &#8220;tag&#8221; base names that will appear in archive URLs. For example, the page listing all posts in the &#8220;Uncategorized&#8221; category could be <code>/topics/uncategorized</code> instead of <code>/category/uncategorized</code>.') . '</p>' . 
     25        '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>', 
     26) ); 
    2527 
    2628get_current_screen()->set_help_sidebar( 
  • trunk/wp-admin/options-privacy.php

    r19119 r19472  
    1616$parent_file = 'options-general.php'; 
    1717 
    18 add_contextual_help($current_screen, 
    19     '<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>' . 
    20     '<p>' . __('When this setting is in effect a reminder is shown in the Right Now box of the Dashboard that says, &#8220;Search Engines Blocked,&#8221; to remind you that your site is not being crawled.') . '</p>' . 
    21     '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' 
    22 ); 
     18get_current_screen()->add_help_tab( array( 
     19    'id'      => 'options-privacy', 
     20    'title'   => __('Privacy Options'), 
     21    'content' => '<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>' . 
     22        '<p>' . __('When this setting is in effect a reminder is shown in the Right Now box of the Dashboard that says, &#8220;Search Engines Blocked,&#8221; to remind you that your site is not being crawled.') . '</p>' . 
     23        '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>', 
     24) ); 
    2325 
    2426get_current_screen()->set_help_sidebar( 
  • trunk/wp-admin/options-reading.php

    r19119 r19472  
    4242add_action('admin_head', 'add_js'); 
    4343 
    44 add_contextual_help($current_screen, 
    45     '<p>' . __('This screen contains the settings that affect the display of your content.') . '</p>' . 
    46     '<p>' . sprintf(__('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="%s">Pages</a>. One will become the front page, and the other will be where your posts are displayed.'), 'post-new.php?post_type=page') . '</p>' . 
    47     '<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>' . 
    48     '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' 
    49 ); 
     44get_current_screen()->add_help_tab( array( 
     45    'id'      => 'options-reading', 
     46    'title'   => __('Reading Options'), 
     47    'content' => '<p>' . __('This screen contains the settings that affect the display of your content.') . '</p>' . 
     48        '<p>' . sprintf(__('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="%s">Pages</a>. One will become the front page, and the other will be where your posts are displayed.'), 'post-new.php?post_type=page') . '</p>' . 
     49        '<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>' . 
     50        '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>', 
     51) ); 
    5052 
    5153get_current_screen()->set_help_sidebar( 
  • trunk/wp-admin/options-writing.php

    r19387 r19472  
    1616$parent_file = 'options-general.php'; 
    1717 
    18 add_contextual_help($current_screen, 
    19     '<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>' . 
    20     '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>' 
    21 ); 
     18get_current_screen()->add_help_tab( array( 
     19    'id'      => 'options-writing', 
     20    'title'   => __('Writing Options'), 
     21    'content' => '<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.') . '</p>' . 
     22        '<p>' . __('You must click the Save Changes button at the bottom of the screen for new settings to take effect.') . '</p>', 
     23) ); 
     24 
     25get_current_screen()->add_help_tab( array( 
     26    'id'      => 'options-press', 
     27    'title'   => __('Press This'), 
     28    'content' => '<p>' . __('Press This is a bookmarklet that makes it easy to blog about something you come across on the web. You can use it to just grab a link, or to post an excerpt. Press This will even allow you to choose from images included on the page and use them in your post. Just drag the Press This link on this screen to your bookmarks bar in your browser, and you&#8217;ll be on your way to easier content creation. Clicking on it while on another website opens a popup window with all these options.') . '</p>', 
     29) ); 
     30 
     31 
     32if ( is_multisite() ) { 
     33    $post_email_help = '<p>' . __('Due to security issues, you cannot use Post By Email on Multisite Installs.') . '</p>'; 
     34} else { 
     35    $post_email_help = '<p>' . __('Post via email settings allow you to send your WordPress install an email with the content of your post.  You must set up a secret e-mail account with POP3 access to use this, and any mail received at this address will be posted, so it&#8217;s a good idea to keep this address very secret.') . '</p>'; 
     36} 
     37 
     38get_current_screen()->add_help_tab( array( 
     39    'id'      => 'options-postemail', 
     40    'title'   => __('Post Via Email'), 
     41    'content' => $post_email_help, 
     42) ); 
     43 
     44get_current_screen()->add_help_tab( array( 
     45    'id'      => 'options-remote', 
     46    'title'   => __('Remote Publishing'), 
     47    'content' => '<p>' . __('Remote Publishing allows you to use an external editor (like the iOS or Android app) to write your posts.') . '</p>', 
     48) ); 
     49 
     50get_current_screen()->add_help_tab( array( 
     51    'id'      => 'options-services', 
     52    'title'   => __('Update Services'), 
     53    'content' => '<p>' . __('If desired, WordPress will automatically alert various services of your new posts.') . '</p>', 
     54) ); 
    2255 
    2356get_current_screen()->set_help_sidebar( 
Note: See TracChangeset for help on using the changeset viewer.