Ticket #17357: 17357.2.diff

wp-content/themes/twentyeleven/inc/theme-options.php

@@ -55 +55 @@
 add_action( 'admin_init', 'twentyeleven_theme_options_init' );
 
 /**
- * Add our theme options page to the admin menu.
+ * Add our theme options page to the admin menu, including some help documentation.
  *
  * This function is attached to the admin_menu action hook.
  *
  * @since Twenty Eleven 1.0
  */
 function twentyeleven_theme_options_add_page() {
-        add_theme_page(
+        $theme_page = add_theme_page(
                 __( 'Theme Options', 'twentyeleven' ), // Name of page
                 __( 'Theme Options', 'twentyeleven' ), // Label in menu
                 'edit_theme_options',                  // Capability required
                 'theme_options',                       // Menu slug, used to uniquely identify the page
                 'theme_options_render_page'            // Function that renders the options page
         );
+        $help = '<p>' . __( 'This Theme Options screen, as enabled by your theme, Twenty Eleven, allows you to change some settings regarding the theme&#8217;s color and layout.') . '</p>' .
+                        '<p>' . __( 'You can toggle between Light or Dark text areas for your site in Color Scheme, with contrasting letters. Colors could be further changed or examined in the theme&#8217;s CSS via Appearance > Editor. The color for links can be set to specific values or using a color wheel by clicking on the color patch or "Select a Color" button.' ) . '</p>' .
+                        '<p>' . __( 'There are three options for the theme&#8217;s layout (each containing the same header):' ) . '</p>' .
+                        '<ol>' .
+                                '<li>' . __( 'Main content on left, sidebar on right' ) . '</li>' .
+                                '<li>' . __( 'Main content on right, sidebar on left' ) . '</li>' .
+                                '<li>' . __( 'Main content spans the entire site&#8217;s width, no sidebar' ) . '</li>' .
+                        '</ol>' .
+                        '<p>' . __( 'Remember to click "Save Changes" to save any changes you have made to the theme&#8217;s options.' ) . '</p>' .
+                        '<p><strong>' . __('For more information:') . '</strong></p>' .
+                        '<p>' . __( '<a href="http://codex.wordpress.org/Appearance_Theme_Options_Screen" target="_blank">Documentation on Theme Options</a>' ) . '</p>' .
+                        '<p>' . __( '<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>' ) . '</p>';
+
+        add_contextual_help( $theme_page, $help );
 }
 add_action( 'admin_menu', 'twentyeleven_theme_options_add_page' );
 
@@ -113 +127 @@
                 ),
                 'content' => array(
                         'value' => 'content',
-                        'label' => __( 'One-column, no Sidebar', 'twentyeleven' ),
+                        'label' => __( 'One-column, no sidebar', 'twentyeleven' ),
                         'thumbnail' => get_template_directory_uri() . '/inc/images/content.png',
                 ),
         );