From 013d15ebd41981e433121014675d744e63bfe29d Mon Sep 17 00:00:00 2001 From: ryan Date: Wed, 26 May 2010 18:27:13 +0000 Subject: [PATCH] Help for Appearance screens. Props duck_, jane. see #13467 git-svn-id: http://svn.automattic.com/wordpress/trunk@14951 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-admin/nav-menus.php | 9 +++++++++ wp-admin/theme-editor.php | 14 ++++++++++++++ wp-admin/theme-install.php | 8 +++++++- wp-admin/themes.php | 14 ++++++++------ wp-admin/widgets.php | 12 ++++++++---- 5 files changed, 46 insertions(+), 11 deletions(-) diff --git a/wp-admin/nav-menus.php b/wp-admin/nav-menus.php index 7cbdd38418..b29a757f50 100644 --- a/wp-admin/nav-menus.php +++ b/wp-admin/nav-menus.php @@ -435,6 +435,15 @@ if ( current_theme_supports('nav-menus') ) { wp_initial_nav_menu_meta_boxes(); +$help = '

' . __('This feature is new in version 3.0; to use a custom menu in place of your theme’s default menus, support for this feature must be registered in the theme’s functions.php file. If your theme does not support the custom menus feature yet (the new default theme Twenty Ten, does), you can learn about adding support yourself by following the below link.') . '

'; +$help .= '

' . __('You can create custom menus for your site. These menus may contain links to pages, categories, custom links or other content types (use the Screen Options tab to decide which ones to show on the screen). You can specify a different navigation label for a menu item as well as other attributes. You can create multiple menus. If your theme includes more than one menu, you can choose which custom menu to associate with each. You can also use custom menus in conjunction with the Custom Menus widget.') . '

'; +$help .= '

' . __('To create a new custom menu, click on the + tab, give the menu a name, and click Create Menu. Next, add menu items from the appropriate boxes. You’ll be able to edit the information for each menu item, and can drag and drop to put them in order. You can also drag a menu item a little to the right to make it a submenu, to create menus with hierarchy. You’ll see when the position of the drop target shifts over to create the nested placement. Don’t forget to click Save when you’re finished.') . '

'; +$help .= '

' . __('For more information:') . '

'; +$help .= '

' . sprintf(__('Menus Documentation'), 'http://codex.wordpress.org/Appearance_Menus_SubPanel') . '

'; +$help .= '

' . sprintf(__('Support Forums'), 'http://wordpress.org/support/') . '

'; + +add_contextual_help($current_screen, $help); + // Get the admin header require_once( 'admin-header.php' ); ?> diff --git a/wp-admin/theme-editor.php b/wp-admin/theme-editor.php index 0aeed384c3..82686face6 100644 --- a/wp-admin/theme-editor.php +++ b/wp-admin/theme-editor.php @@ -15,6 +15,20 @@ if ( !current_user_can('edit_themes') ) $title = __("Edit Themes"); $parent_file = 'themes.php'; +$help = '

' . __('You can use the Theme Editor to edit the individual CSS and PHP files which make up your theme.') . '

'; +$help .= '

' . __('Begin by choosing a theme to edit from the dropdown menu and clicking Select. A list then appears of all the template files. Clicking once on any file name causes the file to appear in the large Editor box.') . '

'; +$help .= '

' . __('For PHP files, you can use the Documentation dropdown to select from functions recognized in that file. Lookup takes you to a web page with reference material about that particular function.') . '

'; +$help .= '

' . __('After typing in your edits, click Update File.') . '

'; +$help .= '

' . __('Advice: think very carefully about your site crashing if you are live-editing the theme currently in use.') . '

'; +$help .= '

' . sprintf(__('Upgrading to a newer version of the same theme will override changes made here. To avoid this, consider creating a child theme instead.'), 'http://codex.wordpress.org/Child_Themes') . '

'; +$help .= '

' . __('For more information:') . '

'; +$help .= '

' . sprintf(__('Theme Development Documentation'), 'http://codex.wordpress.org/Theme_Development') . '

'; +$help .= '

' . sprintf(__('Documentation on Using Themes'), 'http://codex.wordpress.org/Using_Themes') . '

'; +$help .= '

' . sprintf(__('Documentation on Editing Files'), 'http://codex.wordpress.org/Editing_Files') . '

'; +$help .= '

' . sprintf(__('Template Tags Documentation'), 'http://codex.wordpress.org/Template_Tags') . '

'; +$help .= '

' . sprintf(__('Support Forums'), 'http://wordpress.org/support/') . '

'; +add_contextual_help($current_screen, $help); + wp_reset_vars(array('action', 'redirect', 'profile', 'error', 'warning', 'a', 'file', 'theme', 'dir')); wp_admin_css( 'theme-editor' ); diff --git a/wp-admin/theme-install.php b/wp-admin/theme-install.php index 43c1dbcb6c..1cb36d5127 100644 --- a/wp-admin/theme-install.php +++ b/wp-admin/theme-install.php @@ -53,7 +53,13 @@ $body_id = $tab; do_action('install_themes_pre_' . $tab); //Used to override the general interface, Eg, install or theme information. -add_contextual_help($current_screen, plugins_search_help()); +$help = '

' . __('You can find additional themes for your site by using the Theme Browser/Installer on this screen, which will display themes from the WordPress.org theme repository. These themes are designed and developed by third parties, are available free of charge, and are licensed under the GNU General Public License, version 2, just like WordPress.') . '

'; +$help .= '

' . __('You can Search for themes by keyword, author, or tag, or can get more specific and search by criteria listed in the feature filter. Alternately, you can browse the themes that are Featured, Newest, or Recently Updated. When you find a theme you like, you can preview it or install it.') . '

'; +$help .= '

' . __('You can Upload a theme manually if you have already downloaded its ZIP archive onto your computer (make sure it is from a trusted and original source). You can also do it the old-fashioned way and copy a downloaded theme’s folder via FTP into your wp-content/themes directory.') . '

'; +$help .= '

' . __('For more information:') . '

'; +$help .= '

' . sprintf(__('Documentation on Using Themes'), 'http://codex.wordpress.org/Using_Themes#Adding_New_Themes') . '

'; +$help .= '

' . sprintf(__('Support Forums'), 'http://wordpress.org/support/') . '

'; +add_contextual_help($current_screen, $help); include('./admin-header.php'); ?> diff --git a/wp-admin/themes.php b/wp-admin/themes.php index 004d62fdc3..028550ec57 100644 --- a/wp-admin/themes.php +++ b/wp-admin/themes.php @@ -33,12 +33,14 @@ $parent_file = 'themes.php'; if ( current_user_can( 'switch_themes' ) ) : -$help = '

' . __('Themes give your WordPress style. Once a theme is installed, you may preview it, activate it or deactivate it here.') . '

'; -if ( current_user_can('install_themes') ) { - $help .= '

' . sprintf(__('You can find additional themes for your site by using the new Theme Browser/Installer functionality or by browsing the WordPress Theme Directory directly and installing manually. To install a theme manually, upload its ZIP archive with the new uploader or copy its folder via FTP into your wp-content/themes directory.'), 'theme-install.php', 'theme-install.php?tab=upload' ) . '

'; - $help .= '

' . __('Once a theme is uploaded, you should see it on this screen.') . '

' ; -} - +$help = '

' . __('Aside from the default theme included with your WordPress installation, themes are designed and developed by third parties.') . '

'; +$help .= '

' . __('You can see your active theme at the top of the screen. Below are the other themes you have installed that are not currently in use. You can see what your site would look like with one of these themes by clicking the Preview link. To change themes, click the Activate link.') . '

'; +if ( current_user_can('install_themes') ) + $help .= '

' . sprintf(__('If you would like to see more themes to choose from, click on the "Install Themes" tab and you will be able to browse or search for additional themes from the WordPress.org theme repository. Themes in the WordPress.org theme repository are designed and developed by third parties, and are licensed under the GNU General Public License, version 2, just like WordPress. Oh, and they’re free!'), 'http://wordpress.org/extend/themes/') . '

'; + +$help .= '

' . __('For more information:') . '

'; +$help .= '

' . sprintf(__('Documentation on Using Themes'), 'http://codex.wordpress.org/Using_Themes') . '

'; +$help .= '

' . sprintf(__('Support Forums'), 'http://wordpress.org/support/') . '

'; add_contextual_help($current_screen, $help); add_thickbox(); diff --git a/wp-admin/widgets.php b/wp-admin/widgets.php index 07035342d4..4d74e83889 100644 --- a/wp-admin/widgets.php +++ b/wp-admin/widgets.php @@ -34,11 +34,15 @@ $title = __( 'Widgets' ); $parent_file = 'themes.php'; $help = ' -

' . __('Widgets are added and arranged by simple drag ’n’ drop. If you hover your mouse over the titlebar of a widget, you’ll see a 4-arrow cursor which indicates that the widget is movable. Click on the titlebar, hold down the mouse button and drag the widget to a sidebar. As you drag, you’ll see a dotted box that also moves. This box shows where the widget will go once you drop it.') . '

-

' . __('To remove a widget from a sidebar, drag it back to Available Widgets or click on the arrow on its titlebar to reveal its settings, and then click Remove.') . '

-

' . __('To remove a widget from a sidebar and keep its configuration, drag it to Inactive Widgets.') . '

-

' . __('The Inactive Widgets area stores widgets that are configured but not curently used. If you change themes and the new theme has fewer sidebars than the old, all extra widgets will be stored to Inactive Widgets automatically.') . '

+

' . __('Widgets are independent sections of content that can be placed into any widgetized area provided by your theme (commonly called sidebars). To populate your sidebars/widget areas with individual widgets, drag and drop the title bars into the desired area. By default, only the first widget area is expanded. To populate additional widget areas, click on their title bars to expand them.') . '

+

' . __('Available Widgets section contains all the widgets you can choose from. Once you drag a widget into a sidebar, it will open to allow you to configure its settings. When you are happy with the widget settings, click the Save button and the widget will go live on your site. If you click Delete, it will remove the widget.') . '

+

' . __('If you want to remove the widget but save its setting for possible future use, just drag it into the Inactive Widgets area. You can add them back anytime from there. This is especially helpful when you switch to a theme with less or different widget areas.') . '

+

' . __('Widgets may be used multiple times. You can give each widget a title, to display on your site, but it’s not required.') . '

+

' . __('Enabling Accessibility Mode, via Screen Options, allows you to use Add and Edit buttons instead of using drag and drop.') . '

'; +$help .= '

' . __('For more information:') . '

'; +$help .= '

' . sprintf(__('Widgets Documentation'), 'http://codex.wordpress.org/Appearance_Widgets_SubPanel') . '

'; +$help .= '

' . sprintf(__('Support Forums'), 'http://wordpress.org/support/') . '

'; add_contextual_help($current_screen, $help); // register the inactive_widgets area as sidebar