2008-08-04 17:17:42 -04:00
< ? php
2008-09-16 20:40:10 -04:00
/**
* WordPress Plugin Install Administration API
*
* @ package WordPress
* @ subpackage Administration
*/
/**
* Retrieve plugin installer pages from WordPress Plugins API .
*
* It is possible for a plugin to override the Plugin API result with three
* filters . Assume this is for plugins , which can extend on the Plugin Info to
* offer more choices . This is very powerful and must be used with care , when
* overridding the filters .
*
* The first filter , 'plugins_api_args' , is for the args and gives the action as
* the second parameter . The hook for 'plugins_api_args' must ensure that an
* object is returned .
*
* The second filter , 'plugins_api' , is the result that would be returned .
*
2008-10-10 14:21:16 -04:00
* @ since 2.7 . 0
*
2008-09-16 20:40:10 -04:00
* @ param string $action
* @ param array | object $args Optional . Arguments to serialize for the Plugin Info API .
* @ return mixed
*/
function plugins_api ( $action , $args = null ) {
2008-08-04 17:17:42 -04:00
global $wp_version ;
if ( is_array ( $args ) )
$args = ( object ) $args ;
$args = apply_filters ( 'plugins_api_args' , $args , $action ); //NOTE: Ensure that an object is returned via this filter.
2008-08-05 13:06:42 -04:00
$res = apply_filters ( 'plugins_api' , false , $action , $args ); //NOTE: Allows a plugin to completely override the builtin WordPress.org API.
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
if ( ! $res ) {
2008-08-12 17:21:11 -04:00
$request = wp_remote_post ( 'http://api.wordpress.org/plugins/info/1.0/' , array ( 'body' => array ( 'action' => $action , 'request' => serialize ( $args ))) );
2008-10-14 11:56:33 -04:00
if ( is_wp_error ( $request ) ) {
$res = new WP_Error ( 'plugins_api_failed' , __ ( 'An Unexpected HTTP Error occured during the API request.</p> <p><a href="?" onclick="document.location.reload(); return false;">Try again</a>' ), $request -> get_error_message () );
} else {
$res = unserialize ( $request [ 'body' ]);
if ( ! $res )
$res = new WP_Error ( 'plugins_api_failed' , __ ( 'An unknown error occured' ), $request [ 'body' ]);
}
2008-08-04 17:17:42 -04:00
}
2008-08-05 13:06:42 -04:00
return apply_filters ( 'plugins_api_result' , $res , $action , $args );
2008-08-04 17:17:42 -04:00
}
2008-09-16 20:40:10 -04:00
/**
2008-10-10 14:21:16 -04:00
* Retrieve popular WordPress plugin tags .
*
* @ since 2.7 . 0
2008-09-16 20:40:10 -04:00
*
2008-10-10 14:21:16 -04:00
* @ param array $args
* @ return array
2008-09-16 20:40:10 -04:00
*/
2008-08-04 17:17:42 -04:00
function install_popular_tags ( $args = array () ) {
2008-08-05 13:06:42 -04:00
if ( ! ( $cache = wp_cache_get ( 'popular_tags' , 'api' )) && ! ( $cache = get_option ( 'wporg_popular_tags' )) )
2008-09-16 20:40:10 -04:00
add_option ( 'wporg_popular_tags' , array (), '' , 'no' ); ///No autoload.
2008-08-04 17:17:42 -04:00
if ( $cache && $cache -> timeout + 3 * 60 * 60 > time () )
return $cache -> cached ;
2008-08-05 13:06:42 -04:00
$tags = plugins_api ( 'hot_tags' , $args );
2008-08-04 17:17:42 -04:00
2008-10-14 11:56:33 -04:00
if ( is_wp_error ( $tags ) )
return $tags ;
2008-08-05 13:06:42 -04:00
$cache = ( object ) array ( 'timeout' => time (), 'cached' => $tags );
update_option ( 'wporg_popular_tags' , $cache );
wp_cache_set ( 'popular_tags' , $cache , 'api' );
2008-08-04 17:17:42 -04:00
return $tags ;
}
add_action ( 'install_plugins_search' , 'install_search' , 10 , 1 );
2008-10-10 14:21:16 -04:00
/**
* Display search results and display as tag cloud .
*
* @ since 2.7 . 0
*
* @ param string $page
*/
2008-08-04 17:17:42 -04:00
function install_search ( $page ) {
$type = isset ( $_REQUEST [ 'type' ]) ? $_REQUEST [ 'type' ] : '' ;
$term = isset ( $_REQUEST [ 's' ]) ? $_REQUEST [ 's' ] : '' ;
2008-10-13 19:39:56 -04:00
$args = array ();
switch ( $type ){
case 'tag' :
$args [ 'tag' ] = sanitize_title_with_dashes ( $term );
break ;
case 'term' :
$args [ 'search' ] = $term ;
break ;
case 'author' :
$args [ 'author' ] = $term ;
break ;
}
2008-08-04 17:17:42 -04:00
2008-10-13 19:39:56 -04:00
$args [ 'page' ] = $page ;
2008-08-04 17:17:42 -04:00
2008-10-13 19:39:56 -04:00
$api = plugins_api ( 'query_plugins' , $args );
2008-08-04 17:17:42 -04:00
2008-10-14 11:56:33 -04:00
if ( is_wp_error ( $api ) )
wp_die ( $api );
2008-10-13 19:39:56 -04:00
add_action ( 'install_plugins_table_header' , 'install_search_form' );
2008-08-04 17:17:42 -04:00
2008-10-13 19:39:56 -04:00
display_plugins_table ( $api -> plugins , $api -> info [ 'page' ], $api -> info [ 'pages' ]);
2008-08-04 17:17:42 -04:00
2008-10-13 19:39:56 -04:00
return ;
}
2008-08-04 17:17:42 -04:00
2008-10-13 19:39:56 -04:00
add_action ( 'install_plugins_dashboard' , 'install_dashboard' );
function install_dashboard () {
2008-08-04 17:17:42 -04:00
?>
2008-10-13 19:39:56 -04:00
< p >< ? php _e ( 'Plugins extend and expand the functionality of WordPress. You may automatically install plugins from the <a href="http://wordpress.org/extend/plugins/">WordPress Plugin Directory</a> or upload a plugin in .zip format via this page.' ) ?> </p>
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
< h4 >< ? php _e ( 'Search' ) ?> </h4>
2008-10-13 19:39:56 -04:00
< ? php install_search_form ( '<a href="' . add_query_arg ( 'show-help' , ! isset ( $_REQUEST [ 'show-help' ])) . '" onclick="jQuery(\'#search-help\').toggle(); return false;">' . __ ( '[need help?]' ) . '</a>' ) ?>
< div id = " search-help " style = " display: <?php echo isset( $_REQUEST['show-help'] ) ? 'block' : 'none'; ?>; " >
2008-08-04 17:17:42 -04:00
< p > < ? php _e ( 'You may search based on 3 criteria:' ) ?> <br />
< ? php _e ( '<strong>Term:</strong> Searches plugins names and descriptions for the specified term' ) ?> <br />
< ? php _e ( '<strong>Tag:</strong> Searches for plugins tagged as such' ) ?> <br />
< ? php _e ( '<strong>Author:</strong> Searches for plugins created by the Author, or which the Author contributed to.' ) ?> </p>
2008-10-13 19:39:56 -04:00
</ div >
< h4 >< ? php _e ( 'Install a plugin in .zip format' ) ?> </h4>
< p >< ? php _e ( 'If you have a plugin in a .zip format, You may install it by uploading it here.' ) ?> </p>
< form method = " post " enctype = " multipart/form-data " action = " <?php echo admin_url('plugin-install.php?tab=upload') ?> " >
< ? php wp_nonce_field ( 'plugin-upload' ) ?>
< input type = " file " name = " pluginzip " />
< input type = " submit " value = " <?php _e('Install Now') ?> " />
</ form >
2008-08-04 17:17:42 -04:00
< h4 >< ? php _e ( 'Popular tags' ) ?> </h4>
2008-10-13 19:39:56 -04:00
< p >< ? php _e ( 'You may also browse based on the most popular tags on wordpress.org' ) ?> </p>
2008-08-04 17:17:42 -04:00
< ? php
2008-10-10 14:21:16 -04:00
$api_tags = install_popular_tags ();
2008-08-04 17:17:42 -04:00
2008-10-10 14:21:16 -04:00
//Set up the tags in a way which can be interprated by wp_generate_tag_cloud()
$tags = array ();
foreach ( ( array ) $api_tags as $tag )
$tags [ $tag [ 'name' ] ] = ( object ) array (
'link' => clean_url ( admin_url ( 'plugin-install.php?tab=search&type=tag&s=' . urlencode ( $tag [ 'name' ])) ),
'name' => $tag [ 'name' ],
2008-10-13 19:39:56 -04:00
'id' => sanitize_title_with_dashes ( $tag [ 'name' ]),
2008-10-10 14:21:16 -04:00
'count' => $tag [ 'count' ] );
echo wp_generate_tag_cloud ( $tags , array ( 'single_text' => __ ( '%d plugin' ), 'multiple_text' => __ ( '%d plugins' ) ) );
2008-08-04 17:17:42 -04:00
}
2008-10-18 16:46:30 -04:00
/**
* Display search form for searching plugins .
*
* @ since 2.7 . 0
*/
function install_search_form (){
2008-08-04 17:17:42 -04:00
$type = isset ( $_REQUEST [ 'type' ]) ? $_REQUEST [ 'type' ] : '' ;
$term = isset ( $_REQUEST [ 's' ]) ? $_REQUEST [ 's' ] : '' ;
?> <form id="search-plugins" method="post" action="<?php echo admin_url('plugin-install.php?tab=search') ?>">
< 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>
2008-10-13 19:39:56 -04:00
< option value = " tag " < ? php selected ( 'tag' , $type ) ?> ><?php _e('Tag') ?></option>
2008-08-04 17:17:42 -04:00
</ select >
< input type = " text " name = " s " id = " search-field " value = " <?php echo attribute_escape( $term ) ?> " />
2008-08-25 06:57:14 -04:00
< input type = " submit " name = " search " value = " <?php echo attribute_escape(__('Search')) ?> " class = " button " />
2008-08-04 17:17:42 -04:00
</ form >< ? php
}
add_action ( 'install_plugins_featured' , 'install_featured' , 10 , 1 );
2008-10-10 14:21:16 -04:00
/**
* Display featured plugins .
*
* @ since 2.7 . 0
*
* @ param string $page
*/
2008-10-13 19:39:56 -04:00
function install_featured ( $page = 1 ) {
2008-08-04 17:17:42 -04:00
$args = array ( 'browse' => 'featured' , 'page' => $page );
$api = plugins_api ( 'query_plugins' , $args );
2008-10-14 11:56:33 -04:00
if ( is_wp_error ( $api ) )
wp_die ( $api );
2008-08-04 17:17:42 -04:00
display_plugins_table ( $api -> plugins , $api -> info [ 'page' ], $api -> info [ 'pages' ]);
}
2008-10-10 14:21:16 -04:00
2008-10-13 19:39:56 -04:00
add_action ( 'install_plugins_popular' , 'install_popular' , 10 , 1 );
2008-10-10 14:21:16 -04:00
/**
* Display popular plugins .
*
* @ since 2.7 . 0
*
* @ param string $page
*/
2008-10-13 19:39:56 -04:00
function install_popular ( $page = 1 ) {
2008-08-04 17:17:42 -04:00
$args = array ( 'browse' => 'popular' , 'page' => $page );
$api = plugins_api ( 'query_plugins' , $args );
display_plugins_table ( $api -> plugins , $api -> info [ 'page' ], $api -> info [ 'pages' ]);
}
2008-10-10 14:21:16 -04:00
2008-10-13 19:39:56 -04:00
add_action ( 'install_plugins_new' , 'install_new' , 10 , 1 );
2008-10-10 14:21:16 -04:00
/**
* Display new plugins .
*
* @ since 2.7 . 0
*
* @ param string $page
*/
2008-10-13 19:39:56 -04:00
function install_new ( $page = 1 ) {
2008-08-04 17:17:42 -04:00
$args = array ( 'browse' => 'new' , 'page' => $page );
$api = plugins_api ( 'query_plugins' , $args );
2008-10-14 11:56:33 -04:00
if ( is_wp_error ( $api ) )
wp_die ( $api );
2008-08-04 17:17:42 -04:00
display_plugins_table ( $api -> plugins , $api -> info [ 'page' ], $api -> info [ 'pages' ]);
}
add_action ( 'install_plugins_updated' , 'install_updated' , 10 , 1 );
2008-10-10 14:21:16 -04:00
2008-10-13 19:39:56 -04:00
2008-10-10 14:21:16 -04:00
/**
* Display recently updated plugins .
*
* @ since 2.7 . 0
*
* @ param string $page
*/
2008-10-13 19:39:56 -04:00
function install_updated ( $page = 1 ) {
2008-08-04 17:17:42 -04:00
$args = array ( 'browse' => 'updated' , 'page' => $page );
$api = plugins_api ( 'query_plugins' , $args );
display_plugins_table ( $api -> plugins , $api -> info [ 'page' ], $api -> info [ 'pages' ]);
}
2008-10-10 14:21:16 -04:00
/**
* Display plugin content based on plugin list .
*
* @ since 2.7 . 0
*
* @ param array $plugins List of plugins .
* @ param string $page
* @ param int $totalpages Number of pages .
*/
2008-08-04 17:17:42 -04:00
function display_plugins_table ( $plugins , $page = 1 , $totalpages = 1 ){
global $tab ;
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
$type = isset ( $_REQUEST [ 'type' ]) ? $_REQUEST [ 'type' ] : '' ;
$term = isset ( $_REQUEST [ 's' ]) ? $_REQUEST [ 's' ] : '' ;
2008-10-14 11:56:33 -04:00
$plugins_allowedtags = array ( 'a' => array ( 'href' => array (), 'title' => array (), 'target' => array ()),
'abbr' => array ( 'title' => array ()), 'acronym' => array ( 'title' => array ()),
2008-10-24 00:54:21 -04:00
'code' => array (), 'pre' => array (), 'em' => array (), 'strong' => array ());
2008-08-04 17:17:42 -04:00
?>
< div class = " tablenav " >
2008-10-24 14:25:46 -04:00
< div class = " alignleft actions " >
2008-08-04 17:17:42 -04:00
< ? php do_action ( 'install_plugins_table_header' ); ?>
</ div >
< ? php
2008-10-13 19:39:56 -04:00
$url = clean_url ( $_SERVER [ 'REQUEST_URI' ]);
2008-08-04 17:17:42 -04:00
if ( ! empty ( $term ) )
$url = add_query_arg ( 's' , $term , $url );
if ( ! empty ( $type ) )
$url = add_query_arg ( 'type' , $type , $url );
$page_links = paginate_links ( array (
'base' => add_query_arg ( 'paged' , '%#%' , $url ),
'format' => '' ,
2008-10-24 14:25:46 -04:00
'prev_text' => __ ( '«' ),
'next_text' => __ ( '»' ),
2008-08-04 17:17:42 -04:00
'total' => $totalpages ,
'current' => $page
));
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
if ( $page_links )
2008-08-09 01:36:14 -04:00
echo " \t \t <div class='tablenav-pages'> $page_links </div> " ;
2008-08-04 17:17:42 -04:00
?>
2008-10-13 19:39:56 -04:00
< br class = " clear " />
2008-08-04 17:17:42 -04:00
</ div >
< table class = " widefat " id = " install-plugins " >
< thead >
< tr >
< th scope = " col " class = " name " >< ? php _e ( 'Name' ); ?> </th>
< th scope = " col " class = " num " >< ? php _e ( 'Version' ); ?> </th>
< th scope = " col " class = " num " >< ? php _e ( 'Rating' ); ?> </th>
< th scope = " col " class = " desc " >< ? php _e ( 'Description' ); ?> </th>
< th scope = " col " class = " action-links " >< ? php _e ( 'Actions' ); ?> </th>
</ tr >
</ thead >
2008-09-29 05:26:21 -04:00
< tfoot >
< tr >
< th scope = " col " class = " name " >< ? php _e ( 'Name' ); ?> </th>
< th scope = " col " class = " num " >< ? php _e ( 'Version' ); ?> </th>
< th scope = " col " class = " num " >< ? php _e ( 'Rating' ); ?> </th>
< th scope = " col " class = " desc " >< ? php _e ( 'Description' ); ?> </th>
< th scope = " col " class = " action-links " >< ? php _e ( 'Actions' ); ?> </th>
</ tr >
</ tfoot >
2008-08-04 17:17:42 -04:00
< tbody class = " plugins " >
< ? php
if ( empty ( $plugins ) )
echo '<tr><td colspan="5">' , __ ( 'No plugins match your request.' ), '</td></tr>' ;
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
foreach ( ( array ) $plugins as $plugin ){
if ( is_object ( $plugin ) )
$plugin = ( array ) $plugin ;
$title = wp_kses ( $plugin [ 'name' ], $plugins_allowedtags );
$description = wp_kses ( $plugin [ 'description' ], $plugins_allowedtags );
$version = wp_kses ( $plugin [ 'version' ], $plugins_allowedtags );
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
$name = strip_tags ( $title . ' ' . $version );
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
$author = $plugin [ 'author' ];
if ( ! empty ( $plugin [ 'author' ]) )
$author = ' <cite>' . sprintf ( __ ( 'By %s' ), $author ) . '.</cite>' ;
$author = wp_kses ( $author , $plugins_allowedtags );
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
if ( isset ( $plugin [ 'homepage' ]) )
2008-10-13 19:39:56 -04:00
$title = '<a target="_blank" href="' . attribute_escape ( $plugin [ 'homepage' ]) . '">' . $title . '</a>' ;
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
$action_links = array ();
2008-09-14 01:37:54 -04:00
$action_links [] = '<a href="' . admin_url ( 'plugin-install.php?tab=plugin-information&plugin=' . $plugin [ 'slug' ] .
'&TB_iframe=true&width=600&height=800' ) . '" class="thickbox onclick" title="' .
2008-08-04 17:17:42 -04:00
attribute_escape ( $name ) . '">' . __ ( 'Install' ) . '</a>' ;
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
$action_links = apply_filters ( 'plugin_install_action_links' , $action_links , $plugin );
?>
< tr >
< td class = " name " >< ? php echo $title ; ?> </td>
< td class = " vers " >< ? php echo $version ; ?> </td>
< td class = " vers " >
2008-10-16 22:35:43 -04:00
< div class = " star-holder " title = " <?php printf(__ngettext('(based on %d rating)', '(based on %d ratings)', $plugin['num_ratings'] ), number_format_i18n( $plugin['num_ratings'] )) ?> " >
2008-08-04 17:17:42 -04:00
< div class = " star star-rating " style = " width: <?php echo attribute_escape( $plugin['rating'] ) ?>px " ></ div >
< div class = " star star5 " >< img src = " <?php echo admin_url('images/star.gif'); ?> " alt = " <?php _e('5 stars') ?> " /></ div >
< div class = " star star4 " >< img src = " <?php echo admin_url('images/star.gif'); ?> " alt = " <?php _e('4 stars') ?> " /></ div >
< div class = " star star3 " >< img src = " <?php echo admin_url('images/star.gif'); ?> " alt = " <?php _e('3 stars') ?> " /></ div >
< div class = " star star2 " >< img src = " <?php echo admin_url('images/star.gif'); ?> " alt = " <?php _e('2 stars') ?> " /></ div >
< div class = " star star1 " >< img src = " <?php echo admin_url('images/star.gif'); ?> " alt = " <?php _e('1 star') ?> " /></ div >
</ div >
</ td >
< td class = " desc " >< p >< ? php echo $description , $author ; ?> </p></td>
< td class = " action-links " >< ? php if ( ! empty ( $action_links ) ) echo implode ( ' | ' , $action_links ); ?> </td>
</ tr >
< ? php
}
?>
</ tbody >
</ table >
2008-09-29 05:26:21 -04:00
< div class = " tablenav " >
< ? php if ( $page_links )
echo " \t \t <div class='tablenav-pages'> $page_links </div> " ; ?>
2008-10-13 19:39:56 -04:00
< br class = " clear " />
2008-09-29 05:26:21 -04:00
</ div >
2008-08-04 17:17:42 -04:00
< ? php
}
add_action ( 'install_plugins_pre_plugin-information' , 'install_plugin_information' );
2008-10-10 14:21:16 -04:00
/**
* Display plugin information in dialog box form .
*
* @ since 2.7 . 0
*/
2008-08-04 17:17:42 -04:00
function install_plugin_information () {
global $tab ;
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
$api = plugins_api ( 'plugin_information' , array ( 'slug' => $_REQUEST [ 'plugin' ]));
2008-10-14 11:56:33 -04:00
if ( is_wp_error ( $api ) )
wp_die ( $api );
$plugins_allowedtags = array ( 'a' => array ( 'href' => array (), 'title' => array (), 'target' => array ()),
'abbr' => array ( 'title' => array ()), 'acronym' => array ( 'title' => array ()),
2008-10-24 00:54:21 -04:00
'code' => array (), 'pre' => array (), 'em' => array (), 'strong' => array (),
'div' => array (), 'p' => array (), 'ul' => array (), 'ol' => array (), 'li' => array ());
2008-10-14 11:56:33 -04:00
//Sanitize HTML
foreach ( ( array ) $api -> sections as $section_name => $content )
$api -> sections [ $section_name ] = wp_kses ( $content , $plugins_allowedtags );
foreach ( array ( 'version' , 'author' , 'requires' , 'tested' , 'homepage' , 'downloaded' , 'slug' ) as $key )
$api -> $key = wp_kses ( $api -> $key , $plugins_allowedtags );
2008-08-04 17:17:42 -04:00
$section = isset ( $_REQUEST [ 'section' ]) ? $_REQUEST [ 'section' ] : 'description' ; //Default to the Description tab, Do not translate, API returns English.
if ( empty ( $section ) || ! isset ( $api -> sections [ $section ]) )
$section = array_shift ( $section_titles = array_keys (( array ) $api -> sections ) );
2008-08-09 01:36:14 -04:00
2008-10-13 19:39:56 -04:00
iframe_header ( __ ( 'Plugin Install' ) );
2008-08-04 17:17:42 -04:00
echo " <div id=' $tab -header'> \n " ;
echo " <ul id='sidemenu'> \n " ;
foreach ( ( array ) $api -> sections as $section_name => $content ) {
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
$title = $section_name ;
2008-10-13 19:39:56 -04:00
$title = ucwords ( str_replace ( '_' , ' ' , $title ));
2008-08-04 17:17:42 -04:00
$class = ( $section_name == $section ) ? ' class="current"' : '' ;
$href = add_query_arg ( array ( 'tab' => $tab , 'section' => $section_name ) );
$href = clean_url ( $href );
$san_title = attribute_escape ( sanitize_title_with_dashes ( $title ));
echo " \t <li><a name=' $san_title ' target='' href=' $href ' $class > $title </a></li> \n " ;
}
echo " </ul> \n " ;
echo " </div> \n " ;
?>
< div class = " alignright fyi " >
< ? php if ( ! empty ( $api -> download_link ) ) : ?>
< p class = " action-button " >
< ? php
2008-08-05 13:06:42 -04:00
//Default to a "new" plugin
2008-08-04 17:17:42 -04:00
$type = 'install' ;
2008-08-05 13:06:42 -04:00
//Check to see if this plugin is known to be installed, and has an update awaiting it.
$update_plugins = get_option ( 'update_plugins' );
foreach ( ( array ) $update_plugins -> response as $file => $plugin ) {
if ( $plugin -> slug === $api -> slug ) {
$type = 'update_available' ;
$update_file = $file ;
break ;
2008-08-04 17:17:42 -04:00
}
}
2008-08-05 13:06:42 -04:00
if ( 'install' == $type && file_exists ( WP_PLUGIN_DIR . '/' . $api -> slug ) ) //TODO: Make more.. searchable?
$type = 'latest_installed' ;
2008-08-04 17:17:42 -04:00
switch ( $type ) :
default :
case 'install' :
if ( current_user_can ( 'install_plugins' ) ) :
2008-10-13 19:39:56 -04:00
?> <a href="<?php echo wp_nonce_url(admin_url('plugin-install.php?tab=install&plugin=' . $api->slug), 'install-plugin_' . $api->slug) ?>" target="_parent"><?php _e('Install Now') ?></a><?php
2008-08-04 17:17:42 -04:00
endif ;
break ;
case 'update_available' :
if ( current_user_can ( 'update_plugins' ) ) :
2008-10-13 19:39:56 -04:00
?> <a href="<?php echo wp_nonce_url(admin_url('update.php?action=upgrade-plugin&plugin=' . $update_file), 'upgrade-plugin_' . $update_file) ?>" target="_parent"><?php _e('Install Update Now') ?></a><?php
2008-08-04 17:17:42 -04:00
endif ;
break ;
case 'latest_installed' :
if ( current_user_can ( 'install_plugins' ) || current_user_can ( 'update_plugins' ) ) :
?> <a><?php _e('Latest Version Installed') ?></a><?php
endif ;
break ;
endswitch ; ?>
</ p >
< ? php endif ; ?>
< h2 class = " mainheader " >< ? php _e ( 'FYI' ) ?> </h2>
< ul >
< ? php if ( ! empty ( $api -> version ) ) : ?>
< li >< strong >< ? php _e ( 'Version:' ) ?> </strong> <?php echo $api->version ?></li>
< ? php endif ; if ( ! empty ( $api -> author ) ) : ?>
< li >< strong >< ? php _e ( 'Author:' ) ?> </strong> <?php echo links_add_target($api->author, '_blank') ?></li>
< ? php endif ; if ( ! empty ( $api -> last_updated ) ) : ?>
2008-08-09 01:36:14 -04:00
< li >< strong >< ? php _e ( 'Last Updated:' ) ?> </strong> <span title="<?php echo $api->last_updated ?>"><?php
2008-08-04 17:17:42 -04:00
printf ( __ ( '%s ago' ), human_time_diff ( strtotime ( $api -> last_updated )) ) ?> </span></li>
< ? php endif ; if ( ! empty ( $api -> requires ) ) : ?>
< li >< strong >< ? php _e ( 'Requires WordPress Version:' ) ?> </strong> <?php printf(__('%s or higher'), $api->requires) ?></li>
< ? php endif ; if ( ! empty ( $api -> tested ) ) : ?>
< li >< strong >< ? php _e ( 'Compatible up to:' ) ?> </strong> <?php echo $api->tested ?></li>
< ? php endif ; if ( ! empty ( $api -> downloaded ) ) : ?>
< li >< strong >< ? php _e ( 'Downloaded:' ) ?> </strong> <?php printf('%s times', number_format_i18n($api->downloaded)) ?></li>
< ? php endif ; if ( ! empty ( $api -> slug ) ) : ?>
< li >< a target = " _blank " href = " http://wordpress.org/extend/plugins/<?php echo $api->slug ?>/ " >< ? php _e ( 'WordPress.org Plugin Page »' ) ?> </a></li>
< ? php endif ; if ( ! empty ( $api -> homepage ) ) : ?>
< li >< a target = " _blank " href = " <?php echo $api->homepage ?> " >< ? php _e ( 'Plugin Homepage »' ) ?> </a></li>
< ? php endif ; ?>
</ ul >
< h2 >< ? php _e ( 'Average Rating' ) ?> </h2>
2008-10-16 22:35:43 -04:00
< div class = " star-holder " title = " <?php printf(__ngettext('(based on %s rating)', '(based on %s ratings)', $api->num_ratings ), number_format_i18n( $api->num_ratings )); ?> " >
2008-08-04 17:17:42 -04:00
< div class = " star star-rating " style = " width: <?php echo attribute_escape( $api->rating ) ?>px " ></ div >
< div class = " star star5 " >< img src = " <?php echo admin_url('images/star.gif'); ?> " alt = " <?php _e('5 stars') ?> " /></ div >
< div class = " star star4 " >< img src = " <?php echo admin_url('images/star.gif'); ?> " alt = " <?php _e('4 stars') ?> " /></ div >
< div class = " star star3 " >< img src = " <?php echo admin_url('images/star.gif'); ?> " alt = " <?php _e('3 stars') ?> " /></ div >
< div class = " star star2 " >< img src = " <?php echo admin_url('images/star.gif'); ?> " alt = " <?php _e('2 stars') ?> " /></ div >
< div class = " star star1 " >< img src = " <?php echo admin_url('images/star.gif'); ?> " alt = " <?php _e('1 star') ?> " /></ div >
</ div >
2008-10-16 22:35:43 -04:00
< small >< ? php printf ( __ngettext ( '(based on %s rating)' , '(based on %s ratings)' , $api -> num_ratings ), number_format_i18n ( $api -> num_ratings )); ?> </small>
2008-08-04 17:17:42 -04:00
</ div >
2008-08-05 13:06:42 -04:00
< div id = " section-holder " class = " wrap " >
2008-10-13 19:39:56 -04:00
< ? php
if ( version_compare ( $GLOBALS [ 'wp_version' ], $api -> tested , '>' ) )
echo '<div class="updated"><p>' . __ ( '<strong>Warning:</strong> This plugin has <strong>not been tested</strong> with your current version of WordPress.' ) . '</p></div>' ;
else if ( version_compare ( $GLOBALS [ 'wp_version' ], $api -> requires , '<' ) )
echo '<div class="updated"><p>' . __ ( '<strong>Warning:</strong> This plugin has not been marked as being <strong>not compatible</strong> with your version of WordPress.' ) . '</p></div>' ;
2008-08-05 13:06:42 -04:00
foreach ( ( array ) $api -> sections as $section_name => $content ) {
$title = $section_name ;
$title [ 0 ] = strtoupper ( $title [ 0 ]);
$title = str_replace ( '_' , ' ' , $title );
2008-08-09 01:36:14 -04:00
2008-08-05 13:06:42 -04:00
$content = links_add_base_url ( $content , 'http://wordpress.org/extend/plugins/' . $api -> slug . '/' );
$content = links_add_target ( $content , '_blank' );
2008-08-09 01:36:14 -04:00
2008-08-05 13:06:42 -04:00
$san_title = attribute_escape ( sanitize_title_with_dashes ( $title ));
2008-08-09 01:36:14 -04:00
2008-08-05 13:06:42 -04:00
$display = ( $section_name == $section ) ? 'block' : 'none' ;
2008-08-09 01:36:14 -04:00
2008-10-13 19:39:56 -04:00
echo " \t <div id='section- { $san_title } ' class='section' style='display: { $display } ;'> \n " ;
2008-08-05 13:06:42 -04:00
echo " \t \t <h2 class='long-header'> $title </h2> " ;
echo $content ;
echo " \t </div> \n " ;
}
2008-08-04 17:17:42 -04:00
echo " </div> \n " ;
2008-08-05 13:06:42 -04:00
2008-10-13 19:39:56 -04:00
iframe_footer ();
2008-08-04 17:17:42 -04:00
exit ;
}
2008-10-13 19:39:56 -04:00
add_action ( 'install_plugins_upload' , 'upload_plugin' );
function upload_plugin () {
if ( ! ( ( $uploads = wp_upload_dir () ) && false === $uploads [ 'error' ] ) )
wp_die ( $uploads [ 'error' ]);
if ( ! empty ( $_FILES ) )
$filename = $_FILES [ 'pluginzip' ][ 'name' ];
else if ( isset ( $_GET [ 'package' ]) )
$filename = $_GET [ 'package' ];
check_admin_referer ( 'plugin-upload' );
echo '<div class="wrap">' ;
echo '<h2>' , sprintf ( __ ( 'Installing Plugin from file: %s' ), basename ( $filename ) ), '</h2>' ;
//Handle a newly uploaded file, Else assume it was
if ( ! empty ( $_FILES ) ) {
$filename = wp_unique_filename ( $uploads [ 'basedir' ], $filename );
$local_file = $uploads [ 'basedir' ] . '/' . $filename ;
// Move the file to the uploads dir
if ( false === @ move_uploaded_file ( $_FILES [ 'pluginzip' ][ 'tmp_name' ], $local_file ) )
wp_die ( sprintf ( __ ( 'The uploaded file could not be moved to %s.' ), $uploads [ 'path' ]));
} else {
$local_file = $uploads [ 'basedir' ] . '/' . $filename ;
}
do_plugin_install_local_package ( $local_file , $filename );
echo '</div>' ;
}
add_action ( 'install_plugins_install' , 'install_plugin' );
2008-10-10 14:21:16 -04:00
/**
* Display plugin link and execute install .
*
* @ since 2.7 . 0
*/
2008-08-04 17:17:42 -04:00
function install_plugin () {
2008-08-05 13:06:42 -04:00
$plugin = isset ( $_REQUEST [ 'plugin' ]) ? $_REQUEST [ 'plugin' ] : '' ;
check_admin_referer ( 'install-plugin_' . $plugin );
$api = plugins_api ( 'plugin_information' , array ( 'slug' => $plugin , 'fields' => array ( 'sections' => false ) ) ); //Save on a bit of bandwidth.
2008-10-14 11:56:33 -04:00
if ( is_wp_error ( $api ) )
wp_die ( $api );
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
echo '<div class="wrap">' ;
echo '<h2>' , sprintf ( __ ( 'Installing Plugin: %s' ), $api -> name . ' ' . $api -> version ), '</h2>' ;
2008-08-05 13:06:42 -04:00
do_plugin_install ( $api -> download_link , $api );
2008-08-04 17:17:42 -04:00
echo '</div>' ;
}
2008-10-10 14:21:16 -04:00
/**
* Retrieve plugin and install .
*
* @ since 2.7 . 0
*
2008-10-13 19:39:56 -04:00
* @ param string $download_url Download URL .
2008-10-10 14:21:16 -04:00
* @ param object $plugin_information Optional . Plugin information
*/
2008-10-13 19:39:56 -04:00
function do_plugin_install ( $download_url , $plugin_information = null ) {
2008-08-04 17:17:42 -04:00
global $wp_filesystem ;
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
if ( empty ( $download_url ) ) {
show_message ( __ ( 'No plugin Specified' ) );
return ;
}
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
$plugin = isset ( $_REQUEST [ 'plugin' ]) ? $_REQUEST [ 'plugin' ] : '' ;
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
$url = 'plugin-install.php?tab=install' ;
$url = add_query_arg ( array ( 'plugin' => $plugin , 'plugin_name' => $_REQUEST [ 'plugin_name' ], 'download_url' => $_REQUEST [ 'download_url' ]), $url );
2008-08-05 13:06:42 -04:00
$url = wp_nonce_url ( $url , 'install-plugin_' . $plugin );
2008-08-04 17:17:42 -04:00
if ( false === ( $credentials = request_filesystem_credentials ( $url )) )
return ;
if ( ! WP_Filesystem ( $credentials ) ) {
request_filesystem_credentials ( $url , '' , true ); //Failed to connect, Error and request again
return ;
}
if ( $wp_filesystem -> errors -> get_error_code () ) {
foreach ( $wp_filesystem -> errors -> get_error_messages () as $message )
show_message ( $message );
return ;
}
$result = wp_install_plugin ( $download_url , 'show_message' );
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
if ( is_wp_error ( $result ) ) {
show_message ( $result );
show_message ( __ ( 'Installation Failed' ) );
} else {
2008-08-05 13:06:42 -04:00
show_message ( sprintf ( __ ( 'Successfully installed the plugin <strong>%s %s</strong>.' ), $plugin_information -> name , $plugin_information -> version ) );
$plugin_file = $result ;
$install_actions = apply_filters ( 'install_plugin_complete_actions' , array (
2008-10-13 19:39:56 -04:00
'activate_plugin' => '<a href="' . wp_nonce_url ( 'plugins.php?action=activate&plugin=' . $plugin_file , 'activate-plugin_' . $plugin_file ) . '" title="' . attribute_escape ( __ ( 'Activate this plugin' )) . '" target="_parent">' . __ ( 'Activate Plugin' ) . '</a>' ,
'plugins_page' => '<a href="' . admin_url ( 'plugins.php' ) . '" title="' . attribute_escape ( __ ( 'Goto plugins page' )) . '" target="_parent">' . __ ( 'Return to Plugins page' ) . '</a>'
2008-08-05 13:06:42 -04:00
), $plugin_information , $plugin_file );
2008-10-13 19:39:56 -04:00
if ( ! empty ( $install_actions ) )
2008-10-13 21:33:27 -04:00
show_message ( '<strong>' . __ ( 'Actions:' ) . '</strong> ' . implode ( ' | ' , ( array ) $install_actions ));
2008-10-13 19:39:56 -04:00
}
}
/**
* Install a plugin from a local file .
*
* @ since 2.7 . 0
*
* @ param string $package Local Plugin zip
* @ param string $filename Optional . Original filename
* @ param object $plugin_information Optional . Plugin information
*/
function do_plugin_install_local_package ( $package , $filename = '' ) {
global $wp_filesystem ;
if ( empty ( $package ) ) {
show_message ( __ ( 'No plugin Specified' ) );
return ;
}
if ( empty ( $filename ) )
$filename = basename ( $package );
$url = 'plugin-install.php?tab=upload' ;
$url = add_query_arg ( array ( 'package' => $filename ), $url );
$url = wp_nonce_url ( $url , 'plugin-upload' );
if ( false === ( $credentials = request_filesystem_credentials ( $url )) )
return ;
if ( ! WP_Filesystem ( $credentials ) ) {
request_filesystem_credentials ( $url , '' , true ); //Failed to connect, Error and request again
return ;
}
if ( $wp_filesystem -> errors -> get_error_code () ) {
foreach ( $wp_filesystem -> errors -> get_error_messages () as $message )
show_message ( $message );
return ;
}
2008-08-05 13:06:42 -04:00
2008-10-13 19:39:56 -04:00
$result = wp_install_plugin_local_package ( $package , 'show_message' );
if ( is_wp_error ( $result ) ) {
show_message ( $result );
show_message ( __ ( 'Installation Failed' ) );
} else {
show_message ( __ ( 'Successfully installed the plugin.' ) );
$plugin_file = $result ;
$install_actions = apply_filters ( 'install_plugin_complete_actions' , array (
'activate_plugin' => '<a href="' . wp_nonce_url ( 'plugins.php?action=activate&plugin=' . $plugin_file , 'activate-plugin_' . $plugin_file ) . '" title="' . __ ( 'Activate this plugin' ) . '" target="_parent">' . __ ( 'Activate Plugin' ) . '</a>' ,
'plugins_page' => '<a href="' . admin_url ( 'plugins.php' ) . '" title="' . __ ( 'Goto plugins page' ) . '" target="_parent">' . __ ( 'Return to Plugins page' ) . '</a>'
), $plugin_information , $plugin_file );
if ( ! empty ( $install_actions ) )
2008-10-13 21:33:27 -04:00
show_message ( '<strong>' . __ ( 'Actions:' ) . '</strong> ' . implode ( ' | ' , ( array ) $install_actions ));
2008-08-04 17:17:42 -04:00
}
}
2008-10-10 14:21:16 -04:00
/**
* Install plugin .
*
* @ since 2.7 . 0
*
* @ param string $package
* @ param string $feedback Optional .
* @ return mixed .
*/
2008-08-04 17:17:42 -04:00
function wp_install_plugin ( $package , $feedback = '' ) {
global $wp_filesystem ;
if ( ! empty ( $feedback ) )
add_filter ( 'install_feedback' , $feedback );
// Is a filesystem accessor setup?
if ( ! $wp_filesystem || ! is_object ( $wp_filesystem ) )
WP_Filesystem ();
if ( ! is_object ( $wp_filesystem ) )
return new WP_Error ( 'fs_unavailable' , __ ( 'Could not access filesystem.' ));
if ( $wp_filesystem -> errors -> get_error_code () )
return new WP_Error ( 'fs_error' , __ ( 'Filesystem error' ), $wp_filesystem -> errors );
//Get the base plugin folder
$plugins_dir = $wp_filesystem -> wp_plugins_dir ();
if ( empty ( $plugins_dir ) )
return new WP_Error ( 'fs_no_plugins_dir' , __ ( 'Unable to locate WordPress Plugin directory.' ));
//And the same for the Content directory.
$content_dir = $wp_filesystem -> wp_content_dir ();
if ( empty ( $content_dir ) )
return new WP_Error ( 'fs_no_content_dir' , __ ( 'Unable to locate WordPress Content directory (wp-content).' ));
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
$plugins_dir = trailingslashit ( $plugins_dir );
$content_dir = trailingslashit ( $content_dir );
if ( empty ( $package ) )
return new WP_Error ( 'no_package' , __ ( 'Install package not available.' ));
// Download the package
apply_filters ( 'install_feedback' , sprintf ( __ ( 'Downloading plugin package from %s' ), $package ));
$download_file = download_url ( $package );
if ( is_wp_error ( $download_file ) )
return new WP_Error ( 'download_failed' , __ ( 'Download failed.' ), $download_file -> get_error_message ());
$working_dir = $content_dir . 'upgrade/' . basename ( $package , '.zip' );
// Clean up working directory
if ( $wp_filesystem -> is_dir ( $working_dir ) )
$wp_filesystem -> delete ( $working_dir , true );
apply_filters ( 'install_feedback' , __ ( 'Unpacking the plugin package' ));
// Unzip package to working directory
$result = unzip_file ( $download_file , $working_dir );
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
// Once extracted, delete the package
2008-10-13 19:39:56 -04:00
@ unlink ( $download_file );
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
if ( is_wp_error ( $result ) ) {
$wp_filesystem -> delete ( $working_dir , true );
return $result ;
}
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
//Get a list of the directories in the working directory before we delete it, We need to know the new folder for the plugin
$filelist = array_keys ( $wp_filesystem -> dirlist ( $working_dir ) );
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
if ( $wp_filesystem -> exists ( $plugins_dir . $filelist [ 0 ] ) ) {
$wp_filesystem -> delete ( $working_dir , true );
return new WP_Error ( 'install_folder_exists' , __ ( 'Folder allready exists.' ), $filelist [ 0 ] );
}
2008-08-09 01:36:14 -04:00
2008-08-04 17:17:42 -04:00
apply_filters ( 'install_feedback' , __ ( 'Installing the plugin' ));
// Copy new version of plugin into place.
$result = copy_dir ( $working_dir , $plugins_dir );
if ( is_wp_error ( $result ) ) {
$wp_filesystem -> delete ( $working_dir , true );
return $result ;
}
2008-08-05 13:06:42 -04:00
//Get a list of the directories in the working directory before we delete it, We need to know the new folder for the plugin
$filelist = array_keys ( $wp_filesystem -> dirlist ( $working_dir ) );
2008-08-04 17:17:42 -04:00
// Remove working directory
$wp_filesystem -> delete ( $working_dir , true );
2008-08-09 01:36:14 -04:00
2008-08-05 13:06:42 -04:00
if ( empty ( $filelist ) )
return false ; //We couldnt find any files in the working dir, therefor no plugin installed? Failsafe backup.
2008-08-09 01:36:14 -04:00
2008-08-05 13:06:42 -04:00
$folder = $filelist [ 0 ];
$plugin = get_plugins ( '/' . $folder ); //Ensure to pass with leading slash
$pluginfiles = array_keys ( $plugin ); //Assume the requested plugin is the first in the list
2008-08-04 17:17:42 -04:00
2008-08-05 13:06:42 -04:00
//Return the plugin files name.
return $folder . '/' . $pluginfiles [ 0 ];
2008-08-04 17:17:42 -04:00
}
2008-10-13 19:39:56 -04:00
/**
* Install plugin from local package
*
* @ since 2.7 . 0
*
* @ param string $package
* @ param string $feedback Optional .
* @ return mixed .
*/
function wp_install_plugin_local_package ( $package , $feedback = '' ) {
global $wp_filesystem ;
if ( ! empty ( $feedback ) )
add_filter ( 'install_feedback' , $feedback );
// Is a filesystem accessor setup?
if ( ! $wp_filesystem || ! is_object ( $wp_filesystem ) )
WP_Filesystem ();
if ( ! is_object ( $wp_filesystem ) )
return new WP_Error ( 'fs_unavailable' , __ ( 'Could not access filesystem.' ));
if ( $wp_filesystem -> errors -> get_error_code () )
return new WP_Error ( 'fs_error' , __ ( 'Filesystem error' ), $wp_filesystem -> errors );
//Get the base plugin folder
$plugins_dir = $wp_filesystem -> wp_plugins_dir ();
if ( empty ( $plugins_dir ) )
return new WP_Error ( 'fs_no_plugins_dir' , __ ( 'Unable to locate WordPress Plugin directory.' ));
//And the same for the Content directory.
$content_dir = $wp_filesystem -> wp_content_dir ();
if ( empty ( $content_dir ) )
return new WP_Error ( 'fs_no_content_dir' , __ ( 'Unable to locate WordPress Content directory (wp-content).' ));
$plugins_dir = trailingslashit ( $plugins_dir );
$content_dir = trailingslashit ( $content_dir );
2008-08-04 17:17:42 -04:00
2008-10-13 19:39:56 -04:00
if ( empty ( $package ) )
return new WP_Error ( 'no_package' , __ ( 'Install package not available.' ));
if ( is_wp_error ( $download_file ) )
return new WP_Error ( 'download_failed' , __ ( 'Download failed.' ), $download_file -> get_error_message ());
$working_dir = $content_dir . 'upgrade/' . basename ( $package , '.zip' );
// Clean up working directory
if ( $wp_filesystem -> is_dir ( $working_dir ) )
$wp_filesystem -> delete ( $working_dir , true );
apply_filters ( 'install_feedback' , __ ( 'Unpacking the plugin package' ));
// Unzip package to working directory
$result = unzip_file ( $package , $working_dir );
// Once extracted, delete the package
unlink ( $package );
if ( is_wp_error ( $result ) ) {
$wp_filesystem -> delete ( $working_dir , true );
return $result ;
}
//Get a list of the directories in the working directory before we delete it, We need to know the new folder for the plugin
$filelist = array_keys ( $wp_filesystem -> dirlist ( $working_dir ) );
if ( $wp_filesystem -> exists ( $plugins_dir . $filelist [ 0 ] ) ) {
$wp_filesystem -> delete ( $working_dir , true );
return new WP_Error ( 'install_folder_exists' , __ ( 'Folder allready exists.' ), $filelist [ 0 ] );
}
apply_filters ( 'install_feedback' , __ ( 'Installing the plugin' ));
// Copy new version of plugin into place.
$result = copy_dir ( $working_dir , $plugins_dir );
if ( is_wp_error ( $result ) ) {
$wp_filesystem -> delete ( $working_dir , true );
return $result ;
}
//Get a list of the directories in the working directory before we delete it, We need to know the new folder for the plugin
$filelist = array_keys ( $wp_filesystem -> dirlist ( $working_dir ) );
// Remove working directory
$wp_filesystem -> delete ( $working_dir , true );
if ( empty ( $filelist ) )
return false ; //We couldnt find any files in the working dir, therefor no plugin installed? Failsafe backup.
$folder = $filelist [ 0 ];
$plugin = get_plugins ( '/' . $folder ); //Ensure to pass with leading slash
$pluginfiles = array_keys ( $plugin ); //Assume the requested plugin is the first in the list
//Return the plugin files name.
return $folder . '/' . $pluginfiles [ 0 ];
}
?>