web/wp-admin/includes/class-wp-theme-install-list-table.php
changeset 194 32102edaa81b
child 204 09a1c134465b
equal deleted inserted replaced
193:2f6f6f7551ca 194:32102edaa81b
       
     1 <?php
       
     2 /**
       
     3  * Theme Installer List Table class.
       
     4  *
       
     5  * @package WordPress
       
     6  * @subpackage List_Table
       
     7  * @since 3.1.0
       
     8  * @access private
       
     9  */
       
    10 class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
       
    11 
       
    12 	var $features = array();
       
    13 
       
    14 	function ajax_user_can() {
       
    15 		return current_user_can( 'install_themes' );
       
    16 	}
       
    17 
       
    18 	function prepare_items() {
       
    19 		include( ABSPATH . 'wp-admin/includes/theme-install.php' );
       
    20 
       
    21 		global $tabs, $tab, $paged, $type, $theme_field_defaults;
       
    22 		wp_reset_vars( array( 'tab' ) );
       
    23 
       
    24 		$search_terms = array();
       
    25 		$search_string = '';
       
    26 		if ( ! empty( $_REQUEST['s'] ) ){
       
    27 			$search_string = strtolower( stripslashes( $_REQUEST['s'] ) );
       
    28 			$search_terms = array_unique( array_filter( array_map( 'trim', explode( ',', $search_string ) ) ) );
       
    29 		}
       
    30 
       
    31 		if ( ! empty( $_REQUEST['features'] ) )
       
    32 			$this->features = $_REQUEST['features'];
       
    33 
       
    34 		$paged = $this->get_pagenum();
       
    35 
       
    36 		$per_page = 36;
       
    37 
       
    38 		// These are the tabs which are shown on the page,
       
    39 		$tabs = array();
       
    40 		$tabs['dashboard'] = __( 'Search' );
       
    41 		if ( 'search' == $tab )
       
    42 			$tabs['search']	= __( 'Search Results' );
       
    43 		$tabs['upload'] = __( 'Upload' );
       
    44 		$tabs['featured'] = _x( 'Featured','Theme Installer' );
       
    45 		//$tabs['popular']  = _x( 'Popular','Theme Installer' );
       
    46 		$tabs['new']      = _x( 'Newest','Theme Installer' );
       
    47 		$tabs['updated']  = _x( 'Recently Updated','Theme Installer' );
       
    48 
       
    49 		$nonmenu_tabs = array( 'theme-information' ); // Valid actions to perform which do not have a Menu item.
       
    50 
       
    51 		$tabs = apply_filters( 'install_themes_tabs', $tabs );
       
    52 		$nonmenu_tabs = apply_filters( 'install_themes_nonmenu_tabs', $nonmenu_tabs );
       
    53 
       
    54 		// If a non-valid menu tab has been selected, And its not a non-menu action.
       
    55 		if ( empty( $tab ) || ( ! isset( $tabs[ $tab ] ) && ! in_array( $tab, (array) $nonmenu_tabs ) ) )
       
    56 			$tab = key( $tabs );
       
    57 
       
    58 		$args = array( 'page' => $paged, 'per_page' => $per_page, 'fields' => $theme_field_defaults );
       
    59 
       
    60 		switch ( $tab ) {
       
    61 			case 'search':
       
    62 				$type = isset( $_REQUEST['type'] ) ? stripslashes( $_REQUEST['type'] ) : 'term';
       
    63 				switch ( $type ) {
       
    64 					case 'tag':
       
    65 						$args['tag'] = array_map( 'sanitize_key', $search_terms );
       
    66 						break;
       
    67 					case 'term':
       
    68 						$args['search'] = $search_string;
       
    69 						break;
       
    70 					case 'author':
       
    71 						$args['author'] = $search_string;
       
    72 						break;
       
    73 				}
       
    74 
       
    75 				if ( ! empty( $this->features ) ) {
       
    76 					$args['tag'] = $this->features;
       
    77 					$_REQUEST['s'] = implode( ',', $this->features );
       
    78 					$_REQUEST['type'] = 'tag';
       
    79 				}
       
    80 
       
    81 				add_action( 'install_themes_table_header', 'install_theme_search_form', 10, 0 );
       
    82 				break;
       
    83 
       
    84 			case 'featured':
       
    85 			//case 'popular':
       
    86 			case 'new':
       
    87 			case 'updated':
       
    88 				$args['browse'] = $tab;
       
    89 				break;
       
    90 
       
    91 			default:
       
    92 				$args = false;
       
    93 		}
       
    94 
       
    95 		if ( ! $args )
       
    96 			return;
       
    97 
       
    98 		$api = themes_api( 'query_themes', $args );
       
    99 
       
   100 		if ( is_wp_error( $api ) )
       
   101 			wp_die( $api->get_error_message() . '</p> <p><a href="#" onclick="document.location.reload(); return false;">' . __( 'Try again' ) . '</a>' );
       
   102 
       
   103 		$this->items = $api->themes;
       
   104 
       
   105 		$this->set_pagination_args( array(
       
   106 			'total_items' => $api->info['results'],
       
   107 			'per_page' => $per_page,
       
   108 			'infinite_scroll' => true,
       
   109 		) );
       
   110 	}
       
   111 
       
   112 	function no_items() {
       
   113 		_e( 'No themes match your request.' );
       
   114 	}
       
   115 
       
   116 	function get_views() {
       
   117 		global $tabs, $tab;
       
   118 
       
   119 		$display_tabs = array();
       
   120 		foreach ( (array) $tabs as $action => $text ) {
       
   121 			$class = ( $action == $tab ) ? ' class="current"' : '';
       
   122 			$href = self_admin_url('theme-install.php?tab=' . $action);
       
   123 			$display_tabs['theme-install-'.$action] = "<a href='$href'$class>$text</a>";
       
   124 		}
       
   125 
       
   126 		return $display_tabs;
       
   127 	}
       
   128 
       
   129 	function display() {
       
   130 		wp_nonce_field( "fetch-list-" . get_class( $this ), '_ajax_fetch_list_nonce' );
       
   131 ?>
       
   132 		<div class="tablenav top themes">
       
   133 			<div class="alignleft actions">
       
   134 				<?php do_action( 'install_themes_table_header' ); ?>
       
   135 			</div>
       
   136 			<?php $this->pagination( 'top' ); ?>
       
   137 			<img src="<?php echo esc_url( admin_url( 'images/wpspin_light.gif' ) ); ?>" class="ajax-loading list-ajax-loading" alt="" />
       
   138 			<br class="clear" />
       
   139 		</div>
       
   140 
       
   141 		<div id="availablethemes">
       
   142 			<?php $this->display_rows_or_placeholder(); ?>
       
   143 		</div>
       
   144 
       
   145 		<?php
       
   146 		parent::tablenav( 'bottom' );
       
   147 	}
       
   148 
       
   149 	function display_rows() {
       
   150 		$themes = $this->items;
       
   151 		foreach ( $themes as $theme ) {
       
   152 				?>
       
   153 				<div class="available-theme installable-theme"><?php
       
   154 					$this->single_row( $theme );
       
   155 				?></div>
       
   156 		<?php } // end foreach $theme_names
       
   157 
       
   158 		$this->theme_installer();
       
   159 	}
       
   160 
       
   161 	/*
       
   162 	 * Prints a theme from the WordPress.org API.
       
   163 	 *
       
   164 	 * @param object $theme An object that contains theme data returned by the WordPress.org API.
       
   165 	 *
       
   166 	 * Example theme data:
       
   167 	 *   object(stdClass)[59]
       
   168 	 *     public 'name' => string 'Magazine Basic' (length=14)
       
   169 	 *     public 'slug' => string 'magazine-basic' (length=14)
       
   170 	 *     public 'version' => string '1.1' (length=3)
       
   171 	 *     public 'author' => string 'tinkerpriest' (length=12)
       
   172 	 *     public 'preview_url' => string 'http://wp-themes.com/?magazine-basic' (length=36)
       
   173 	 *     public 'screenshot_url' => string 'http://wp-themes.com/wp-content/themes/magazine-basic/screenshot.png' (length=68)
       
   174 	 *     public 'rating' => float 80
       
   175 	 *     public 'num_ratings' => int 1
       
   176 	 *     public 'homepage' => string 'http://wordpress.org/extend/themes/magazine-basic' (length=49)
       
   177 	 *     public 'description' => string 'A basic magazine style layout with a fully customizable layout through a backend interface. Designed by <a href="http://bavotasan.com">c.bavota</a> of <a href="http://tinkerpriestmedia.com">Tinker Priest Media</a>.' (length=214)
       
   178 	 *     public 'download_link' => string 'http://wordpress.org/extend/themes/download/magazine-basic.1.1.zip' (length=66)
       
   179 	 */
       
   180 	function single_row( $theme ) {
       
   181 		global $themes_allowedtags;
       
   182 
       
   183 		if ( empty( $theme ) )
       
   184 			return;
       
   185 
       
   186 		$name   = wp_kses( $theme->name,   $themes_allowedtags );
       
   187 		$author = wp_kses( $theme->author, $themes_allowedtags );
       
   188 
       
   189 		$preview_title = sprintf( __('Preview &#8220;%s&#8221;'), $name );
       
   190 		$preview_url   = add_query_arg( array(
       
   191 			'tab'   => 'theme-information',
       
   192 			'theme' => $theme->slug,
       
   193 		) );
       
   194 
       
   195 		$actions = array();
       
   196 
       
   197 		$install_url = add_query_arg( array(
       
   198 			'action' => 'install-theme',
       
   199 			'theme'  => $theme->slug,
       
   200 		), self_admin_url( 'update.php' ) );
       
   201 
       
   202 		$update_url = add_query_arg( array(
       
   203 			'action' => 'upgrade-theme',
       
   204 			'theme'  => $theme->slug,
       
   205 		), self_admin_url( 'update.php' ) );
       
   206 
       
   207 		$status = $this->_get_theme_status( $theme );
       
   208 
       
   209 		switch ( $status ) {
       
   210 			default:
       
   211 			case 'install':
       
   212 				$actions[] = '<a class="install-now" href="' . esc_url( wp_nonce_url( $install_url, 'install-theme_' . $theme->slug ) ) . '" title="' . esc_attr( sprintf( __( 'Install %s' ), $name ) ) . '">' . __( 'Install Now' ) . '</a>';
       
   213 				break;
       
   214 			case 'update_available':
       
   215 				$actions[] = '<a class="install-now" href="' . esc_url( wp_nonce_url( $update_url, 'upgrade-theme_' . $theme->slug ) ) . '" title="' . esc_attr( sprintf( __( 'Update to version %s' ), $theme->version ) ) . '">' . __( 'Update' ) . '</a>';
       
   216 				break;
       
   217 			case 'newer_installed':
       
   218 			case 'latest_installed':
       
   219 				$actions[] = '<span class="install-now" title="' . esc_attr__( 'This theme is already installed and is up to date' ) . '">' . _x( 'Installed', 'theme' ) . '</span>';
       
   220 				break;
       
   221 		}
       
   222 
       
   223 		$actions[] = '<a class="install-theme-preview" href="' . esc_url( $preview_url ) . '" title="' . esc_attr( sprintf( __( 'Preview %s' ), $name ) ) . '">' . __( 'Preview' ) . '</a>';
       
   224 
       
   225 		$actions = apply_filters( 'theme_install_actions', $actions, $theme );
       
   226 
       
   227 		?>
       
   228 		<a class="screenshot install-theme-preview" href="<?php echo esc_url( $preview_url ); ?>" title="<?php echo esc_attr( $preview_title ); ?>">
       
   229 			<img src='<?php echo esc_url( $theme->screenshot_url ); ?>' width='150' />
       
   230 		</a>
       
   231 
       
   232 		<h3><?php echo $name; ?></h3>
       
   233 		<div class="theme-author"><?php printf( __( 'By %s' ), $author ); ?></div>
       
   234 
       
   235 		<div class="action-links">
       
   236 			<ul>
       
   237 				<?php foreach ( $actions as $action ): ?>
       
   238 					<li><?php echo $action; ?></li>
       
   239 				<?php endforeach; ?>
       
   240 				<li class="hide-if-no-js"><a href="#" class="theme-detail" tabindex='4'><?php _e('Details') ?></a></li>
       
   241 			</ul>
       
   242 		</div>
       
   243 
       
   244 		<?php
       
   245 		$this->install_theme_info( $theme );
       
   246 	}
       
   247 
       
   248 	/*
       
   249 	 * Prints the wrapper for the theme installer.
       
   250 	 */
       
   251 	function theme_installer() {
       
   252 		?>
       
   253 		<div id="theme-installer" class="wp-full-overlay expanded">
       
   254 			<div class="wp-full-overlay-sidebar">
       
   255 				<div class="wp-full-overlay-header">
       
   256 					<a href="#" class="close-full-overlay"><?php _e( '&larr; Close' ); ?></a>
       
   257 				</div>
       
   258 				<div class="wp-full-overlay-sidebar-content">
       
   259 					<div class="install-theme-info"></div>
       
   260 				</div>
       
   261 				<div class="wp-full-overlay-footer">
       
   262 					<a href="#" class="collapse-sidebar button-secondary" title="<?php esc_attr_e('Collapse Sidebar'); ?>">
       
   263 						<span class="collapse-sidebar-label"><?php _e('Collapse'); ?></span>
       
   264 						<span class="collapse-sidebar-arrow"></span>
       
   265 					</a>
       
   266 				</div>
       
   267 			</div>
       
   268 			<div class="wp-full-overlay-main"></div>
       
   269 		</div>
       
   270 		<?php
       
   271 	}
       
   272 
       
   273 	/*
       
   274 	 * Prints the wrapper for the theme installer with a provided theme's data.
       
   275 	 * Used to make the theme installer work for no-js.
       
   276 	 *
       
   277 	 * @param object $theme - A WordPress.org Theme API object.
       
   278 	 */
       
   279 	function theme_installer_single( $theme ) {
       
   280 		?>
       
   281 		<div id="theme-installer" class="wp-full-overlay single-theme">
       
   282 			<div class="wp-full-overlay-sidebar">
       
   283 				<?php $this->install_theme_info( $theme ); ?>
       
   284 			</div>
       
   285 			<div class="wp-full-overlay-main">
       
   286 				<iframe src="<?php echo esc_url( $theme->preview_url ); ?>"></iframe>
       
   287 			</div>
       
   288 		</div>
       
   289 		<?php
       
   290 	}
       
   291 
       
   292 	/*
       
   293 	 * Prints the info for a theme (to be used in the theme installer modal).
       
   294 	 *
       
   295 	 * @param object $theme - A WordPress.org Theme API object.
       
   296 	 */
       
   297 	function install_theme_info( $theme ) {
       
   298 		global $themes_allowedtags;
       
   299 
       
   300 		if ( empty( $theme ) )
       
   301 			return;
       
   302 
       
   303 		$name   = wp_kses( $theme->name,   $themes_allowedtags );
       
   304 		$author = wp_kses( $theme->author, $themes_allowedtags );
       
   305 
       
   306 		$num_ratings = sprintf( _n( '(based on %s rating)', '(based on %s ratings)', $theme->num_ratings ), number_format_i18n( $theme->num_ratings ) );
       
   307 
       
   308 		$install_url = add_query_arg( array(
       
   309 			'action' => 'install-theme',
       
   310 			'theme'  => $theme->slug,
       
   311 		), self_admin_url( 'update.php' ) );
       
   312 
       
   313 		$update_url = add_query_arg( array(
       
   314 			'action' => 'upgrade-theme',
       
   315 			'theme'  => $theme->slug,
       
   316 		), self_admin_url( 'update.php' ) );
       
   317 
       
   318 		$status = $this->_get_theme_status( $theme );
       
   319 
       
   320 		?>
       
   321 		<div class="install-theme-info"><?php
       
   322 			switch ( $status ) {
       
   323 				default:
       
   324 				case 'install':
       
   325 					echo '<a class="theme-install button-primary" href="' . esc_url( wp_nonce_url( $install_url, 'install-theme_' . $theme->slug ) ) . '">' . __( 'Install' ) . '</a>';
       
   326 					break;
       
   327 				case 'update_available':
       
   328 					echo '<a class="theme-install button-primary" href="' . esc_url( wp_nonce_url( $update_url, 'upgrade-theme_' . $theme->slug ) ) . '" title="' . esc_attr( sprintf( __( 'Update to version %s' ), $theme->version ) ) . '">' . __( 'Update' ) . '</a>';
       
   329 					break;
       
   330 				case 'newer_installed':
       
   331 				case 'latest_installed':
       
   332 					echo '<span class="theme-install" title="' . esc_attr__( 'This theme is already installed and is up to date' ) . '">' . _x( 'Installed', 'theme' ) . '</span>';
       
   333 					break;
       
   334 			} ?>
       
   335 			<h3 class="theme-name"><?php echo $name; ?></h3>
       
   336 			<span class="theme-by"><?php printf( __( 'By %s' ), $author ); ?></span>
       
   337 			<?php if ( isset( $theme->screenshot_url ) ): ?>
       
   338 				<img class="theme-screenshot" src="<?php echo esc_url( $theme->screenshot_url ); ?>" />
       
   339 			<?php endif; ?>
       
   340 			<div class="theme-details">
       
   341 				<div class="star-holder" title="<?php echo esc_attr( $num_ratings ); ?>">
       
   342 					<div class="star-rating" style="width:<?php echo esc_attr( intval( $theme->rating ) . 'px' ); ?>;"></div>
       
   343 				</div>
       
   344 				<div class="theme-version">
       
   345 					<strong><?php _e('Version:') ?> </strong>
       
   346 					<?php echo wp_kses( $theme->version, $themes_allowedtags ); ?>
       
   347 				</div>
       
   348 				<div class="theme-description">
       
   349 					<?php echo wp_kses( $theme->description, $themes_allowedtags ); ?>
       
   350 				</div>
       
   351 			</div>
       
   352 			<input class="theme-preview-url" type="hidden" value="<?php echo esc_url( $theme->preview_url ); ?>" />
       
   353 		</div>
       
   354 		<?php
       
   355 	}
       
   356 
       
   357 	/**
       
   358 	 * Send required variables to JavaScript land
       
   359 	 *
       
   360 	 * @since 3.4
       
   361 	 * @access private
       
   362 	 *
       
   363 	 * @uses $tab Global; current tab within Themes->Install screen
       
   364 	 * @uses $type Global; type of search.
       
   365 	 */
       
   366 	function _js_vars() {
       
   367 		global $tab, $type;
       
   368 		parent::_js_vars( compact( 'tab', 'type' ) );
       
   369 	}
       
   370 
       
   371 	/**
       
   372 	 * Check to see if the theme is already installed.
       
   373 	 *
       
   374 	 * @since 3.4
       
   375 	 * @access private
       
   376 	 *
       
   377 	 * @param object $theme - A WordPress.org Theme API object.
       
   378 	 * @return string Theme status.
       
   379 	 */
       
   380 	private function _get_theme_status( $theme ) {
       
   381 		$status = 'install';
       
   382 
       
   383 		$installed_theme = wp_get_theme( $theme->slug );
       
   384 		if ( $installed_theme->exists() ) {
       
   385 			if ( version_compare( $installed_theme->get('Version'), $theme->version, '=' ) )
       
   386 				$status = 'latest_installed';
       
   387 			elseif ( version_compare( $installed_theme->get('Version'), $theme->version, '>' ) )
       
   388 				$status = 'newer_installed';
       
   389 			else
       
   390 				$status = 'update_available';
       
   391 		}
       
   392 
       
   393 		return $status;
       
   394 	}
       
   395 }