Ticket #13467: 13467-plugins-help.diff

wp-admin/plugin-editor.php

@@ -15 +15 @@
 $title = __("Edit Plugins");
 $parent_file = 'plugins.php';
 
+$help = '<p>' . __('You can use the editor to make changes to any of your plugins&#8217; individual PHP files. Be aware that if you make changes, plugins updates will overwrite your customizations.') . '</p>';
+$help .= '<p>' . __('Choose a plugin to edit from the menu in the upper right and click the Select button. Click once on any file name to load it in the editor, and make your changes. Don&#8217;t forget to save your changes (Update File) when you&#8217;re finished.') . '</p>';
+$help .= '<p>' . __('The Documentation menu below the editor lists the PHP functions recognized in the plugin file. Clicking Lookup takes you to a web page about that particular function.') . '</p>';
+$help .= '<p>' . __('If you want to make changes but don&#8217;t want them to be overwritten when the plugin is updated, you may be ready to think about writing your own plugin. For information on how to edit a plugin or start from scratch, check out the links below.') . '</p>';
+$help .= '<p>' . __('<strong>For more information:</strong>') . '</p>'; 
+$help .= '<p>' . sprintf(__('<a href="%s">Documentation on Editing Plugins</a>'), 'http://codex.wordpress.org/Plugins_Editor_SubPanel') . '</p>';
+$help .= '<p>' . sprintf(__('<a href="%s">Documentation on Writing a Plugin</a>'), 'http://codex.wordpress.org/Writing_a_Plugin') . '</p>';
+$help .= '<p>' . sprintf(__('<a href="%s">Plugin Resources</a>'), 'http://codex.wordpress.org/Plugin_Resources') . '</p>';
+$help .= '<p>' . sprintf(__('<a href="%s">Plugin Support</a>'), 'http://wordpress.org/support/forum/10') . '</p>';
+add_contextual_help($current_screen, $help);
+
 wp_reset_vars(array('action', 'redirect', 'profile', 'error', 'warning', 'a', 'file', 'plugin'));
 
 wp_admin_css( 'theme-editor' );

wp-admin/plugin-install.php

@@ -52 +52 @@
 
 do_action('install_plugins_pre_' . $tab); //Used to override the general interface, Eg, install or plugin information.
 
-add_contextual_help($current_screen, plugins_search_help());
+$help = '<p>' . sprintf(__('Plugins hook into WordPress to extend its functionality with custom features. Plugins are developed independently from WordPress core by thousands of developers all over the world. All plugins in the official <a href="%s">WordPress.org Plugin Directory</a> are compatible with the WordPress GPL v2 license. You can find new plugins to install by searching or browsing the Directory right here in your own Plugins section.'), 'http://wordpress.org/extend/plugins/') . '</p>';
+$help .= '<p>' . __('If you know what you&#8217;re looking for, Search is your best bet. The Search screen has options to Search in the WordPress.org Plugin Directory for a particular Term, Author, or Tag. You can also search the directory by selecting a popular tags. Tags in larger type mean more plugins have teen labeled with that tag.') . '</p>';
+$help .= '<p>' . __('If you just want to get an idea of what&#8217;s available, you can browse Featured, Popular, Newest, and Recently Updated plugins by using the links in the upper left of the screen. These sections rotate regularly.') . '</p>';
+$help .= '<p>' . __('If you want to install a plugin that you&#8217;ve downloaded elsewhere, click Upload in the upper left. You will be prompted to upload the .zip package, and once uploaded, you can activate the new plugin.') . '</p>';
+$help .= '<p>' . __('<strong>For more information:</strong>') . '</p>';
+$help .= '<p>' . sprintf(__('<a href="%s">Documentation on Installing Plugins</a>'), 'http://codex.wordpress.org/Plugins_Add_New_SubPanel') . '</p>';
+$help .= '<p>' . sprintf(__('<a href="%s">Support Forums</a>'), 'http://wordpress.org/support/') . '</p>';
+add_contextual_help($current_screen, $help);
 
 include('./admin-header.php');
 ?>

wp-admin/plugins.php

@@ -304 +304 @@
 
 $help = '<p>' . __('Plugins extend and expand the functionality of WordPress. Once a plugin is installed, you may activate it or deactivate it here.') . '</p>';
 if ( current_user_can('edit_plugins') ) {
-$help .= '<p>' . sprintf(__('If something goes wrong with a plugin and you can&#8217;t use WordPress, delete or rename that file in the <code>%s</code> directory and it will be automatically deactivated.'), WP_PLUGIN_DIR) . '</p>';
-$help .= '<p>' . sprintf(__('You can find additional plugins for your site by using the new <a href="%1$s">Plugin Browser/Installer</a> functionality or by browsing the <a href="http://wordpress.org/extend/plugins/">WordPress Plugin Directory</a> directly and installing manually.  To <em>manually</em> install a plugin you generally just need to upload the plugin file into your <code>%2$s</code> directory.  Once a plugin has been installed, you may activate it here.'), 'plugin-install.php', WP_PLUGIN_DIR) . '</p>';
+        $help .= '<p>' . sprintf(__('You can find additional plugins for your site by using the Plugin Browser/Installer functionality or by browsing the <a href="%s">WordPress Plugin Directory</a> directly and installing new plugins manually. To manually install a plugin you generally just need to upload the plugin file into your <code>%s</code> directory. Once a plugin has been installed, you can activate it here.'), 'http://wordpress.org/extend/plugins/', WP_PLUGIN_DIR) . '</p>';
+        $help .= '<p>' . __('Most of the time, plugins play nicely with the core of WordPress and with other plugins. Sometimes, though, a plugin&#8217;s code will get in the way of another plugin, causing compatibility issues. If your site starts doing strange things, this may be the problem. Try deactivating all your plugins and re-activating them in various combinations until you isolate which one(s) caused the issue.') . '</p>';
+        $help .= '<p>' . sprintf(__('If something goes wrong with a plugin and you can&#8217;t use WordPress, delete or rename that file in the <code>%s</code> directory and it will be automatically deactivated.'), WP_PLUGIN_DIR) . '</p>';
 }
-
+$help .= '<p>' . __('<strong>For more information:</strong>') . '</p>';
+$help .= '<p>' . sprintf(__('<a href="%s">Documentation on Managing Plugins</a>'), 'http://codex.wordpress.org/Managing_Plugins#Plugin_Management') . '</p>';
+$help .= '<p>' . sprintf(__('<a href="%s">Support Forums</a>'), 'http://wordpress.org/support/') . '</p>';
 add_contextual_help($current_screen, $help);
 
 if ( is_multisite() && is_super_admin() ) {