| [ Index ] |
PHP Cross Reference of Wordpress 2.7.1 |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * WordPress Plugin Install Administration API 4 * 5 * @package WordPress 6 * @subpackage Administration 7 */ 8 9 /** 10 * Retrieve plugin installer pages from WordPress Plugins API. 11 * 12 * It is possible for a plugin to override the Plugin API result with three 13 * filters. Assume this is for plugins, which can extend on the Plugin Info to 14 * offer more choices. This is very powerful and must be used with care, when 15 * overridding the filters. 16 * 17 * The first filter, 'plugins_api_args', is for the args and gives the action as 18 * the second parameter. The hook for 'plugins_api_args' must ensure that an 19 * object is returned. 20 * 21 * The second filter, 'plugins_api', is the result that would be returned. 22 * 23 * @since 2.7.0 24 * 25 * @param string $action 26 * @param array|object $args Optional. Arguments to serialize for the Plugin Info API. 27 * @return mixed 28 */ 29 function plugins_api($action, $args = null) { 30 31 if( is_array($args) ) 32 $args = (object)$args; 33 34 if ( !isset($args->per_page) ) 35 $args->per_page = 24; 36 37 $args = apply_filters('plugins_api_args', $args, $action); //NOTE: Ensure that an object is returned via this filter. 38 $res = apply_filters('plugins_api', false, $action, $args); //NOTE: Allows a plugin to completely override the builtin WordPress.org API. 39 40 if ( ! $res ) { 41 $request = wp_remote_post('http://api.wordpress.org/plugins/info/1.0/', array( 'body' => array('action' => $action, 'request' => serialize($args))) ); 42 if ( is_wp_error($request) ) { 43 $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() ); 44 } else { 45 $res = unserialize($request['body']); 46 if ( ! $res ) 47 $res = new WP_Error('plugins_api_failed', __('An unknown error occured'), $request['body']); 48 } 49 } 50 51 return apply_filters('plugins_api_result', $res, $action, $args); 52 } 53 54 /** 55 * Retrieve popular WordPress plugin tags. 56 * 57 * @since 2.7.0 58 * 59 * @param array $args 60 * @return array 61 */ 62 function install_popular_tags( $args = array() ) { 63 if ( ! ($cache = wp_cache_get('popular_tags', 'api')) && ! ($cache = get_option('wporg_popular_tags')) ) 64 add_option('wporg_popular_tags', array(), '', 'no'); ///No autoload. 65 66 if ( $cache && $cache->timeout + 3 * 60 * 60 > time() ) 67 return $cache->cached; 68 69 $tags = plugins_api('hot_tags', $args); 70 71 if ( is_wp_error($tags) ) 72 return $tags; 73 74 $cache = (object) array('timeout' => time(), 'cached' => $tags); 75 76 update_option('wporg_popular_tags', $cache); 77 wp_cache_set('popular_tags', $cache, 'api'); 78 79 return $tags; 80 } 81 add_action('install_plugins_search', 'install_search', 10, 1); 82 83 /** 84 * Display search results and display as tag cloud. 85 * 86 * @since 2.7.0 87 * 88 * @param string $page 89 */ 90 function install_search($page) { 91 $type = isset($_REQUEST['type']) ? stripslashes( $_REQUEST['type'] ) : ''; 92 $term = isset($_REQUEST['s']) ? stripslashes( $_REQUEST['s'] ) : ''; 93 94 $args = array(); 95 96 switch( $type ){ 97 case 'tag': 98 $args['tag'] = sanitize_title_with_dashes($term); 99 break; 100 case 'term': 101 $args['search'] = $term; 102 break; 103 case 'author': 104 $args['author'] = $term; 105 break; 106 } 107 108 $args['page'] = $page; 109 110 $api = plugins_api('query_plugins', $args); 111 112 if ( is_wp_error($api) ) 113 wp_die($api); 114 115 add_action('install_plugins_table_header', 'install_search_form'); 116 117 display_plugins_table($api->plugins, $api->info['page'], $api->info['pages']); 118 119 return; 120 } 121 122 add_action('install_plugins_dashboard', 'install_dashboard'); 123 function install_dashboard() { 124 ?> 125 <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> 126 127 <h4><?php _e('Search') ?></h4> 128 <?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>') ?> 129 <div id="search-help" style="display: <?php echo isset($_REQUEST['show-help']) ? 'block' : 'none'; ?>;"> 130 <p> <?php _e('You may search based on 3 criteria:') ?><br /> 131 <?php _e('<strong>Term:</strong> Searches plugins names and descriptions for the specified term') ?><br /> 132 <?php _e('<strong>Tag:</strong> Searches for plugins tagged as such') ?><br /> 133 <?php _e('<strong>Author:</strong> Searches for plugins created by the Author, or which the Author contributed to.') ?></p> 134 </div> 135 136 <h4><?php _e('Install a plugin in .zip format') ?></h4> 137 <p><?php _e('If you have a plugin in a .zip format, You may install it by uploading it here.') ?></p> 138 <form method="post" enctype="multipart/form-data" action="<?php echo admin_url('plugin-install.php?tab=upload') ?>"> 139 <?php wp_nonce_field( 'plugin-upload') ?> 140 <input type="file" name="pluginzip" /> 141 <input type="submit" class="button" value="<?php _e('Install Now') ?>" /> 142 </form> 143 144 <h4><?php _e('Popular tags') ?></h4> 145 <p><?php _e('You may also browse based on the most popular tags in the Plugin Directory:') ?></p> 146 <?php 147 148 $api_tags = install_popular_tags(); 149 150 //Set up the tags in a way which can be interprated by wp_generate_tag_cloud() 151 $tags = array(); 152 foreach ( (array)$api_tags as $tag ) 153 $tags[ $tag['name'] ] = (object) array( 154 'link' => clean_url( admin_url('plugin-install.php?tab=search&type=tag&s=' . urlencode($tag['name'])) ), 155 'name' => $tag['name'], 156 'id' => sanitize_title_with_dashes($tag['name']), 157 'count' => $tag['count'] ); 158 echo wp_generate_tag_cloud($tags, array( 'single_text' => __('%d plugin'), 'multiple_text' => __('%d plugins') ) ); 159 } 160 161 /** 162 * Display search form for searching plugins. 163 * 164 * @since 2.7.0 165 */ 166 function install_search_form(){ 167 $type = isset($_REQUEST['type']) ? stripslashes( $_REQUEST['type'] ) : ''; 168 $term = isset($_REQUEST['s']) ? stripslashes( $_REQUEST['s'] ) : ''; 169 170 ?><form id="search-plugins" method="post" action="<?php echo admin_url('plugin-install.php?tab=search') ?>"> 171 <select name="type" id="typeselector"> 172 <option value="term"<?php selected('term', $type) ?>><?php _e('Term') ?></option> 173 <option value="author"<?php selected('author', $type) ?>><?php _e('Author') ?></option> 174 <option value="tag"<?php selected('tag', $type) ?>><?php _e('Tag') ?></option> 175 </select> 176 <input type="text" name="s" id="search-field" value="<?php echo attribute_escape($term) ?>" /> 177 <input type="submit" name="search" value="<?php echo attribute_escape(__('Search')) ?>" class="button" /> 178 </form><?php 179 } 180 181 add_action('install_plugins_featured', 'install_featured', 10, 1); 182 /** 183 * Display featured plugins. 184 * 185 * @since 2.7.0 186 * 187 * @param string $page 188 */ 189 function install_featured($page = 1) { 190 $args = array('browse' => 'featured', 'page' => $page); 191 $api = plugins_api('query_plugins', $args); 192 if ( is_wp_error($api) ) 193 wp_die($api); 194 display_plugins_table($api->plugins, $api->info['page'], $api->info['pages']); 195 } 196 197 add_action('install_plugins_popular', 'install_popular', 10, 1); 198 /** 199 * Display popular plugins. 200 * 201 * @since 2.7.0 202 * 203 * @param string $page 204 */ 205 function install_popular($page = 1) { 206 $args = array('browse' => 'popular', 'page' => $page); 207 $api = plugins_api('query_plugins', $args); 208 display_plugins_table($api->plugins, $api->info['page'], $api->info['pages']); 209 } 210 211 add_action('install_plugins_new', 'install_new', 10, 1); 212 /** 213 * Display new plugins. 214 * 215 * @since 2.7.0 216 * 217 * @param string $page 218 */ 219 function install_new($page = 1) { 220 $args = array('browse' => 'new', 'page' => $page); 221 $api = plugins_api('query_plugins', $args); 222 if ( is_wp_error($api) ) 223 wp_die($api); 224 display_plugins_table($api->plugins, $api->info['page'], $api->info['pages']); 225 } 226 add_action('install_plugins_updated', 'install_updated', 10, 1); 227 228 229 /** 230 * Display recently updated plugins. 231 * 232 * @since 2.7.0 233 * 234 * @param string $page 235 */ 236 function install_updated($page = 1) { 237 $args = array('browse' => 'updated', 'page' => $page); 238 $api = plugins_api('query_plugins', $args); 239 display_plugins_table($api->plugins, $api->info['page'], $api->info['pages']); 240 } 241 242 /** 243 * Display plugin content based on plugin list. 244 * 245 * @since 2.7.0 246 * 247 * @param array $plugins List of plugins. 248 * @param string $page 249 * @param int $totalpages Number of pages. 250 */ 251 function display_plugins_table($plugins, $page = 1, $totalpages = 1){ 252 $type = isset($_REQUEST['type']) ? stripslashes( $_REQUEST['type'] ) : ''; 253 $term = isset($_REQUEST['s']) ? stripslashes( $_REQUEST['s'] ) : ''; 254 255 $plugins_allowedtags = array('a' => array('href' => array(),'title' => array(), 'target' => array()), 256 'abbr' => array('title' => array()),'acronym' => array('title' => array()), 257 'code' => array(), 'pre' => array(), 'em' => array(),'strong' => array()); 258 259 ?> 260 <div class="tablenav"> 261 <div class="alignleft actions"> 262 <?php do_action('install_plugins_table_header'); ?> 263 </div> 264 <?php 265 $url = clean_url($_SERVER['REQUEST_URI']); 266 if ( ! empty($term) ) 267 $url = add_query_arg('s', $term, $url); 268 if ( ! empty($type) ) 269 $url = add_query_arg('type', $type, $url); 270 271 $page_links = paginate_links( array( 272 'base' => add_query_arg('paged', '%#%', $url), 273 'format' => '', 274 'prev_text' => __('«'), 275 'next_text' => __('»'), 276 'total' => $totalpages, 277 'current' => $page 278 )); 279 280 if ( $page_links ) 281 echo "\t\t<div class='tablenav-pages'>$page_links</div>"; 282 ?> 283 <br class="clear" /> 284 </div> 285 <table class="widefat" id="install-plugins" cellspacing="0"> 286 <thead> 287 <tr> 288 <th scope="col" class="name"><?php _e('Name'); ?></th> 289 <th scope="col" class="num"><?php _e('Version'); ?></th> 290 <th scope="col" class="num"><?php _e('Rating'); ?></th> 291 <th scope="col" class="desc"><?php _e('Description'); ?></th> 292 <th scope="col" class="action-links"><?php _e('Actions'); ?></th> 293 </tr> 294 </thead> 295 296 <tfoot> 297 <tr> 298 <th scope="col" class="name"><?php _e('Name'); ?></th> 299 <th scope="col" class="num"><?php _e('Version'); ?></th> 300 <th scope="col" class="num"><?php _e('Rating'); ?></th> 301 <th scope="col" class="desc"><?php _e('Description'); ?></th> 302 <th scope="col" class="action-links"><?php _e('Actions'); ?></th> 303 </tr> 304 </tfoot> 305 306 <tbody class="plugins"> 307 <?php 308 if( empty($plugins) ) 309 echo '<tr><td colspan="5">', __('No plugins match your request.'), '</td></tr>'; 310 311 foreach( (array) $plugins as $plugin ){ 312 if ( is_object($plugin) ) 313 $plugin = (array) $plugin; 314 315 $title = wp_kses($plugin['name'], $plugins_allowedtags); 316 $description = wp_kses($plugin['description'], $plugins_allowedtags); 317 $version = wp_kses($plugin['version'], $plugins_allowedtags); 318 319 $name = strip_tags($title . ' ' . $version); 320 321 $author = $plugin['author']; 322 if( ! empty($plugin['author']) ) 323 $author = ' <cite>' . sprintf( __('By %s'), $author ) . '.</cite>'; 324 325 $author = wp_kses($author, $plugins_allowedtags); 326 327 if( isset($plugin['homepage']) ) 328 $title = '<a target="_blank" href="' . attribute_escape($plugin['homepage']) . '">' . $title . '</a>'; 329 330 $action_links = array(); 331 $action_links[] = '<a href="' . admin_url('plugin-install.php?tab=plugin-information&plugin=' . $plugin['slug'] . 332 '&TB_iframe=true&width=600&height=800') . '" class="thickbox onclick" title="' . 333 attribute_escape($name) . '">' . __('Install') . '</a>'; 334 335 $action_links = apply_filters('plugin_install_action_links', $action_links, $plugin); 336 ?> 337 <tr> 338 <td class="name"><?php echo $title; ?></td> 339 <td class="vers"><?php echo $version; ?></td> 340 <td class="vers"> 341 <div class="star-holder" title="<?php printf(__ngettext('(based on %s rating)', '(based on %s ratings)', $plugin['num_ratings']), number_format_i18n($plugin['num_ratings'])) ?>"> 342 <div class="star star-rating" style="width: <?php echo attribute_escape($plugin['rating']) ?>px"></div> 343 <div class="star star5"><img src="<?php echo admin_url('images/star.gif'); ?>" alt="<?php _e('5 stars') ?>" /></div> 344 <div class="star star4"><img src="<?php echo admin_url('images/star.gif'); ?>" alt="<?php _e('4 stars') ?>" /></div> 345 <div class="star star3"><img src="<?php echo admin_url('images/star.gif'); ?>" alt="<?php _e('3 stars') ?>" /></div> 346 <div class="star star2"><img src="<?php echo admin_url('images/star.gif'); ?>" alt="<?php _e('2 stars') ?>" /></div> 347 <div class="star star1"><img src="<?php echo admin_url('images/star.gif'); ?>" alt="<?php _e('1 star') ?>" /></div> 348 </div> 349 </td> 350 <td class="desc"><p><?php echo $description, $author; ?></p></td> 351 <td class="action-links"><?php if ( !empty($action_links) ) echo implode(' | ', $action_links); ?></td> 352 </tr> 353 <?php 354 } 355 ?> 356 </tbody> 357 </table> 358 359 <div class="tablenav"> 360 <?php if ( $page_links ) 361 echo "\t\t<div class='tablenav-pages'>$page_links</div>"; ?> 362 <br class="clear" /> 363 </div> 364 365 <?php 366 } 367 368 add_action('install_plugins_pre_plugin-information', 'install_plugin_information'); 369 370 /** 371 * Display plugin information in dialog box form. 372 * 373 * @since 2.7.0 374 */ 375 function install_plugin_information() { 376 global $tab; 377 378 $api = plugins_api('plugin_information', array('slug' => stripslashes( $_REQUEST['plugin'] ) )); 379 380 if ( is_wp_error($api) ) 381 wp_die($api); 382 383 $plugins_allowedtags = array('a' => array('href' => array(), 'title' => array(), 'target' => array()), 384 'abbr' => array('title' => array()), 'acronym' => array('title' => array()), 385 'code' => array(), 'pre' => array(), 'em' => array(), 'strong' => array(), 386 'div' => array(), 'p' => array(), 'ul' => array(), 'ol' => array(), 'li' => array(), 387 'h1' => array(), 'h2' => array(), 'h3' => array(), 'h4' => array(), 'h5' => array(), 'h6' => array(), 388 'img' => array('src' => array(), 'class' => array(), 'alt' => array())); 389 //Sanitize HTML 390 foreach ( (array)$api->sections as $section_name => $content ) 391 $api->sections[$section_name] = wp_kses($content, $plugins_allowedtags); 392 foreach ( array('version', 'author', 'requires', 'tested', 'homepage', 'downloaded', 'slug') as $key ) 393 $api->$key = wp_kses($api->$key, $plugins_allowedtags); 394 395 $section = isset($_REQUEST['section']) ? stripslashes( $_REQUEST['section'] ) : 'description'; //Default to the Description tab, Do not translate, API returns English. 396 if( empty($section) || ! isset($api->sections[ $section ]) ) 397 $section = array_shift( $section_titles = array_keys((array)$api->sections) ); 398 399 iframe_header( __('Plugin Install') ); 400 echo "<div id='$tab-header'>\n"; 401 echo "<ul id='sidemenu'>\n"; 402 foreach ( (array)$api->sections as $section_name => $content ) { 403 404 $title = $section_name; 405 $title = ucwords(str_replace('_', ' ', $title)); 406 407 $class = ( $section_name == $section ) ? ' class="current"' : ''; 408 $href = add_query_arg( array('tab' => $tab, 'section' => $section_name) ); 409 $href = clean_url($href); 410 $san_title = attribute_escape(sanitize_title_with_dashes($title)); 411 echo "\t<li><a name='$san_title' target='' href='$href'$class>$title</a></li>\n"; 412 } 413 echo "</ul>\n"; 414 echo "</div>\n"; 415 ?> 416 <div class="alignright fyi"> 417 <?php if ( ! empty($api->download_link) ) : ?> 418 <p class="action-button"> 419 <?php 420 //Default to a "new" plugin 421 $type = 'install'; 422 //Check to see if this plugin is known to be installed, and has an update awaiting it. 423 $update_plugins = get_option('update_plugins'); 424 foreach ( (array)$update_plugins->response as $file => $plugin ) { 425 if ( $plugin->slug === $api->slug ) { 426 $type = 'update_available'; 427 $update_file = $file; 428 break; 429 } 430 } 431 if ( 'install' == $type && is_dir( WP_PLUGIN_DIR . '/' . $api->slug ) ) { 432 $installed_plugin = get_plugins('/' . $api->slug); 433 if ( ! empty($installed_plugin) ) { 434 $key = array_shift( $key = array_keys($installed_plugin) ); //Use the first plugin regardless of the name, Could have issues for multiple-plugins in one directory if they share different version numbers 435 if ( version_compare($api->version, $installed_plugin[ $key ]['Version'], '>') ){ 436 $type = 'latest_installed'; 437 } elseif ( version_compare($api->version, $installed_plugin[ $key ]['Version'], '<') ) { 438 $type = 'newer_installed'; 439 $newer_version = $installed_plugin[ $key ]['Version']; 440 } else { 441 //If the above update check failed, Then that probably means that the update checker has out-of-date information, force a refresh 442 delete_option('update_plugins'); 443 $update_file = $api->slug . '/' . $key; //This code branch only deals with a plugin which is in a folder the same name as its slug, Doesnt support plugins which have 'non-standard' names 444 $type = 'update_available'; 445 } 446 } 447 } 448 449 switch ( $type ) : 450 default: 451 case 'install': 452 if ( current_user_can('install_plugins') ) : 453 ?><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 454 endif; 455 break; 456 case 'update_available': 457 if ( current_user_can('update_plugins') ) : 458 ?><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 459 endif; 460 break; 461 case 'newer_installed': 462 if ( current_user_can('install_plugins') || current_user_can('update_plugins') ) : 463 ?><a><?php printf(__('Newer Version (%s) Installed'), $newer_version) ?></a><?php 464 endif; 465 break; 466 case 'latest_installed': 467 if ( current_user_can('install_plugins') || current_user_can('update_plugins') ) : 468 ?><a><?php _e('Latest Version Installed') ?></a><?php 469 endif; 470 break; 471 endswitch; ?> 472 </p> 473 <?php endif; ?> 474 <h2 class="mainheader"><?php _e('FYI') ?></h2> 475 <ul> 476 <?php if ( ! empty($api->version) ) : ?> 477 <li><strong><?php _e('Version:') ?></strong> <?php echo $api->version ?></li> 478 <?php endif; if ( ! empty($api->author) ) : ?> 479 <li><strong><?php _e('Author:') ?></strong> <?php echo links_add_target($api->author, '_blank') ?></li> 480 <?php endif; if ( ! empty($api->last_updated) ) : ?> 481 <li><strong><?php _e('Last Updated:') ?></strong> <span title="<?php echo $api->last_updated ?>"><?php 482 printf( __('%s ago'), human_time_diff(strtotime($api->last_updated)) ) ?></span></li> 483 <?php endif; if ( ! empty($api->requires) ) : ?> 484 <li><strong><?php _e('Requires WordPress Version:') ?></strong> <?php printf(__('%s or higher'), $api->requires) ?></li> 485 <?php endif; if ( ! empty($api->tested) ) : ?> 486 <li><strong><?php _e('Compatible up to:') ?></strong> <?php echo $api->tested ?></li> 487 <?php endif; if ( ! empty($api->downloaded) ) : ?> 488 <li><strong><?php _e('Downloaded:') ?></strong> <?php printf(__ngettext('%s time', '%s times', $api->downloaded), number_format_i18n($api->downloaded)) ?></li> 489 <?php endif; if ( ! empty($api->slug) ) : ?> 490 <li><a target="_blank" href="http://wordpress.org/extend/plugins/<?php echo $api->slug ?>/"><?php _e('WordPress.org Plugin Page »') ?></a></li> 491 <?php endif; if ( ! empty($api->homepage) ) : ?> 492 <li><a target="_blank" href="<?php echo $api->homepage ?>"><?php _e('Plugin Homepage »') ?></a></li> 493 <?php endif; ?> 494 </ul> 495 <h2><?php _e('Average Rating') ?></h2> 496 <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)); ?>"> 497 <div class="star star-rating" style="width: <?php echo attribute_escape($api->rating) ?>px"></div> 498 <div class="star star5"><img src="<?php echo admin_url('images/star.gif'); ?>" alt="<?php _e('5 stars') ?>" /></div> 499 <div class="star star4"><img src="<?php echo admin_url('images/star.gif'); ?>" alt="<?php _e('4 stars') ?>" /></div> 500 <div class="star star3"><img src="<?php echo admin_url('images/star.gif'); ?>" alt="<?php _e('3 stars') ?>" /></div> 501 <div class="star star2"><img src="<?php echo admin_url('images/star.gif'); ?>" alt="<?php _e('2 stars') ?>" /></div> 502 <div class="star star1"><img src="<?php echo admin_url('images/star.gif'); ?>" alt="<?php _e('1 star') ?>" /></div> 503 </div> 504 <small><?php printf(__ngettext('(based on %s rating)', '(based on %s ratings)', $api->num_ratings), number_format_i18n($api->num_ratings)); ?></small> 505 </div> 506 <div id="section-holder" class="wrap"> 507 <?php 508 if ( version_compare($GLOBALS['wp_version'], $api->tested, '>') ) 509 echo '<div class="updated"><p>' . __('<strong>Warning:</strong> This plugin has <strong>not been tested</strong> with your current version of WordPress.') . '</p></div>'; 510 else if ( version_compare($GLOBALS['wp_version'], $api->requires, '<') ) 511 echo '<div class="updated"><p>' . __('<strong>Warning:</strong> This plugin has not been marked as <strong>compatible</strong> with your version of WordPress.') . '</p></div>'; 512 foreach ( (array)$api->sections as $section_name => $content ) { 513 $title = $section_name; 514 $title[0] = strtoupper($title[0]); 515 $title = str_replace('_', ' ', $title); 516 517 $content = links_add_base_url($content, 'http://wordpress.org/extend/plugins/' . $api->slug . '/'); 518 $content = links_add_target($content, '_blank'); 519 520 $san_title = attribute_escape(sanitize_title_with_dashes($title)); 521 522 $display = ( $section_name == $section ) ? 'block' : 'none'; 523 524 echo "\t<div id='section-{$san_title}' class='section' style='display: {$display};'>\n"; 525 echo "\t\t<h2 class='long-header'>$title</h2>"; 526 echo $content; 527 echo "\t</div>\n"; 528 } 529 echo "</div>\n"; 530 531 iframe_footer(); 532 exit; 533 } 534 535 536 add_action('install_plugins_upload', 'upload_plugin'); 537 function upload_plugin() { 538 539 if ( ! ( ( $uploads = wp_upload_dir() ) && false === $uploads['error'] ) ) 540 wp_die($uploads['error']); 541 542 if ( !empty($_FILES) ) 543 $filename = $_FILES['pluginzip']['name']; 544 else if ( isset($_GET['package']) ) 545 $filename = $_GET['package']; 546 547 check_admin_referer('plugin-upload'); 548 549 echo '<div class="wrap">'; 550 echo '<h2>', sprintf( __('Installing Plugin from file: %s'), basename($filename) ), '</h2>'; 551 552 //Handle a newly uploaded file, Else assume it was 553 if ( !empty($_FILES) ) { 554 $filename = wp_unique_filename( $uploads['basedir'], $filename ); 555 $local_file = $uploads['basedir'] . '/' . $filename; 556 557 // Move the file to the uploads dir 558 if ( false === @ move_uploaded_file( $_FILES['pluginzip']['tmp_name'], $local_file) ) 559 wp_die( sprintf( __('The uploaded file could not be moved to %s.' ), $uploads['path'])); 560 } else { 561 $local_file = $uploads['basedir'] . '/' . $filename; 562 } 563 564 do_plugin_install_local_package($local_file, $filename); 565 echo '</div>'; 566 } 567 568 add_action('install_plugins_install', 'install_plugin'); 569 570 /** 571 * Display plugin link and execute install. 572 * 573 * @since 2.7.0 574 */ 575 function install_plugin() { 576 577 $plugin = isset($_REQUEST['plugin']) ? stripslashes( $_REQUEST['plugin'] ) : ''; 578 579 check_admin_referer('install-plugin_' . $plugin); 580 $api = plugins_api('plugin_information', array('slug' => $plugin, 'fields' => array('sections' => false) ) ); //Save on a bit of bandwidth. 581 582 if ( is_wp_error($api) ) 583 wp_die($api); 584 585 echo '<div class="wrap">'; 586 echo '<h2>', sprintf( __('Installing Plugin: %s'), $api->name . ' ' . $api->version ), '</h2>'; 587 588 do_plugin_install($api->download_link, $api); 589 echo '</div>'; 590 591 } 592 593 /** 594 * Retrieve plugin and install. 595 * 596 * @since 2.7.0 597 * 598 * @param string $download_url Download URL. 599 * @param object $plugin_information Optional. Plugin information 600 */ 601 function do_plugin_install($download_url, $plugin_information = null) { 602 global $wp_filesystem; 603 604 if ( empty($download_url) ) { 605 show_message( __('No plugin Specified') ); 606 return; 607 } 608 609 $plugin = isset($_REQUEST['plugin']) ? stripslashes( $_REQUEST['plugin'] ) : ''; 610 611 $url = 'plugin-install.php?tab=install'; 612 $url = add_query_arg(array('plugin' => $plugin, 'plugin_name' => stripslashes( $_REQUEST['plugin_name'] ), 'download_url' => stripslashes( $_REQUEST['download_url'] ) ), $url); 613 614 $url = wp_nonce_url($url, 'install-plugin_' . $plugin); 615 if ( false === ($credentials = request_filesystem_credentials($url)) ) 616 return; 617 618 if ( ! WP_Filesystem($credentials) ) { 619 request_filesystem_credentials($url, '', true); //Failed to connect, Error and request again 620 return; 621 } 622 623 if ( $wp_filesystem->errors->get_error_code() ) { 624 foreach ( $wp_filesystem->errors->get_error_messages() as $message ) 625 show_message($message); 626 return; 627 } 628 629 $result = wp_install_plugin( $download_url, 'show_message' ); 630 631 if ( is_wp_error($result) ) { 632 show_message($result); 633 show_message( __('Installation Failed') ); 634 } else { 635 show_message( sprintf(__('Successfully installed the plugin <strong>%s %s</strong>.'), $plugin_information->name, $plugin_information->version) ); 636 $plugin_file = $result; 637 638 $install_actions = apply_filters('install_plugin_complete_actions', array( 639 '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>', 640 'plugins_page' => '<a href="' . admin_url('plugins.php') . '" title="' . attribute_escape(__('Goto plugins page')) . '" target="_parent">' . __('Return to Plugins page') . '</a>' 641 ), $plugin_information, $plugin_file); 642 if ( ! empty($install_actions) ) 643 show_message('<strong>' . __('Actions:') . '</strong> ' . implode(' | ', (array)$install_actions)); 644 } 645 } 646 647 /** 648 * Install a plugin from a local file. 649 * 650 * @since 2.7.0 651 * 652 * @param string $package Local Plugin zip 653 * @param string $filename Optional. Original filename 654 * @param object $plugin_information Optional. Plugin information 655 */ 656 function do_plugin_install_local_package($package, $filename = '') { 657 global $wp_filesystem; 658 659 if ( empty($package) ) { 660 show_message( __('No plugin Specified') ); 661 return; 662 } 663 664 if ( empty($filename) ) 665 $filename = basename($package); 666 667 $url = 'plugin-install.php?tab=upload'; 668 $url = add_query_arg(array('package' => $filename), $url); 669 670 $url = wp_nonce_url($url, 'plugin-upload'); 671 if ( false === ($credentials = request_filesystem_credentials($url)) ) 672 return; 673 674 if ( ! WP_Filesystem($credentials) ) { 675 request_filesystem_credentials($url, '', true); //Failed to connect, Error and request again 676 return; 677 } 678 679 if ( $wp_filesystem->errors->get_error_code() ) { 680 foreach ( $wp_filesystem->errors->get_error_messages() as $message ) 681 show_message($message); 682 return; 683 } 684 685 $result = wp_install_plugin_local_package( $package, 'show_message' ); 686 687 if ( is_wp_error($result) ) { 688 show_message($result); 689 show_message( __('Installation Failed') ); 690 } else { 691 show_message( __('Successfully installed the plugin.') ); 692 $plugin_file = $result; 693 694 $install_actions = apply_filters('install_plugin_complete_actions', array( 695 '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>', 696 'plugins_page' => '<a href="' . admin_url('plugins.php') . '" title="' . __('Goto plugins page') . '" target="_parent">' . __('Return to Plugins page') . '</a>' 697 ), array(), $plugin_file); 698 if ( ! empty($install_actions) ) 699 show_message('<strong>' . __('Actions:') . '</strong> ' . implode(' | ', (array)$install_actions)); 700 } 701 } 702 703 /** 704 * Install plugin. 705 * 706 * @since 2.7.0 707 * 708 * @param string $package 709 * @param string $feedback Optional. 710 * @return mixed. 711 */ 712 function wp_install_plugin($package, $feedback = '') { 713 global $wp_filesystem; 714 715 if ( !empty($feedback) ) 716 add_filter('install_feedback', $feedback); 717 718 // Is a filesystem accessor setup? 719 if ( ! $wp_filesystem || ! is_object($wp_filesystem) ) 720 WP_Filesystem(); 721 722 if ( ! is_object($wp_filesystem) ) 723 return new WP_Error('fs_unavailable', __('Could not access filesystem.')); 724 725 if ( $wp_filesystem->errors->get_error_code() ) 726 return new WP_Error('fs_error', __('Filesystem error'), $wp_filesystem->errors); 727 728 //Get the base plugin folder 729 $plugins_dir = $wp_filesystem->wp_plugins_dir(); 730 if ( empty($plugins_dir) ) 731 return new WP_Error('fs_no_plugins_dir', __('Unable to locate WordPress Plugin directory.')); 732 733 //And the same for the Content directory. 734 $content_dir = $wp_filesystem->wp_content_dir(); 735 if( empty($content_dir) ) 736 return new WP_Error('fs_no_content_dir', __('Unable to locate WordPress Content directory (wp-content).')); 737 738 $plugins_dir = trailingslashit( $plugins_dir ); 739 $content_dir = trailingslashit( $content_dir ); 740 741 if ( empty($package) ) 742 return new WP_Error('no_package', __('Install package not available.')); 743 744 // Download the package 745 apply_filters('install_feedback', sprintf(__('Downloading plugin package from %s'), $package)); 746 $download_file = download_url($package); 747 748 if ( is_wp_error($download_file) ) 749 return new WP_Error('download_failed', __('Download failed.'), $download_file->get_error_message()); 750 751 $working_dir = $content_dir . 'upgrade/' . basename($package, '.zip'); 752 753 // Clean up working directory 754 if ( $wp_filesystem->is_dir($working_dir) ) 755 $wp_filesystem->delete($working_dir, true); 756 757 apply_filters('install_feedback', __('Unpacking the plugin package')); 758 // Unzip package to working directory 759 $result = unzip_file($download_file, $working_dir); 760 761 // Once extracted, delete the package 762 @unlink($download_file); 763 764 if ( is_wp_error($result) ) { 765 $wp_filesystem->delete($working_dir, true); 766 return $result; 767 } 768 769 //Get a list of the directories in the working directory before we delete it, We need to know the new folder for the plugin 770 $filelist = array_keys( $wp_filesystem->dirlist($working_dir) ); 771 772 if( $wp_filesystem->exists( $plugins_dir . $filelist[0] ) ) { 773 $wp_filesystem->delete($working_dir, true); 774 return new WP_Error('install_folder_exists', __('Folder already exists.'), $filelist[0] ); 775 } 776 777 apply_filters('install_feedback', __('Installing the plugin')); 778 // Copy new version of plugin into place. 779 $result = copy_dir($working_dir, $plugins_dir); 780 if ( is_wp_error($result) ) { 781 $wp_filesystem->delete($working_dir, true); 782 return $result; 783 } 784 785 //Get a list of the directories in the working directory before we delete it, We need to know the new folder for the plugin 786 $filelist = array_keys( $wp_filesystem->dirlist($working_dir) ); 787 788 // Remove working directory 789 $wp_filesystem->delete($working_dir, true); 790 791 if( empty($filelist) ) 792 return false; //We couldnt find any files in the working dir, therefor no plugin installed? Failsafe backup. 793 794 $folder = $filelist[0]; 795 $plugin = get_plugins('/' . $folder); //Ensure to pass with leading slash 796 $pluginfiles = array_keys($plugin); //Assume the requested plugin is the first in the list 797 798 //Return the plugin files name. 799 return $folder . '/' . $pluginfiles[0]; 800 } 801 802 /** 803 * Install plugin from local package 804 * 805 * @since 2.7.0 806 * 807 * @param string $package 808 * @param string $feedback Optional. 809 * @return mixed. 810 */ 811 function wp_install_plugin_local_package($package, $feedback = '') { 812 global $wp_filesystem; 813 814 if ( !empty($feedback) ) 815 add_filter('install_feedback', $feedback); 816 817 // Is a filesystem accessor setup? 818 if ( ! $wp_filesystem || ! is_object($wp_filesystem) ) 819 WP_Filesystem(); 820 821 if ( ! is_object($wp_filesystem) ) 822 return new WP_Error('fs_unavailable', __('Could not access filesystem.')); 823 824 if ( $wp_filesystem->errors->get_error_code() ) 825 return new WP_Error('fs_error', __('Filesystem error'), $wp_filesystem->errors); 826 827 //Get the base plugin folder 828 $plugins_dir = $wp_filesystem->wp_plugins_dir(); 829 if ( empty($plugins_dir) ) 830 return new WP_Error('fs_no_plugins_dir', __('Unable to locate WordPress Plugin directory.')); 831 832 //And the same for the Content directory. 833 $content_dir = $wp_filesystem->wp_content_dir(); 834 if( empty($content_dir) ) 835 return new WP_Error('fs_no_content_dir', __('Unable to locate WordPress Content directory (wp-content).')); 836 837 $plugins_dir = trailingslashit( $plugins_dir ); 838 $content_dir = trailingslashit( $content_dir ); 839 840 if ( empty($package) ) 841 return new WP_Error('no_package', __('Install package not available.')); 842 843 $working_dir = $content_dir . 'upgrade/' . basename($package, '.zip'); 844 845 // Clean up working directory 846 if ( $wp_filesystem->is_dir($working_dir) ) 847 $wp_filesystem->delete($working_dir, true); 848 849 apply_filters('install_feedback', __('Unpacking the plugin package')); 850 // Unzip package to working directory 851 $result = unzip_file($package, $working_dir); 852 853 // Once extracted, delete the package 854 unlink($package); 855 856 if ( is_wp_error($result) ) { 857 $wp_filesystem->delete($working_dir, true); 858 return $result; 859 } 860 861 //Get a list of the directories in the working directory before we delete it, We need to know the new folder for the plugin 862 $filelist = array_keys( $wp_filesystem->dirlist($working_dir) ); 863 864 if( $wp_filesystem->exists( $plugins_dir . $filelist[0] ) ) { 865 $wp_filesystem->delete($working_dir, true); 866 return new WP_Error('install_folder_exists', __('Folder already exists.'), $filelist[0] ); 867 } 868 869 apply_filters('install_feedback', __('Installing the plugin')); 870 // Copy new version of plugin into place. 871 $result = copy_dir($working_dir, $plugins_dir); 872 if ( is_wp_error($result) ) { 873 $wp_filesystem->delete($working_dir, true); 874 return $result; 875 } 876 877 //Get a list of the directories in the working directory before we delete it, We need to know the new folder for the plugin 878 $filelist = array_keys( $wp_filesystem->dirlist($working_dir) ); 879 880 // Remove working directory 881 $wp_filesystem->delete($working_dir, true); 882 883 if( empty($filelist) ) 884 return false; //We couldnt find any files in the working dir, therefor no plugin installed? Failsafe backup. 885 886 $folder = $filelist[0]; 887 $plugin = get_plugins('/' . $folder); //Ensure to pass with leading slash 888 $pluginfiles = array_keys($plugin); //Assume the requested plugin is the first in the list 889 890 //Return the plugin files name. 891 return $folder . '/' . $pluginfiles[0]; 892 } 893 894 ?>
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Mon Mar 23 16:23:02 2009 | Cross-referenced by PHPXref 0.7 |