<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /><style type="text/css"><!--
#msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding: 6px; }
#msg ul, pre { overflow: auto; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<title>[14929] trunk/wp-admin: Post and page help.</title>
</head>
<body>
<div id="msg">
<dl>
<dt>Revision</dt> <dd><a href="http://trac.wordpress.org/changeset/14929">14929</a></dd>
<dt>Author</dt> <dd>ryan</dd>
<dt>Date</dt> <dd>2010-05-26 03:36:04 +0000 (Wed, 26 May 2010)</dd>
</dl>
<h3>Log Message</h3>
<pre>Post and page help. see <a href="http://trac.wordpress.org/ticket/13467">#13467</a></pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkwpadmineditformadvancedphp">trunk/wp-admin/edit-form-advanced.php</a></li>
<li><a href="#trunkwpadmineditphp">trunk/wp-admin/edit.php</a></li>
<li><a href="#trunkwpadminincludestemplatephp">trunk/wp-admin/includes/template.php</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkwpadmineditformadvancedphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/edit-form-advanced.php (14928 => 14929)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/edit-form-advanced.php 2010-05-26 03:13:16 UTC (rev 14928)
+++ trunk/wp-admin/edit-form-advanced.php 2010-05-26 03:36:04 UTC (rev 14929)
</span><span class="lines">@@ -165,15 +165,30 @@
</span><span class="cx"> do_action('do_meta_boxes', $post_type, 'advanced', $post);
</span><span class="cx"> do_action('do_meta_boxes', $post_type, 'side', $post);
</span><span class="cx">
</span><del>-add_contextual_help($current_screen, '<p>' . __('The title field and the big Post Editing Area are fixed in place, but you can reposition all the other boxes that allow you to add metadata to your post using drag and drop, and can minimize or expand them by clicking the title bar of the box. You can also hide any of the boxes by using the Screen Options tab, where you can also choose a 1- or 2-column layout for this screen.') . '</p>' .
</del><ins>+if ( 'post' == $post_type ) {
+ add_contextual_help($current_screen, '<p>' . __('The title field and the big Post Editing Area are fixed in place, but you can reposition all the other boxes that allow you to add metadata to your post using drag and drop, and can minimize or expand them by clicking the title bar of the box. You can also hide any of the boxes by using the Screen Options tab, where you can also choose a 1- or 2-column layout for this screen.') . '</p>' .
</ins><span class="cx"> '<p>' . __('<strong>Title</strong> - Enter a title for your post. After you enter a title, you&#8217;ll see the permalink below, which you can edit.') . '</p>' .
</span><span class="cx"> '<p>' . __('<strong>Post editor</strong> - Enter the text for you post. There are two modes of editing: Visual and HTML. Choose the mode by clicking on the appropriate tab. Visual mode gives you a WYSIWYG editor. Click the last icon in the row to get a second row of controls. The HTML mode allows you to enter raw HTML along with your post text. You can insert media files by clicking the icons above the post editor and following the directions.') . '</p>' .
</span><span class="cx"> '<p>' . __('<strong>Publish</strong> - You can set the terms of publishing your post in the Publish box. For Status, Visibility, and Publish (immediately), click on the Edit link to reveal more options. Visibility includes options for password-protecting a post or making it stay at the top of your blog indefinitely (sticky). Publish (immediately) allows you to set a future or past date and time, so you can schedule a post to be published in the future or backdate a post.') . '</p>' .
</span><span class="cx"> '<p>' . __('<strong>Featured Image</strong> - This allows you to associate an image with your post without inserting it. This is usually useful only if your theme makes use of the featured image as a post thumbnail on the home page, a custom header, etc.') . '</p>' .
</span><span class="cx"> '<p>' . __('<strong>Send Trackbacks</strong> - Trackbacks are a way to notify legacy blog systems that you’ve linked to them. Enter the URL(s) you want to send trackbacks. If you link other WordPress sites they&#8217;ll be notified automatically using pingbacks, and this field is unnecessary.') . '</p>' .
</span><span class="cx"> '<p>' . __('<strong>Discussion</strong> - You can turn comments and pings on or off, and if there are comments on the post, you can see them here and moderate them.') . '</p>' .
</span><del>- '<p>' . sprintf(__('You can also create posts with the <a href="%s">Press This bookmarklet</a>.'), 'tools.php') . '</p>'
-);
</del><ins>+ '<p>' . sprintf(__('You can also create posts with the <a href="%s">Press This bookmarklet</a>.'), 'tools.php') . '</p>' .
+ '<p>' . __('For more information:') . '</p>' .
+ '<p>' . sprintf(__('<a href="%s">Writing Posts Documentation</a>'), 'http://codex.wordpress.org/Writing_Posts') . '</p>' .
+ '<p>' . sprintf(__('<a href="%s">Support Forums</a>'), 'http://wordpress.org/support/') . '</p>'
+ );
+} elseif ( 'page' == $post_type ) {
+ add_contextual_help($current_screen, '<p>' . __('Pages are similar to to Posts in that they have a title, body text, and associated metadata, but they are different in that they are not part of the chronological blog stream, kind of like permanent posts. Pages are not categorized or tagged, but can have a hierarchy. You can nest Pages under other Pages by making one the "Parent" of the other, creating a group of Pages.') . '</p>' .
+ '<p>' . __('Creating a Page is very similar to creating a Post, and the screens can be customized in the same way using drag and drop, the Screen Options tab, and expanding/collapsing boxes as you choose. The Page editor mostly works the same Post editor, but there are some Page-specific features in the Attributes box:') . '</p>' .
+ '<p>' . __('<strong>Parent</strong> - You can arrange your pages in hierarchies. For example, you could have an &#8220;About&#8221; page that has &#8220;Life Story&#8221; and &#8220;My Dog&#8221; pages under it. There are no limits to how many levels you can nest pages.') . '</p>' .
+ '<p>' . __('<strong>Template</strong> - Some themes have custom templates you can use for certain pages that might have additional features or custom layouts. If so, you&#8217;ll see them in this dropdown menu.') . '</p>' .
+ '<p>' . __('<strong>Order</strong> - Pages are usually ordered alphabetically, but you can put a number above to change the order pages appear in.') . '</p>' .
+ '<p>' . __('For more information:') . '</p>' .
+ '<p>' . sprintf(__('<a href="%s">Page Creation Documentation</a>'), 'http://codex.wordpress.org/Pages_Add_New_SubPanel') . '</p>' .
+ '<p>' . sprintf(__('<a href="%s">Support Forums</a>'), 'http://wordpress.org/support/') . '</p>'
+ );
+}
</ins><span class="cx">
</span><span class="cx"> require_once('./admin-header.php');
</span><span class="cx"> ?>
</span></span></pre></div>
<a id="trunkwpadmineditphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/edit.php (14928 => 14929)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/edit.php 2010-05-26 03:13:16 UTC (rev 14928)
+++ trunk/wp-admin/edit.php 2010-05-26 03:36:04 UTC (rev 14929)
</span><span class="lines">@@ -156,7 +156,8 @@
</span><span class="cx">
</span><span class="cx"> $title = $post_type_object->labels->name;
</span><span class="cx">
</span><del>-add_contextual_help($current_screen, '<p>' . __('You can customize the display of this screen in a number of ways:') . '</p>' .
</del><ins>+if ( 'post' == $post_type ) {
+ add_contextual_help($current_screen, '<p>' . __('You can customize the display of this screen in a number of ways:') . '</p>' .
</ins><span class="cx"> '<ul>' .
</span><span class="cx"> '<li>' . __('You can hide/display columns based on your needs and decide how many posts to list per screen using the Screen Options tab.') . '</li>' .
</span><span class="cx"> '<li>' . __('You can filter the list of posts by post status using the text links in the upper left to show All, Published, Draft, or Trashed posts. The default view is to show all posts.') . '</li>' .
</span><span class="lines">@@ -170,8 +171,20 @@
</span><span class="cx"> '<li>' . __('Trash removes your post from this list and places it in the trash, from which you can permanently delete it.') . '</li>' .
</span><span class="cx"> '<li>' . __('Preview will show you what your draft post will look like if you publish it. View will take you to your live site to view the post. Which link is available depends on your post&#8217;s status.') . '</li>' .
</span><span class="cx"> '</ul>' .
</span><del>- '<p>' . __('You can also edit multiple posts at once. Select the posts you want to edit using the checkboxes, select Edit from the Bulk Actions menu and click Apply. You will be able to change the metadata (categories, author, etc.) for all selected posts at once. To remove a post from the grouping, just click the x next to its name in the Bulk Edit area that appears.') . '</p>'
-);
</del><ins>+ '<p>' . __('You can also edit multiple posts at once. Select the posts you want to edit using the checkboxes, select Edit from the Bulk Actions menu and click Apply. You will be able to change the metadata (categories, author, etc.) for all selected posts at once. To remove a post from the grouping, just click the x next to its name in the Bulk Edit area that appears.') . '</p>' .
+ '<p>' . __('For more information:') . '</p>' .
+ '<p>' . sprintf(__('<a href="%s">Edit Posts Documentation</a>'), 'http://codex.wordpress.org/Posts_Edit_SubPanel') . '</p>' .
+ '<p>' . sprintf(__('<a href="%s">Support Forums</a>'), 'http://wordpress.org/support/') . '</p>'
+ );
+} elseif ( 'page' == $post_type ) {
+ add_contextual_help($current_screen, '<p>' . __('Pages are similar to to Posts in that they have a title, body text, and associated metadata, but they are different in that they are not part of the chronological blog stream, kind of like permanent posts. Pages are not categorized or tagged, but can have a hierarchy. You can nest Pages under other Pages by making one the "Parent" of the other, creating a group of Pages.') . '</p>' .
+ '<p>' . __('Managing Pages is very similar to managing Posts, and the screens can be customized in the same way. ') . '</p>' .
+ '<p>' . __('You can also perform the same types of actions, including narrowing the list by using the filters, acting on a Page using the action links that appear when you hover over a row, or using the Bulk Actions menu to edit the metadata for multiple Pages at once.') . '</p>' .
+ '<p>' . __('For more information:') . '</p>' .
+ '<p>' . sprintf(__('<a href="%s">Page Management Documentation</a>'), 'http://codex.wordpress.org/Pages_Edit_SubPanel') . '</p>' .
+ '<p>' . sprintf(__('<a href="%s">Support Forums</a>'), 'http://wordpress.org/support/') . '</p>'
+ );
+}
</ins><span class="cx">
</span><span class="cx"> require_once('./admin-header.php');
</span><span class="cx">
</span></span></pre></div>
<a id="trunkwpadminincludestemplatephp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/includes/template.php (14928 => 14929)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/includes/template.php 2010-05-26 03:13:16 UTC (rev 14928)
+++ trunk/wp-admin/includes/template.php 2010-05-26 03:36:04 UTC (rev 14929)
</span><span class="lines">@@ -3634,23 +3634,16 @@
</span><span class="cx"> <?php
</span><span class="cx"> $contextual_help = '';
</span><span class="cx"> if ( isset($_wp_contextual_help[$screen->id]) ) {
</span><del>- if ( !empty($title) )
- $contextual_help .= '<h5>' . sprintf(__('Get help with &#8220;%s&#8221;'), $title) . '</h5>';
- else
- $contextual_help .= '<h5>' . __('Get help with this page') . '</h5>';
</del><span class="cx"> $contextual_help .= '<div class="metabox-prefs">' . $_wp_contextual_help[$screen->id] . "</div>\n";
</span><del>-
- $contextual_help .= '<h5>' . __('Other Help') . '</h5>';
</del><span class="cx"> } else {
</span><del>- $contextual_help .= '<h5>' . __('Help') . '</h5>';
</del><ins>+ $contextual_help .= '<div class="metabox-prefs">';
+ $default_help = __('<a href="http://codex.wordpress.org/" target="_blank">Documentation</a>');
+ $default_help .= '<br />';
+ $default_help .= __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>');
+ $contextual_help .= apply_filters('default_contextual_help', $default_help);
+ $contextual_help .= "</div>\n";
</ins><span class="cx"> }
</span><span class="cx">
</span><del>- $contextual_help .= '<div class="metabox-prefs">';
- $default_help = __('<a href="http://codex.wordpress.org/" target="_blank">Documentation</a>');
- $default_help .= '<br />';
- $default_help .= __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>');
- $contextual_help .= apply_filters('default_contextual_help', $default_help);
- $contextual_help .= "</div>\n";
</del><span class="cx"> echo apply_filters('contextual_help', $contextual_help, $screen->id, $screen);
</span><span class="cx"> ?>
</span><span class="cx"> </div>
</span></span></pre>
</div>
</div>
</body>
</html>