<!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>[15019] trunk/wp-admin: Custom header and background help.</title>
</head>
<body>
<div id="msg">
<dl>
<dt>Revision</dt> <dd><a href="http://trac.wordpress.org/changeset/15019">15019</a></dd>
<dt>Author</dt> <dd>nacin</dd>
<dt>Date</dt> <dd>2010-05-28 00:27:53 +0000 (Fri, 28 May 2010)</dd>
</dl>
<h3>Log Message</h3>
<pre>Custom header and background help. props jane, see <a href="http://trac.wordpress.org/ticket/13467">#13467</a>.</pre>
<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkwpadmincustombackgroundphp">trunk/wp-admin/custom-background.php</a></li>
<li><a href="#trunkwpadmincustomheaderphp">trunk/wp-admin/custom-header.php</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkwpadmincustombackgroundphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/custom-background.php (15018 => 15019)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/custom-background.php 2010-05-28 00:21:14 UTC (rev 15018)
+++ trunk/wp-admin/custom-background.php 2010-05-28 00:27:53 UTC (rev 15019)
</span><span class="lines">@@ -34,6 +34,15 @@
</span><span class="cx"> var $admin_image_div_callback;
</span><span class="cx">
</span><span class="cx"> /**
</span><ins>+ * Holds the page menu hook.
+ *
+ * @var string
+ * @since 3.0.0
+ * @access private
+ */
+ var $page = '';
+
+ /**
</ins><span class="cx"> * PHP4 Constructor - Register administration header callback.
</span><span class="cx"> *
</span><span class="cx"> * @since 3.0.0
</span><span class="lines">@@ -55,7 +64,7 @@
</span><span class="cx"> if ( ! current_user_can('edit_theme_options') )
</span><span class="cx"> return;
</span><span class="cx">
</span><del>- $page = add_theme_page(__('Background'), __('Background'), 'edit_theme_options', 'custom-background', array(&$this, 'admin_page'));
</del><ins>+ $this->page = $page = add_theme_page(__('Background'), __('Background'), 'edit_theme_options', 'custom-background', array(&$this, 'admin_page'));
</ins><span class="cx">
</span><span class="cx"> add_action("load-$page", array(&$this, 'admin_load'));
</span><span class="cx"> add_action("load-$page", array(&$this, 'take_action'), 49);
</span><span class="lines">@@ -71,6 +80,12 @@
</span><span class="cx"> * @since 3.0.0
</span><span class="cx"> */
</span><span class="cx"> function admin_load() {
</span><ins>+ add_contextual_help( $this->page, '<p>' . __( 'You can set a custom image header for your site. Simply upload the image and crop it, and the new header will go live immediately. ' ) . '</p>' .
+ '<p>' . __( 'If you want to discard your custom header and go back to the default included in your theme, click on the buttons to remove the custom image and restore the original header image. ' ) . '</p>' .
+ '<p>' . __( 'Some themes comes with additional header images bundled. If you see multiple images displayed, select the one you&#8217;d like and click the Save Changes button. ' ) . '</p>' .
+ '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
+ '<p>' . __( '<a href="http://codex.wordpress.org/" target="_blank">Documentation</a>' ) . '</p>' .
+ '<p>' . __( '<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>' ) . '</p>' );
</ins><span class="cx"> wp_enqueue_script('custom-background');
</span><span class="cx"> wp_enqueue_style('farbtastic');
</span><span class="cx"> }
</span></span></pre></div>
<a id="trunkwpadmincustomheaderphp"></a>
<div class="modfile"><h4>Modified: trunk/wp-admin/custom-header.php (15018 => 15019)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/wp-admin/custom-header.php 2010-05-28 00:21:14 UTC (rev 15018)
+++ trunk/wp-admin/custom-header.php 2010-05-28 00:27:53 UTC (rev 15019)
</span><span class="lines">@@ -43,6 +43,15 @@
</span><span class="cx"> var $default_headers = array();
</span><span class="cx">
</span><span class="cx"> /**
</span><ins>+ * Holds the page menu hook.
+ *
+ * @var string
+ * @since 3.0.0
+ * @access private
+ */
+ var $page = '';
+
+ /**
</ins><span class="cx"> * PHP4 Constructor - Register administration header callback.
</span><span class="cx"> *
</span><span class="cx"> * @since 2.1.0
</span><span class="lines">@@ -64,16 +73,31 @@
</span><span class="cx"> if ( ! current_user_can('edit_theme_options') )
</span><span class="cx"> return;
</span><span class="cx">
</span><del>- $page = add_theme_page(__('Header'), __('Header'), 'edit_theme_options', 'custom-header', array(&$this, 'admin_page'));
</del><ins>+ $this->page = $page = add_theme_page(__('Header'), __('Header'), 'edit_theme_options', 'custom-header', array(&$this, 'admin_page'));
</ins><span class="cx">
</span><span class="cx"> add_action("admin_print_scripts-$page", array(&$this, 'js_includes'));
</span><span class="cx"> add_action("admin_print_styles-$page", array(&$this, 'css_includes'));
</span><ins>+ add_action("admin_head-$page", array(&$this, 'help') );
</ins><span class="cx"> add_action("admin_head-$page", array(&$this, 'take_action'), 50);
</span><span class="cx"> add_action("admin_head-$page", array(&$this, 'js'), 50);
</span><span class="cx"> add_action("admin_head-$page", $this->admin_header_callback, 51);
</span><span class="cx"> }
</span><span class="cx">
</span><span class="cx"> /**
</span><ins>+ * Adds contextual help.
+ *
+ * @since 3.0.0
+ */
+ function help() {
+ add_contextual_help( $this->page, '<p>' . __( 'You can set a custom image header for your site. Simply upload the image and crop it, and the new header will go live immediately. ' ) . '</p>' .
+ '<p>' . __( 'If you want to discard your custom header and go back to the default included in your theme, click on the buttons to remove the custom image and restore the original header image. ' ) . '</p>' .
+ '<p>' . __( 'Some themes comes with additional header images bundled. If you see multiple images displayed, select the one you&#8217;d like and click the Save Changes button. ' ) . '</p>' .
+ '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
+ '<p>' . __( '<a href="http://codex.wordpress.org/" target="_blank">Documentation</a>' ) . '</p>' .
+ '<p>' . __( '<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>' ) . '</p>' );
+ }
+
+ /**
</ins><span class="cx"> * Get the current step.
</span><span class="cx"> *
</span><span class="cx"> * @since 2.6.0
</span></span></pre>
</div>
</div>
</body>
</html>