Ticket #13467: media-contextual-help.13467.diff

wp-admin/media-upload.php

@@ -56 +56 @@
 
         $title = __('Upload New Media');
         $parent_file = 'upload.php';
+
+        add_contextual_help( $current_screen,
+
+                '<p>' . __('You can upload media files here without creating a post first. This allows you to upload files to use with posts and pages later and/or to get a web link for a particular file that you can share.') . '</p>' .
+                '<p>' . __('The first screen for <em>Upload New</em> provides two options: to <em>Select Files</em> (multiple file upload allowed) or to switch to a <em>Browser Uploader</em> (which has two similar options). Clicking <em>Select Files</em> opens a navigation window showing you files in your operating system. Selecting <em>Open</em> after clicking on the file you want activates a progress bar on the uploader screen, which gives percentages, says &#8220;crunching,&#8221; and upon completion adds a thumbnail and five metadata boxes on this screen. Basic image editing is available after upload is complete. Make sure you click <em>Save</em> before leaving this screen.') . '</p>' .
+                '<p>' . __('<a href="http://codex.wordpress.org/Media_Add_New_SubPanel">Add New Media in Codex</a>') . '</p>' .
+                '<p>' . __('<a href="http://codex.wordpress.org/">General Codex Documentation</a>') . '</p>' .
+                '<p>' . __('<a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+        );
+
         require_once('./admin-header.php'); ?>
         <div class="wrap">
         <?php screen_icon(); ?>

wp-admin/upload.php

@@ -162 +162 @@
 $is_trash = ( isset($_GET['status']) && $_GET['status'] == 'trash' );
 
 wp_enqueue_script('media');
+
+add_contextual_help( $current_screen,
+        '<p>' . __('All the files you’ve uploaded are listed in the Media Library, with the most recent uploads listed first. You can use the <em>Screen Options</em> tab to customize the display of this screen.') . '</p>' .
+        '<p>' . __('You can narrow the list by file type/status using the text link filters at the top of the screen. You also can refine the list by date using the dropdown menu above the media table.') . '</p>' .
+        '<p>' . __('Hovering over a row reveals action links: <em>Edit</em>, <em>Delete Permanently</em>, and <em>View</em>. Clicking <em>Edit</em> or on the media file&#8217;s name displays a simple screen to edit that individual file&#8217;s metadata. Clicking <em>Delete Permanently</em> will delete the file from the media library (as well as from any posts to which it is currently attached). <em>View</em> will take you to the display page for that file. ') . '</p>' .
+        '<p>' . __('If a media file has not been attached to any post, you will see that in the <em>Attached To</em> column, and can click on <em>Attach File</em> to launch a small popup that will allow you to search for a post and attach the file.') . '</p>' .
+        '<p>' . __('For more information:<br /> 
+        <a href="http://codex.wordpress.org/Media_Library_SubPanel">Media Library Documentation</a> <br />
+        <a href="http://wordpress.org/support/">Support Forums</a>') . '</p>'
+);
+
 require_once('./admin-header.php');
 ?>