X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/8f374b7233bc2815ccc387e448d208c5434eb961..refs/tags/wordpress-4.3:/wp-admin/includes/class-wp-theme-install-list-table.php diff --git a/wp-admin/includes/class-wp-theme-install-list-table.php b/wp-admin/includes/class-wp-theme-install-list-table.php index 47175243..427c5391 100644 --- a/wp-admin/includes/class-wp-theme-install-list-table.php +++ b/wp-admin/includes/class-wp-theme-install-list-table.php @@ -9,13 +9,25 @@ */ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { - var $features = array(); + public $features = array(); - function ajax_user_can() { + /** + * + * @return bool + */ + public function ajax_user_can() { return current_user_can( 'install_themes' ); } - function prepare_items() { + /** + * + * @global array $tabs + * @global string $tab + * @global int $paged + * @global string $type + * @global array $theme_field_defaults + */ + public function prepare_items() { include( ABSPATH . 'wp-admin/includes/theme-install.php' ); global $tabs, $tab, $paged, $type, $theme_field_defaults; @@ -24,7 +36,7 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { $search_terms = array(); $search_string = ''; if ( ! empty( $_REQUEST['s'] ) ){ - $search_string = strtolower( stripslashes( $_REQUEST['s'] ) ); + $search_string = strtolower( wp_unslash( $_REQUEST['s'] ) ); $search_terms = array_unique( array_filter( array_map( 'trim', explode( ',', $search_string ) ) ) ); } @@ -41,17 +53,27 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { if ( 'search' == $tab ) $tabs['search'] = __( 'Search Results' ); $tabs['upload'] = __( 'Upload' ); - $tabs['featured'] = _x( 'Featured','Theme Installer' ); - //$tabs['popular'] = _x( 'Popular','Theme Installer' ); - $tabs['new'] = _x( 'Newest','Theme Installer' ); - $tabs['updated'] = _x( 'Recently Updated','Theme Installer' ); + $tabs['featured'] = _x( 'Featured', 'themes' ); + //$tabs['popular'] = _x( 'Popular', 'themes' ); + $tabs['new'] = _x( 'Latest', 'themes' ); + $tabs['updated'] = _x( 'Recently Updated', 'themes' ); $nonmenu_tabs = array( 'theme-information' ); // Valid actions to perform which do not have a Menu item. + /** This filter is documented in wp-admin/theme-install.php */ $tabs = apply_filters( 'install_themes_tabs', $tabs ); + + /** + * Filter tabs not associated with a menu item on the Install Themes screen. + * + * @since 2.8.0 + * + * @param array $nonmenu_tabs The tabs that don't have a menu item on + * the Install Themes screen. + */ $nonmenu_tabs = apply_filters( 'install_themes_nonmenu_tabs', $nonmenu_tabs ); - // If a non-valid menu tab has been selected, And its not a non-menu action. + // If a non-valid menu tab has been selected, And it's not a non-menu action. if ( empty( $tab ) || ( ! isset( $tabs[ $tab ] ) && ! in_array( $tab, (array) $nonmenu_tabs ) ) ) $tab = key( $tabs ); @@ -59,7 +81,7 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { switch ( $tab ) { case 'search': - $type = isset( $_REQUEST['type'] ) ? stripslashes( $_REQUEST['type'] ) : 'term'; + $type = isset( $_REQUEST['type'] ) ? wp_unslash( $_REQUEST['type'] ) : 'term'; switch ( $type ) { case 'tag': $args['tag'] = array_map( 'sanitize_key', $search_terms ); @@ -82,7 +104,7 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { break; case 'featured': - //case 'popular': + // case 'popular': case 'new': case 'updated': $args['browse'] = $tab; @@ -90,8 +112,22 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { default: $args = false; + break; } + /** + * Filter API request arguments for each Install Themes screen tab. + * + * The dynamic portion of the hook name, `$tab`, refers to the theme install + * tabs. Default tabs are 'dashboard', 'search', 'upload', 'featured', + * 'new', and 'updated'. + * + * @since 3.7.0 + * + * @param array $args An array of themes API arguments. + */ + $args = apply_filters( 'install_themes_table_api_args_' . $tab, $args ); + if ( ! $args ) return; @@ -104,16 +140,25 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { $this->set_pagination_args( array( 'total_items' => $api->info['results'], - 'per_page' => $per_page, + 'per_page' => $args['per_page'], 'infinite_scroll' => true, ) ); } - function no_items() { + /** + * @access public + */ + public function no_items() { _e( 'No themes match your request.' ); } - function get_views() { + /** + * + * @global array $tabs + * @global string $tab + * @return array + */ + protected function get_views() { global $tabs, $tab; $display_tabs = array(); @@ -126,15 +171,24 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { return $display_tabs; } - function display() { + /** + * @access public + */ + public function display() { wp_nonce_field( "fetch-list-" . get_class( $this ), '_ajax_fetch_list_nonce' ); ?>
- +
pagination( 'top' ); ?> -
@@ -143,10 +197,13 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { tablenav( 'bottom' ); } - function display_rows() { + /** + * @access public + */ + public function display_rows() { $themes = $this->items; foreach ( $themes as $theme ) { ?> @@ -158,26 +215,28 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { $this->theme_installer(); } - /* + /** * Prints a theme from the WordPress.org API. * + * @global array $themes_allowedtags + * * @param object $theme An object that contains theme data returned by the WordPress.org API. * * Example theme data: * object(stdClass)[59] - * public 'name' => string 'Magazine Basic' (length=14) - * public 'slug' => string 'magazine-basic' (length=14) - * public 'version' => string '1.1' (length=3) - * public 'author' => string 'tinkerpriest' (length=12) - * public 'preview_url' => string 'http://wp-themes.com/?magazine-basic' (length=36) - * public 'screenshot_url' => string 'http://wp-themes.com/wp-content/themes/magazine-basic/screenshot.png' (length=68) + * public 'name' => string 'Magazine Basic' + * public 'slug' => string 'magazine-basic' + * public 'version' => string '1.1' + * public 'author' => string 'tinkerpriest' + * public 'preview_url' => string 'http://wp-themes.com/?magazine-basic' + * public 'screenshot_url' => string 'http://wp-themes.com/wp-content/themes/magazine-basic/screenshot.png' * public 'rating' => float 80 * public 'num_ratings' => int 1 - * public 'homepage' => string 'http://wordpress.org/extend/themes/magazine-basic' (length=49) - * public 'description' => string 'A basic magazine style layout with a fully customizable layout through a backend interface. Designed by c.bavota of Tinker Priest Media.' (length=214) - * public 'download_link' => string 'http://wordpress.org/extend/themes/download/magazine-basic.1.1.zip' (length=66) + * public 'homepage' => string 'http://wordpress.org/themes/magazine-basic' + * public 'description' => string 'A basic magazine style layout with a fully customizable layout through a backend interface. Designed by c.bavota of Tinker Priest Media.' + * public 'download_link' => string 'http://wordpress.org/themes/download/magazine-basic.1.1.zip' */ - function single_row( $theme ) { + public function single_row( $theme ) { global $themes_allowedtags; if ( empty( $theme ) ) @@ -190,7 +249,7 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { $preview_url = add_query_arg( array( 'tab' => 'theme-information', 'theme' => $theme->slug, - ) ); + ), self_admin_url( 'theme-install.php' ) ); $actions = array(); @@ -207,10 +266,6 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { $status = $this->_get_theme_status( $theme ); switch ( $status ) { - default: - case 'install': - $actions[] = '' . __( 'Install Now' ) . ''; - break; case 'update_available': $actions[] = '' . __( 'Update' ) . ''; break; @@ -218,15 +273,28 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { case 'latest_installed': $actions[] = '' . _x( 'Installed', 'theme' ) . ''; break; + case 'install': + default: + $actions[] = '' . __( 'Install Now' ) . ''; + break; } $actions[] = '' . __( 'Preview' ) . ''; + /** + * Filter the install action links for a theme in the Install Themes list table. + * + * @since 3.4.0 + * + * @param array $actions An array of theme action hyperlinks. Defaults are + * links to Install Now, Preview, and Details. + * @param WP_Theme $theme Theme object. + */ $actions = apply_filters( 'theme_install_actions', $actions, $theme ); ?> - +

@@ -237,7 +305,7 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
  • -
  • +
  • @@ -245,24 +313,25 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { $this->install_theme_info( $theme ); } - /* + /** * Prints the wrapper for the theme installer. */ - function theme_installer() { + public function theme_installer() { ?>
    - + +
    @@ -270,13 +339,13 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
    @@ -289,12 +358,14 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { name, $themes_allowedtags ); $author = wp_kses( $theme->author, $themes_allowedtags ); - $num_ratings = sprintf( _n( '(based on %s rating)', '(based on %s ratings)', $theme->num_ratings ), number_format_i18n( $theme->num_ratings ) ); - $install_url = add_query_arg( array( 'action' => 'install-theme', 'theme' => $theme->slug, @@ -320,10 +389,6 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { ?>
    slug ) ) . '">' . __( 'Install' ) . ''; - break; case 'update_available': echo '' . __( 'Update' ) . ''; break; @@ -331,6 +396,10 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { case 'latest_installed': echo '' . _x( 'Installed', 'theme' ) . ''; break; + case 'install': + default: + echo '' . __( 'Install' ) . ''; + break; } ?>

    @@ -338,9 +407,7 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
    -
    -
    -
    + $theme->rating, 'type' => 'percent', 'number' => $theme->num_ratings ) ); ?>
    version, $themes_allowedtags ); ?> @@ -357,13 +424,15 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { /** * Send required variables to JavaScript land * - * @since 3.4 - * @access private + * @since 3.4.0 + * @access public + * + * @global string $tab Current tab within Themes->Install screen + * @global string $type Type of search. * - * @uses $tab Global; current tab within Themes->Install screen - * @uses $type Global; type of search. + * @param array $extra_args Unused. */ - function _js_vars() { + public function _js_vars( $extra_args = array() ) { global $tab, $type; parent::_js_vars( compact( 'tab', 'type' ) ); } @@ -371,7 +440,7 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table { /** * Check to see if the theme is already installed. * - * @since 3.4 + * @since 3.4.0 * @access private * * @param object $theme - A WordPress.org Theme API object.