2009-02-11 18:10:11 -05:00
< ? php
/**
* WordPress Theme Install Administration API
*
* @ package WordPress
* @ subpackage Administration
*/
2009-02-18 16:55:00 -05:00
$themes_allowedtags = array ( 'a' => array ( 'href' => array (), 'title' => array (), 'target' => array ()),
2009-02-27 16:22:49 -05:00
'abbr' => array ( 'title' => array ()), 'acronym' => array ( 'title' => array ()),
'code' => array (), 'pre' => array (), 'em' => array (), 'strong' => array (),
'div' => array (), 'p' => array (), 'ul' => array (), 'ol' => array (), 'li' => array (),
'h1' => array (), 'h2' => array (), 'h3' => array (), 'h4' => array (), 'h5' => array (), 'h6' => array (),
'img' => array ( 'src' => array (), 'class' => array (), 'alt' => array ())
);
$theme_field_defaults = array ( 'description' => true , 'sections' => false , 'tested' => true , 'requires' => true ,
'rating' => true , 'downloaded' => true , 'downloadlink' => true , 'last_updated' => true , 'homepage' => true ,
'tags' => true , 'num_ratings' => true
);
2009-03-17 22:43:45 -04:00
2009-02-11 18:10:11 -05:00
/**
2009-04-07 19:58:35 -04:00
* Retrieve list of WordPress theme features ( aka theme tags )
2009-02-11 18:10:11 -05:00
*
* @ since 2.8 . 0
*
2011-12-14 12:36:38 -05:00
* @ deprecated since 3.1 . 0 Use get_theme_feature_list () instead .
2010-09-24 11:28:28 -04:00
*
2009-02-11 18:10:11 -05:00
* @ return array
*/
2009-04-07 05:44:41 -04:00
function install_themes_feature_list ( ) {
2009-04-07 17:44:23 -04:00
if ( ! $cache = get_transient ( 'wporg_theme_feature_list' ) )
2011-12-14 12:36:38 -05:00
set_transient ( 'wporg_theme_feature_list' , array ( ), 10800 );
2009-02-11 18:10:11 -05:00
2011-12-14 12:36:38 -05:00
if ( $cache )
2009-04-07 17:44:23 -04:00
return $cache ;
2009-02-11 18:10:11 -05:00
2009-04-07 05:44:41 -04:00
$feature_list = themes_api ( 'feature_list' , array ( ) );
if ( is_wp_error ( $feature_list ) )
return $features ;
2009-02-11 18:10:11 -05:00
2009-04-07 17:44:23 -04:00
set_transient ( 'wporg_theme_feature_list' , $feature_list , 10800 );
2009-02-11 18:10:11 -05:00
2009-04-07 05:44:41 -04:00
return $feature_list ;
2009-02-11 18:10:11 -05:00
}
2009-04-07 05:44:41 -04:00
/**
* Display search form for searching themes .
*
* @ since 2.8 . 0
*/
function install_theme_search_form () {
$type = isset ( $_REQUEST [ 'type' ] ) ? stripslashes ( $_REQUEST [ 'type' ] ) : '' ;
$term = isset ( $_REQUEST [ 's' ] ) ? stripslashes ( $_REQUEST [ 's' ] ) : '' ;
2009-02-11 18:10:11 -05:00
?>
2009-03-19 20:14:57 -04:00
< p class = " install-help " >< ? php _e ( 'Search for themes by keyword, author, or tag.' ) ?> </p>
2009-02-11 18:10:11 -05:00
2010-08-11 17:54:51 -04:00
< form id = " search-themes " method = " get " action = " " >
< input type = " hidden " name = " tab " value = " search " />
2009-04-07 05:44:41 -04:00
< select name = " type " id = " typeselector " >
< option value = " term " < ? php selected ( 'term' , $type ) ?> ><?php _e('Term'); ?></option>
< option value = " author " < ? php selected ( 'author' , $type ) ?> ><?php _e('Author'); ?></option>
2010-05-14 17:46:25 -04:00
< option value = " tag " < ? php selected ( 'tag' , $type ) ?> ><?php _ex('Tag', 'Theme Installer'); ?></option>
2009-04-07 05:44:41 -04:00
</ select >
2009-05-05 15:43:53 -04:00
< input type = " text " name = " s " size = " 30 " value = " <?php echo esc_attr( $term ) ?> " />
2010-10-28 17:56:43 -04:00
< ? php submit_button ( __ ( 'Search' ), 'button' , 'search' , false ); ?>
2009-04-07 05:44:41 -04:00
</ form >
< ? php
2009-02-11 18:10:11 -05:00
}
/**
2009-04-07 05:44:41 -04:00
* Display tags filter for themes .
2009-02-11 18:10:11 -05:00
*
* @ since 2.8 . 0
*/
2009-04-07 05:44:41 -04:00
function install_themes_dashboard () {
install_theme_search_form ();
?>
< h4 >< ? php _e ( 'Feature Filter' ) ?> </h4>
2010-10-21 13:06:52 -04:00
< form method = " post " action = " <?php echo self_admin_url( 'theme-install.php?tab=search' ); ?> " >
2009-04-07 05:44:41 -04:00
< p class = " install-help " >< ? php _e ( 'Find a theme based on specific features' ) ?> </p>
2009-02-26 18:35:38 -05:00
< ? php
2010-09-24 11:28:28 -04:00
$feature_list = get_theme_feature_list ( );
2009-04-07 05:44:41 -04:00
echo '<div class="feature-filter">' ;
foreach ( ( array ) $feature_list as $feature_name => $features ) {
2009-05-18 11:11:07 -04:00
$feature_name = esc_html ( $feature_name );
2009-04-07 13:02:25 -04:00
echo '<div class="feature-name">' . $feature_name . '</div>' ;
2009-04-07 05:44:41 -04:00
2010-12-26 01:31:46 -05:00
echo '<ol class="feature-group">' ;
2010-09-24 11:28:28 -04:00
foreach ( $features as $feature => $feature_name ) {
2009-05-18 11:11:07 -04:00
$feature_name = esc_html ( $feature_name );
2009-05-05 15:43:53 -04:00
$feature = esc_attr ( $feature );
2009-04-07 05:44:41 -04:00
?>
< li >
2009-04-09 09:16:14 -04:00
< input type = " checkbox " name = " features[<?php echo $feature ; ?>] " id = " feature-id-<?php echo $feature ; ?> " value = " <?php echo $feature ; ?> " />
2009-04-07 13:02:25 -04:00
< label for = " feature-id-<?php echo $feature ; ?> " >< ? php echo $feature_name ; ?> </label>
2009-04-07 05:44:41 -04:00
</ li >
< ? php } ?>
</ ol >
< br class = " clear " />
< ? php
} ?>
</ div >
< br class = " clear " />
2010-10-28 17:56:43 -04:00
< ? php submit_button ( __ ( 'Find Themes' ), 'button' , 'search' ); ?>
2009-04-07 05:44:41 -04:00
</ form >
< ? php
2009-02-11 18:10:11 -05:00
}
2010-08-11 17:54:51 -04:00
add_action ( 'install_themes_dashboard' , 'install_themes_dashboard' );
2009-02-11 18:10:11 -05:00
2009-02-25 18:43:30 -05:00
function install_themes_upload ( $page = 1 ) {
2009-04-09 09:16:14 -04:00
?>
2009-02-26 18:35:38 -05:00
< h4 >< ? php _e ( 'Install a theme in .zip format' ) ?> </h4>
2009-03-19 20:14:57 -04:00
< p class = " install-help " >< ? php _e ( 'If you have a theme in a .zip format, you may install it by uploading it here.' ) ?> </p>
2010-10-21 13:06:52 -04:00
< form method = " post " enctype = " multipart/form-data " action = " <?php echo self_admin_url('update.php?action=upload-theme') ?> " >
2009-04-09 09:16:14 -04:00
< ? php wp_nonce_field ( 'theme-upload' ) ?>
< input type = " file " name = " themezip " />
2010-12-16 16:35:39 -05:00
< ? php submit_button ( __ ( 'Install Now' ), 'button' , 'install-theme-submit' , false ); ?>
2009-04-09 09:16:14 -04:00
</ form >
2009-04-19 15:36:28 -04:00
< ? php
2009-02-26 18:35:38 -05:00
}
2010-08-11 17:54:51 -04:00
add_action ( 'install_themes_upload' , 'install_themes_upload' , 10 , 1 );
2009-02-26 18:35:38 -05:00
function display_theme ( $theme , $actions = null , $show_details = true ) {
global $themes_allowedtags ;
2009-02-27 16:24:19 -05:00
if ( empty ( $theme ) )
return ;
2009-02-26 18:35:38 -05:00
$name = wp_kses ( $theme -> name , $themes_allowedtags );
2012-02-06 15:54:01 -05:00
$author = wp_kses ( $theme -> author , $themes_allowedtags );
2009-02-26 18:35:38 -05:00
$desc = wp_kses ( $theme -> description , $themes_allowedtags );
//if ( strlen($desc) > 30 )
2011-12-14 12:36:38 -05:00
// $desc = substr($desc, 0, 15) . '<span class="dots">...</span><span>' . substr($desc, -15) . '</span>';
2009-02-26 18:35:38 -05:00
$preview_link = $theme -> preview_url . '?TB_iframe=true&width=600&height=400' ;
2009-03-19 20:14:57 -04:00
if ( ! is_array ( $actions ) ) {
2009-02-26 18:35:38 -05:00
$actions = array ();
2010-10-21 13:06:52 -04:00
$actions [] = '<a href="' . self_admin_url ( 'theme-install.php?tab=theme-information&theme=' . $theme -> slug .
2010-05-23 08:04:24 -04:00
'&TB_iframe=true&tbWidth=500&tbHeight=385' ) . '" class="thickbox thickbox-preview onclick" title="' . esc_attr ( sprintf ( __ ( 'Install “%s”' ), $name )) . '">' . __ ( 'Install' ) . '</a>' ;
2010-10-21 13:06:52 -04:00
if ( ! is_network_admin () )
$actions [] = '<a href="' . $preview_link . '" class="thickbox thickbox-preview onclick previewlink" title="' . esc_attr ( sprintf ( __ ( 'Preview “%s”' ), $name )) . '">' . __ ( 'Preview' ) . '</a>' ;
2009-02-26 18:35:38 -05:00
$actions = apply_filters ( 'theme_install_action_links' , $actions , $theme );
}
$actions = implode ( ' | ' , $actions );
?>
< a class = 'thickbox thickbox-preview screenshot'
2009-05-26 00:38:09 -04:00
href = '<?php echo esc_url($preview_link); ?>'
2009-05-05 15:43:53 -04:00
title = '<?php echo esc_attr(sprintf(__(' Preview & #8220;%s”'), $name)); ?>'>
2009-05-18 12:00:33 -04:00
< img src = '<?php echo esc_url($theme->screenshot_url); ?>' width = '150' />
2009-02-26 18:35:38 -05:00
</ a >
2012-02-06 15:54:01 -05:00
< h3 >< ? php
/* translators: 1: theme name, 2: author name */
printf ( __ ( '%1$s <span>by %2$s</span>' ), $name , $author ); ?> </h3>
2009-02-26 18:35:38 -05:00
< span class = 'action-links' >< ? php echo $actions ?> </span>
< ? php if ( $show_details ) { ?>
2012-02-06 15:54:01 -05:00
< span class = " separator hide-if-no-js " >| </ span >< a href = " #theme_detail " class = " theme-detail hide-if-no-js " tabindex = '4' >< ? php _e ( 'Details' ) ?> </a>
2009-03-15 07:04:34 -04:00
< div class = " themedetaildiv hide-if-js " >
2012-02-06 15:54:01 -05:00
< p >< ? php echo $desc ?> </p>
2009-02-26 18:35:38 -05:00
< p >< strong >< ? php _e ( 'Version:' ) ?> </strong> <?php echo wp_kses($theme->version, $themes_allowedtags) ?></p>
2009-03-17 22:43:45 -04:00
< ? php if ( ! empty ( $theme -> last_updated ) ) : ?>
2009-02-27 16:22:49 -05:00
< p >< strong >< ? php _e ( 'Last Updated:' ) ?> </strong> <span title="<?php echo $theme->last_updated ?>"><?php printf( __('%s ago'), human_time_diff(strtotime($theme->last_updated)) ) ?></span></p>
2009-03-17 22:43:45 -04:00
< ? php endif ; if ( ! empty ( $theme -> requires ) ) : ?>
< p >< strong >< ? php _e ( 'Requires WordPress Version:' ) ?> </strong> <?php printf(__('%s or higher'), $theme->requires) ?></p>
< ? php endif ; if ( ! empty ( $theme -> tested ) ) : ?>
< p >< strong >< ? php _e ( 'Compatible up to:' ) ?> </strong> <?php echo $theme->tested ?></p>
2009-02-27 16:22:49 -05:00
< ? php endif ; if ( ! empty ( $theme -> downloaded ) ) : ?>
< p >< strong >< ? php _e ( 'Downloaded:' ) ?> </strong> <?php printf(_n('%s time', '%s times', $theme->downloaded), number_format_i18n($theme->downloaded)) ?></p>
< ? php endif ; ?>
< div class = " star-holder " title = " <?php printf(_n('(based on %s rating)', '(based on %s ratings)', $theme->num_ratings ), number_format_i18n( $theme->num_ratings )) ?> " >
2009-05-05 15:43:53 -04:00
< div class = " star star-rating " style = " width: <?php echo esc_attr( $theme->rating ) ?>px " ></ div >
2011-10-20 11:04:46 -04:00
< div class = " star star5 " >< img src = " <?php echo admin_url('images/star.png?v=20110615'); ?> " alt = " <?php esc_attr_e('5 stars') ?> " /></ div >
< div class = " star star4 " >< img src = " <?php echo admin_url('images/star.png?v=20110615'); ?> " alt = " <?php esc_attr_e('4 stars') ?> " /></ div >
< div class = " star star3 " >< img src = " <?php echo admin_url('images/star.png?v=20110615'); ?> " alt = " <?php esc_attr_e('3 stars') ?> " /></ div >
< div class = " star star2 " >< img src = " <?php echo admin_url('images/star.png?v=20110615'); ?> " alt = " <?php esc_attr_e('2 stars') ?> " /></ div >
< div class = " star star1 " >< img src = " <?php echo admin_url('images/star.png?v=20110615'); ?> " alt = " <?php esc_attr_e('1 star') ?> " /></ div >
2009-02-27 16:22:49 -05:00
</ div >
2009-02-26 18:35:38 -05:00
</ div >
< ? php }
/*
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 '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 <a href="http://bavotasan.com">c.bavota</a> of <a href="http://tinkerpriestmedia.com">Tinker Priest Media</a>.' ( length = 214 )
public 'download_link' => string 'http://wordpress.org/extend/themes/download/magazine-basic.1.1.zip' ( length = 66 )
*/
2009-02-12 17:12:57 -05:00
}
2009-02-11 18:10:11 -05:00
/**
* Display theme content based on theme list .
*
* @ since 2.8 . 0
*/
2010-08-11 17:54:51 -04:00
function display_themes () {
2010-08-22 07:22:46 -04:00
global $wp_list_table ;
2009-04-19 15:36:28 -04:00
2010-08-22 07:22:46 -04:00
$wp_list_table -> display ();
2009-02-11 18:10:11 -05:00
}
2010-08-11 17:54:51 -04:00
add_action ( 'install_themes_search' , 'display_themes' );
add_action ( 'install_themes_featured' , 'display_themes' );
add_action ( 'install_themes_new' , 'display_themes' );
add_action ( 'install_themes_updated' , 'display_themes' );
2009-02-11 18:10:11 -05:00
/**
* Display theme information in dialog box form .
*
* @ since 2.8 . 0
*/
function install_theme_information () {
//TODO: This function needs a LOT of UI work :)
2009-03-19 20:14:57 -04:00
global $tab , $themes_allowedtags ;
2009-02-11 18:10:11 -05:00
$api = themes_api ( 'theme_information' , array ( 'slug' => stripslashes ( $_REQUEST [ 'theme' ] ) ));
if ( is_wp_error ( $api ) )
wp_die ( $api );
2009-02-26 18:35:38 -05:00
// Sanitize HTML
2009-02-11 18:10:11 -05:00
foreach ( ( array ) $api -> sections as $section_name => $content )
$api -> sections [ $section_name ] = wp_kses ( $content , $themes_allowedtags );
2010-03-19 04:03:52 -04:00
foreach ( array ( 'version' , 'author' , 'requires' , 'tested' , 'homepage' , 'downloaded' , 'slug' ) as $key ) {
if ( isset ( $api -> $key ) )
$api -> $key = wp_kses ( $api -> $key , $themes_allowedtags );
}
2009-02-11 18:10:11 -05:00
iframe_header ( __ ( 'Theme Install' ) );
2009-02-26 18:35:38 -05:00
2009-03-19 20:14:57 -04:00
if ( empty ( $api -> download_link ) ) {
2011-09-30 13:18:35 -04:00
echo '<div id="message" class="error"><p>' . __ ( '<strong>ERROR:</strong> This theme is currently not available. Please try again later.' ) . '</p></div>' ;
2009-03-19 20:14:57 -04:00
iframe_footer ();
exit ;
}
2009-04-13 12:24:37 -04:00
if ( ! empty ( $api -> tested ) && version_compare ( $GLOBALS [ 'wp_version' ], $api -> tested , '>' ) )
2009-02-26 18:35:38 -05:00
echo '<div class="updated"><p>' . __ ( '<strong>Warning:</strong> This theme has <strong>not been tested</strong> with your current version of WordPress.' ) . '</p></div>' ;
2009-04-13 12:24:37 -04:00
else if ( ! empty ( $api -> requires ) && version_compare ( $GLOBALS [ 'wp_version' ], $api -> requires , '<' ) )
2009-02-26 18:35:38 -05:00
echo '<div class="updated"><p>' . __ ( '<strong>Warning:</strong> This theme has not been marked as <strong>compatible</strong> with your version of WordPress.' ) . '</p></div>' ;
// Default to a "new" theme
$type = 'install' ;
// Check to see if this theme is known to be installed, and has an update awaiting it.
2010-01-08 15:49:55 -05:00
$update_themes = get_site_transient ( 'update_themes' );
2009-04-13 12:24:37 -04:00
if ( is_object ( $update_themes ) && isset ( $update_themes -> response ) ) {
foreach ( ( array ) $update_themes -> response as $theme_slug => $theme_info ) {
if ( $theme_slug === $api -> slug ) {
2009-03-19 20:14:57 -04:00
$type = 'update_available' ;
2009-04-13 12:24:37 -04:00
$update_file = $theme_slug ;
2009-03-19 20:14:57 -04:00
break ;
}
}
2009-02-26 18:35:38 -05:00
}
2009-03-19 20:14:57 -04:00
$themes = get_themes ();
2011-07-22 06:57:34 -04:00
foreach ( ( array ) $themes as $this_theme ) {
2009-03-19 20:14:57 -04:00
if ( is_array ( $this_theme ) && $this_theme [ 'Stylesheet' ] == $api -> slug ) {
if ( $this_theme [ 'Version' ] == $api -> version ) {
$type = 'latest_installed' ;
} elseif ( $this_theme [ 'Version' ] > $api -> version ) {
$type = 'newer_installed' ;
$newer_version = $this_theme [ 'Version' ];
}
break ;
}
}
?>
< div class = 'available-theme' >
2009-05-18 12:00:33 -04:00
< img src = '<?php echo esc_url($api->screenshot_url) ?>' width = '300' class = " theme-preview-img " />
2009-03-19 20:14:57 -04:00
< h3 >< ? php echo $api -> name ; ?> </h3>
< p >< ? php printf ( __ ( 'by %s' ), $api -> author ); ?> </p>
< p >< ? php printf ( __ ( 'Version: %s' ), $api -> version ); ?> </p>
< ? php
$buttons = '<a class="button" id="cancel" href="#" onclick="tb_close();return false;">' . __ ( 'Cancel' ) . '</a> ' ;
2009-02-26 18:35:38 -05:00
switch ( $type ) {
2009-03-19 20:14:57 -04:00
default :
case 'install' :
if ( current_user_can ( 'install_themes' ) ) :
2010-10-21 13:06:52 -04:00
$buttons .= '<a class="button-primary" id="install" href="' . wp_nonce_url ( self_admin_url ( 'update.php?action=install-theme&theme=' . $api -> slug ), 'install-theme_' . $api -> slug ) . '" target="_parent">' . __ ( 'Install Now' ) . '</a>' ;
2009-02-26 18:35:38 -05:00
endif ;
break ;
case 'update_available' :
if ( current_user_can ( 'update_themes' ) ) :
2010-10-21 13:06:52 -04:00
$buttons .= '<a class="button-primary" id="install" href="' . wp_nonce_url ( self_admin_url ( 'update.php?action=upgrade-theme&theme=' . $update_file ), 'upgrade-theme_' . $update_file ) . '" target="_parent">' . __ ( 'Install Update Now' ) . '</a>' ;
2009-02-26 18:35:38 -05:00
endif ;
break ;
case 'newer_installed' :
if ( current_user_can ( 'install_themes' ) || current_user_can ( 'update_themes' ) ) :
2009-03-19 20:14:57 -04:00
?> <p><?php printf(__('Newer version (%s) is installed.'), $newer_version); ?></p><?php
2009-02-26 18:35:38 -05:00
endif ;
break ;
case 'latest_installed' :
if ( current_user_can ( 'install_themes' ) || current_user_can ( 'update_themes' ) ) :
2009-03-19 20:14:57 -04:00
?> <p><?php _e('This version is already installed.'); ?></p><?php
2009-02-26 18:35:38 -05:00
endif ;
break ;
2009-03-19 20:14:57 -04:00
} ?>
< br class = " clear " />
2009-02-26 18:35:38 -05:00
</ div >
2009-03-19 20:14:57 -04:00
< p class = " action-button " >
< ? php echo $buttons ; ?>
< br class = " clear " />
</ p >
< ? php
2009-02-11 18:10:11 -05:00
iframe_footer ();
exit ;
}
2010-08-11 17:54:51 -04:00
add_action ( 'install_themes_pre_theme-information' , 'install_theme_information' );