per_page) ) $args->per_page = 24; $args = apply_filters('plugins_api_args', $args, $action); //NOTE: Ensure that an object is returned via this filter. $res = apply_filters('plugins_api', false, $action, $args); //NOTE: Allows a plugin to completely override the builtin WordPress.org API. if ( ! $res ) { $request = wp_remote_post('http://api.wordpress.org/plugins/info/1.0/', array( 'body' => array('action' => $action, 'request' => serialize($args))) ); if ( is_wp_error($request) ) { $res = new WP_Error('plugins_api_failed', __('An Unexpected HTTP Error occured during the API request.

Try again'), $request->get_error_message() ); } else { $res = unserialize($request['body']); if ( ! $res ) $res = new WP_Error('plugins_api_failed', __('An unknown error occured'), $request['body']); } } return apply_filters('plugins_api_result', $res, $action, $args); } /** * Retrieve popular WordPress plugin tags. * * @since 2.7.0 * * @param array $args * @return array */ function install_popular_tags( $args = array() ) { if ( ! ($cache = wp_cache_get('popular_tags', 'api')) && ! ($cache = get_option('wporg_popular_tags')) ) add_option('wporg_popular_tags', array(), '', 'no'); ///No autoload. if ( $cache && $cache->timeout + 3 * 60 * 60 > time() ) return $cache->cached; $tags = plugins_api('hot_tags', $args); if ( is_wp_error($tags) ) return $tags; $cache = (object) array('timeout' => time(), 'cached' => $tags); update_option('wporg_popular_tags', $cache); wp_cache_set('popular_tags', $cache, 'api'); return $tags; } add_action('install_plugins_search', 'install_search', 10, 1); /** * Display search results and display as tag cloud. * * @since 2.7.0 * * @param string $page */ function install_search($page) { $type = isset($_REQUEST['type']) ? stripslashes( $_REQUEST['type'] ) : ''; $term = isset($_REQUEST['s']) ? stripslashes( $_REQUEST['s'] ) : ''; $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; } $args['page'] = $page; $api = plugins_api('query_plugins', $args); if ( is_wp_error($api) ) wp_die($api); add_action('install_plugins_table_header', 'install_search_form'); display_plugins_table($api->plugins, $api->info['page'], $api->info['pages']); return; } add_action('install_plugins_dashboard', 'install_dashboard'); function install_dashboard() { ?>

WordPress Plugin Directory or upload a plugin in .zip format via this page.') ?>

' . __('[need help?]') . '') ?>


Term: Searches plugins names and descriptions for the specified term') ?>
Tag: Searches for plugins tagged as such') ?>
Author: Searches for plugins created by the Author, or which the Author contributed to.') ?>

clean_url( admin_url('plugin-install.php?tab=search&type=tag&s=' . urlencode($tag['name'])) ), 'name' => $tag['name'], 'id' => sanitize_title_with_dashes($tag['name']), 'count' => $tag['count'] ); echo wp_generate_tag_cloud($tags, array( 'single_text' => __('%d plugin'), 'multiple_text' => __('%d plugins') ) ); } /** * Display search form for searching plugins. * * @since 2.7.0 */ function install_search_form(){ $type = isset($_REQUEST['type']) ? stripslashes( $_REQUEST['type'] ) : ''; $term = isset($_REQUEST['s']) ? stripslashes( $_REQUEST['s'] ) : ''; ?>
'featured', 'page' => $page); $api = plugins_api('query_plugins', $args); if ( is_wp_error($api) ) wp_die($api); display_plugins_table($api->plugins, $api->info['page'], $api->info['pages']); } add_action('install_plugins_popular', 'install_popular', 10, 1); /** * Display popular plugins. * * @since 2.7.0 * * @param string $page */ function install_popular($page = 1) { $args = array('browse' => 'popular', 'page' => $page); $api = plugins_api('query_plugins', $args); display_plugins_table($api->plugins, $api->info['page'], $api->info['pages']); } add_action('install_plugins_new', 'install_new', 10, 1); /** * Display new plugins. * * @since 2.7.0 * * @param string $page */ function install_new($page = 1) { $args = array('browse' => 'new', 'page' => $page); $api = plugins_api('query_plugins', $args); if ( is_wp_error($api) ) wp_die($api); display_plugins_table($api->plugins, $api->info['page'], $api->info['pages']); } add_action('install_plugins_updated', 'install_updated', 10, 1); /** * Display recently updated plugins. * * @since 2.7.0 * * @param string $page */ function install_updated($page = 1) { $args = array('browse' => 'updated', 'page' => $page); $api = plugins_api('query_plugins', $args); display_plugins_table($api->plugins, $api->info['page'], $api->info['pages']); } /** * 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. */ function display_plugins_table($plugins, $page = 1, $totalpages = 1){ $type = isset($_REQUEST['type']) ? stripslashes( $_REQUEST['type'] ) : ''; $term = isset($_REQUEST['s']) ? stripslashes( $_REQUEST['s'] ) : ''; $plugins_allowedtags = array('a' => array('href' => array(),'title' => array(), 'target' => array()), 'abbr' => array('title' => array()),'acronym' => array('title' => array()), 'code' => array(), 'pre' => array(), 'em' => array(),'strong' => array()); ?>
add_query_arg('paged', '%#%', $url), 'format' => '', 'prev_text' => __('«'), 'next_text' => __('»'), 'total' => $totalpages, 'current' => $page )); if ( $page_links ) echo "\t\t
$page_links
"; ?>
'; 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); $name = strip_tags($title . ' ' . $version); $author = $plugin['author']; if( ! empty($plugin['author']) ) $author = ' ' . sprintf( __('By %s'), $author ) . '.'; $author = wp_kses($author, $plugins_allowedtags); if( isset($plugin['homepage']) ) $title = '' . $title . ''; $action_links = array(); $action_links[] = '' . __('Install') . ''; $action_links = apply_filters('plugin_install_action_links', $action_links, $plugin); ?>
', __('No plugins match your request.'), '
<?php _e('5 stars') ?>
<?php _e('4 stars') ?>
<?php _e('3 stars') ?>
<?php _e('2 stars') ?>
<?php _e('1 star') ?>

$page_links
"; ?>
stripslashes( $_REQUEST['plugin'] ) )); 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()), '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())); //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); $section = isset($_REQUEST['section']) ? stripslashes( $_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) ); iframe_header( __('Plugin Install') ); echo "
\n"; echo "\n"; echo "
\n"; ?>
download_link) ) : ?>

response as $file => $plugin ) { if ( $plugin->slug === $api->slug ) { $type = 'update_available'; $update_file = $file; break; } } if ( 'install' == $type && is_dir( WP_PLUGIN_DIR . '/' . $api->slug ) ) { $installed_plugin = get_plugins('/' . $api->slug); if ( ! empty($installed_plugin) ) { $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 if ( version_compare($api->version, $installed_plugin[ $key ]['Version'], '>') ){ $type = 'latest_installed'; } elseif ( version_compare($api->version, $installed_plugin[ $key ]['Version'], '<') ) { $type = 'newer_installed'; $newer_version = $installed_plugin[ $key ]['Version']; } else { //If the above update check failed, Then that probably means that the update checker has out-of-date information, force a refresh update_option( 'update_plugins', false ); $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 $type = 'update_available'; } } } switch ( $type ) : default: case 'install': if ( current_user_can('install_plugins') ) : ?>

<?php _e('5 stars') ?>
<?php _e('4 stars') ?>
<?php _e('3 stars') ?>
<?php _e('2 stars') ?>
<?php _e('1 star') ?>
num_ratings), number_format_i18n($api->num_ratings)); ?>
tested, '>') ) echo '

' . __('Warning: This plugin has not been tested with your current version of WordPress.') . '

'; else if ( version_compare($GLOBALS['wp_version'], $api->requires, '<') ) echo '

' . __('Warning: This plugin has not been marked as compatible with your version of WordPress.') . '

'; foreach ( (array)$api->sections as $section_name => $content ) { $title = $section_name; $title[0] = strtoupper($title[0]); $title = str_replace('_', ' ', $title); $content = links_add_base_url($content, 'http://wordpress.org/extend/plugins/' . $api->slug . '/'); $content = links_add_target($content, '_blank'); $san_title = attribute_escape(sanitize_title_with_dashes($title)); $display = ( $section_name == $section ) ? 'block' : 'none'; echo "\t
\n"; echo "\t\t

$title

"; echo $content; echo "\t
\n"; } echo "
\n"; iframe_footer(); exit; } 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 '
'; echo '

', sprintf( __('Installing Plugin from file: %s'), basename($filename) ), '

'; //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 '
'; } add_action('install_plugins_install', 'install_plugin'); /** * Display plugin link and execute install. * * @since 2.7.0 */ function install_plugin() { $plugin = isset($_REQUEST['plugin']) ? stripslashes( $_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. if ( is_wp_error($api) ) wp_die($api); echo '
'; echo '

', sprintf( __('Installing Plugin: %s'), $api->name . ' ' . $api->version ), '

'; do_plugin_install($api->download_link, $api); echo '
'; } /** * Retrieve plugin and install. * * @since 2.7.0 * * @param string $download_url Download URL. * @param object $plugin_information Optional. Plugin information */ function do_plugin_install($download_url, $plugin_information = null) { global $wp_filesystem; if ( empty($download_url) ) { show_message( __('No plugin Specified') ); return; } $plugin = isset($_REQUEST['plugin']) ? stripslashes( $_REQUEST['plugin'] ) : ''; $url = 'plugin-install.php?tab=install'; $url = add_query_arg(array('plugin' => $plugin, 'plugin_name' => stripslashes( $_REQUEST['plugin_name'] ), 'download_url' => stripslashes( $_REQUEST['download_url'] ) ), $url); $url = wp_nonce_url($url, 'install-plugin_' . $plugin); 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' ); if ( is_wp_error($result) ) { show_message($result); show_message( __('Installation Failed') ); } else { show_message( sprintf(__('Successfully installed the plugin %s %s.'), $plugin_information->name, $plugin_information->version) ); $plugin_file = $result; $install_actions = apply_filters('install_plugin_complete_actions', array( 'activate_plugin' => '' . __('Activate Plugin') . '', 'plugins_page' => '' . __('Return to Plugins page') . '' ), $plugin_information, $plugin_file); if ( ! empty($install_actions) ) show_message('' . __('Actions:') . ' ' . implode(' | ', (array)$install_actions)); } } /** * 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; } $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' => '' . __('Activate Plugin') . '', 'plugins_page' => '' . __('Return to Plugins page') . '' ), array(), $plugin_file); if ( ! empty($install_actions) ) show_message('' . __('Actions:') . ' ' . implode(' | ', (array)$install_actions)); } } /** * Install plugin. * * @since 2.7.0 * * @param string $package * @param string $feedback Optional. * @return mixed. */ 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).')); $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); // Once extracted, delete the package @unlink($download_file); 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 already 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]; } /** * 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 ); if ( empty($package) ) return new WP_Error('no_package', __('Install package not available.')); $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 already 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]; } ?>