wp_version = $wp_version;
// Announce that the class is ready, and pass the object (for advanced use).
do_action_ref_array( 'medics_init', array( $this ) );
// When the rest of WP has loaded, kick-start the rest of the class.
add_action( 'init', array( $this, 'init' ) );
}
/* Initialise the interactions between this class and WordPress.*/
public function init() {
// Load class strings.
$this->strings = array(
'page_title' => __( 'Install Required Plugins', 'medics' ),
'menu_title' => __( 'Install Plugins', 'medics' ),
'installing' => __( 'Installing Plugin: %s', 'medics' ),
'oops' => __( 'Something went wrong.', 'medics' ),
'notice_can_install_required' => _n_noop( 'This theme requires the following plugin: %1$s.', 'This theme requires the following plugins: %1$s.', 'medics' ),
'notice_can_install_recommended' => _n_noop( 'This theme recommends the following plugin: %1$s.', 'This theme recommends the following plugins: %1$s.', 'medics' ),
'notice_cannot_install' => _n_noop( 'Sorry, but you do not have the correct permissions to install the %s plugin. Contact the administrator of this site for help on getting the plugin installed.', 'Sorry, but you do not have the correct permissions to install the %s plugins. Contact the administrator of this site for help on getting the plugins installed.', 'medics' ),
'notice_can_activate_required' => _n_noop( 'The following required plugin is currently inactive: %1$s.', 'The following required plugins are currently inactive: %1$s.', 'medics' ),
'notice_can_activate_recommended'=> _n_noop( 'The following recommended plugin is currently inactive: %1$s.', 'The following recommended plugins are currently inactive: %1$s.', 'medics' ),
'notice_cannot_activate' => _n_noop( 'Sorry, but you do not have the correct permissions to activate the %s plugin. Contact the administrator of this site for help on getting the plugin activated.', 'Sorry, but you do not have the correct permissions to activate the %s plugins. Contact the administrator of this site for help on getting the plugins activated.', 'medics' ),
'notice_ask_to_update' => _n_noop( 'The following plugin needs to be updated to its latest version to ensure maximum compatibility with this theme: %1$s.', 'The following plugins need to be updated to their latest version to ensure maximum compatibility with this theme: %1$s.', 'medics' ),
'notice_cannot_update' => _n_noop( 'Sorry, but you do not have the correct permissions to update the %s plugin. Contact the administrator of this site for help on getting the plugin updated.', 'Sorry, but you do not have the correct permissions to update the %s plugins. Contact the administrator of this site for help on getting the plugins updated.', 'medics' ),
'install_link' => _n_noop( 'Begin installing plugin', 'Begin installing plugins', 'medics' ),
'activate_link' => _n_noop( 'Begin activating plugin', 'Begin activating plugins', 'medics' ),
'return' => __( 'Return to Required Plugins Installer', 'medics' ),
'dashboard' => __( 'Return to the dashboard', 'medics' ),
'plugin_activated' => __( 'Plugin activated successfully.', 'medics' ),
'activated_successfully' => __( 'The following plugin was activated successfully:', 'medics' ),
'complete' => __( 'All plugins installed and activated successfully. %1$s', 'medics' ),
'dismiss' => __( 'Dismiss this notice', 'medics' ),
);
do_action( 'medics_register' );
// After this point, the plugins should be registered and the configuration set.
if ( $this->plugins ) {
$sorted = array();
foreach ( $this->plugins as $plugin ) {
$sorted[] = $plugin['name'];
}
array_multisort( $sorted, SORT_ASC, $this->plugins );
add_action( 'admin_menu', array( $this, 'admin_menu' ) );
add_action( 'admin_head', array( $this, 'dismiss' ) );
add_filter( 'install_plugin_complete_actions', array( $this, 'actions' ) );
add_action( 'switch_theme', array( $this, 'flush_plugins_cache' ) );
// Load admin bar in the header to remove flash when installing plugins.
if ( $this->is_medics_page() ) {
remove_action( 'wp_footer', 'wp_admin_bar_render', 1000 );
remove_action( 'admin_footer', 'wp_admin_bar_render', 1000 );
add_action( 'wp_head', 'wp_admin_bar_render', 1000 );
add_action( 'admin_head', 'wp_admin_bar_render', 1000 );
}
if ( $this->has_notices ) {
add_action( 'admin_notices', array( $this, 'notices' ) );
add_action( 'admin_init', array( $this, 'admin_init' ), 1 );
add_action( 'admin_enqueue_scripts', array( $this, 'thickbox' ) );
add_action( 'switch_theme', array( $this, 'update_dismiss' ) );
}
// Setup the force activation hook.
foreach ( $this->plugins as $plugin ) {
if ( isset( $plugin['force_activation'] ) && true === $plugin['force_activation'] ) {
add_action( 'admin_init', array( $this, 'force_activation' ) );
break;
}
}
// Setup the force deactivation hook.
foreach ( $this->plugins as $plugin ) {
if ( isset( $plugin['force_deactivation'] ) && true === $plugin['force_deactivation'] ) {
add_action( 'switch_theme', array( $this, 'force_deactivation' ) );
break;
} } } }
/* Handles calls to show plugin information via links in the notices.*/
public function admin_init() {
if ( ! $this->is_medics_page() ) {
return;
}
if ( isset( $_REQUEST['tab'] ) && 'plugin-information' == $_REQUEST['tab'] ) {
require_once ABSPATH . 'wp-admin/includes/plugin-install.php'; // Need for install_plugin_information().
wp_enqueue_style( 'plugin-install' );
global $tab, $body_id;
$body_id = $tab = 'plugin-information';
install_plugin_information();
exit;
} }
/* Enqueues thickbox scripts/styles for plugin info. */
public function thickbox() {
if ( ! get_user_meta( get_current_user_id(), 'medics_dismissed_notice_' . $this->id, true ) ) {
add_thickbox();
} }
/* Adds submenu page under 'Appearance' tab. */
public function admin_menu() {
// Make sure privileges are correct to see the page
if ( ! current_user_can( 'install_plugins' ) ) {
return;
}
$this->populate_file_path();
foreach ( $this->plugins as $plugin ) {
if ( ! is_plugin_active( $plugin['file_path'] ) ) {
add_theme_page(
$this->strings['page_title'], // Page title.
$this->strings['menu_title'], // Menu title.
'edit_theme_options', // Capability.
$this->menu, // Menu slug.
array( $this, 'install_plugins_page' ) // Callback.
);
break;
} } }
/* Echoes plugin installation form.*/
public function install_plugins_page() {
// Store new instance of plugin table in object.
$plugin_table = new medicsPA_List_Table;
// Return early if processing a plugin installation action.
if ( isset( $_POST['action'] ) && 'medics-bulk-install' == $_POST['action'] && $plugin_table->process_bulk_actions() || $this->do_plugin_install() ) {
return;
} ?>
';
return true; // End it here if there is an error with automatic activation
} else {
echo '
' . $this->strings['plugin_activated'] . '
';
} }
// Display message based on if all plugins are now active or not.
$complete = array();
foreach ( $this->plugins as $plugin ) {
if ( ! is_plugin_active( $plugin['file_path'] ) ) {
echo '
';
$complete[] = $plugin;
break;
} else {
$complete[] = '';
} }
// Filter out any empty entries.
$complete = array_filter( $complete );
// All plugins are active, so we display the complete string and hide the plugin menu.
if ( empty( $complete ) ) {
echo '
';
return true; // End it here if there is an error with activation.
} else {
// Make sure message doesn't display again if bulk activation is performed immediately after a single activation.
if ( ! isset( $_POST['action'] ) ) {
$msg = $this->strings['activated_successfully'] . ' ' . $plugin['name'] . '.';
echo '
' . $msg . '
';
} } }
return false;
}
/* Echoes required plugin notice. */
public function notices() {
global $current_screen;
// Remove nag on the install page.
if ( $this->is_medics_page() ) { return; }
// Return early if the nag message has been dismissed.
if ( get_user_meta( get_current_user_id(), 'medics_dismissed_notice_' . $this->id, true ) ) { return; }
$installed_plugins = get_plugins(); // Retrieve a list of all the plugins
$this->populate_file_path();
$message = array(); // Store the messages in an array to be outputted after plugins have looped through.
$install_link = false; // Set to false, change to true in loop if conditions exist, used for action link 'install'.
$install_link_count = 0; // Used to determine plurality of install action link text.
$activate_link = false; // Set to false, change to true in loop if conditions exist, used for action link 'activate'.
$activate_link_count = 0; // Used to determine plurality of activate action link text.
foreach ( $this->plugins as $plugin ) {
// If the plugin is installed and active, check for minimum version argument before moving forward.
if ( is_plugin_active( $plugin['file_path'] ) ) {
// A minimum version has been specified.
if ( isset( $plugin['version'] ) ) {
if ( isset( $installed_plugins[$plugin['file_path']]['Version'] ) ) {
// If the current version is less than the minimum required version, we display a message.
if ( version_compare( $installed_plugins[$plugin['file_path']]['Version'], $plugin['version'], '<' ) ) {
if ( current_user_can( 'install_plugins' ) ) {
$message['notice_ask_to_update'][] = $plugin['name'];
} else {
$message['notice_cannot_update'][] = $plugin['name'];
} } }
else { continue; }
}
// No minimum version specified, so iterate over the plugin.
else { continue; }
}
// Not installed.
if ( ! isset( $installed_plugins[$plugin['file_path']] ) ) {
$install_link = true; // We need to display the 'install' action link.
$install_link_count++; // Increment the install link count.
if ( current_user_can( 'install_plugins' ) ) {
if ( $plugin['required'] ) { $message['notice_can_install_required'][] = $plugin['name']; }
// This plugin is only recommended.
else { $message['notice_can_install_recommended'][] = $plugin['name']; }
} else { $message['notice_cannot_install'][] = $plugin['name']; } }
// Installed but not active.
elseif ( is_plugin_inactive( $plugin['file_path'] ) ) {
$activate_link = true; // We need to display the 'activate' action link.
$activate_link_count++; // Increment the activate link count.
if ( current_user_can( 'activate_plugins' ) ) {
if ( isset( $plugin['required'] ) && $plugin['required'] ) { $message['notice_can_activate_required'][] = $plugin['name']; }
// This plugin is only recommended.
else { $message['notice_can_activate_recommended'][] = $plugin['name']; }
} else { $message['notice_cannot_activate'][] = $plugin['name']; }
} }
// If we have notices to display, we move forward.
if ( ! empty( $message ) ) {
krsort( $message ); // Sort messages.
$rendered = ''; // Display all nag messages as strings.
// If dismissable is false and a message is set, output it now.
if ( ! $this->dismissable && ! empty( $this->dismiss_msg ) ) {
$rendered .= '
' . wp_kses_post( $this->dismiss_msg ) . '
';
}
// Grab all plugin names.
foreach ( $message as $type => $plugin_groups ) {
$linked_plugin_groups = array();
// Count number of plugins in each message group to calculate singular/plural message.
$count = count( $plugin_groups );
// Loop through the plugin names to make the ones pulled from the .org repo linked.
foreach ( $plugin_groups as $plugin_group_single_name ) {
$external_url = $this->_get_plugin_data_from_name( $plugin_group_single_name, 'external_url' );
$source = $this->_get_plugin_data_from_name( $plugin_group_single_name, 'source' );
if ( $external_url && preg_match( '|^http(s)?://|', $external_url ) ) {
$linked_plugin_groups[] = '' . $plugin_group_single_name . '';
}
elseif ( ! $source || preg_match( '|^http://wordpress.org/extend/plugins/|', $source ) ) {
$url = add_query_arg(
array(
'tab' => 'plugin-information',
'plugin' => $this->_get_plugin_data_from_name( $plugin_group_single_name ),
'TB_iframe' => 'true',
'width' => '640',
'height' => '500',
),
admin_url( 'plugin-install.php' )
);
$linked_plugin_groups[] = '' . $plugin_group_single_name . '';
} else {
$linked_plugin_groups[] = $plugin_group_single_name; // No hyperlink.
}
if ( isset( $linked_plugin_groups ) && (array) $linked_plugin_groups ) {
$plugin_groups = $linked_plugin_groups;
} }
$last_plugin = array_pop( $plugin_groups ); // Pop off last name to prep for readability.
$imploded = empty( $plugin_groups ) ? '' . $last_plugin . '' : '' . ( implode( ', ', $plugin_groups ) . ' and ' . $last_plugin . '' );
$rendered .= '
';
}
// Register the nag messages and prepare them to be processed.
$nag_class = version_compare( $this->wp_version, '3.8', '<' ) ? 'updated' : 'update-nag';
if ( ! empty( $this->strings['nag_type'] ) ) {
add_settings_error( 'medics', 'medics', $rendered, sanitize_html_class( strtolower( $this->strings['nag_type'] ) ) );
} else {
add_settings_error( 'medics', 'medics', $rendered, $nag_class );
} }
// Admin options pages already output settings_errors, so this is to avoid duplication.
if ( 'options-general' !== $current_screen->parent_base ) {
settings_errors( 'medics' );
} }
/* Add dismissable admin notices. */
public function dismiss() {
if ( isset( $_GET['medics-dismiss'] ) ) {
update_user_meta( get_current_user_id(), 'medics_dismissed_notice_' . $this->id, 1 );
} }
/* Add individual plugin to our collection of plugins. */
public function register( $plugin ) {
if ( ! isset( $plugin['slug'] ) || ! isset( $plugin['name'] ) ) { return; }
foreach ( $this->plugins as $registered_plugin ) {
if ( $plugin['slug'] == $registered_plugin['slug'] ) { return; }
}
$this->plugins[] = $plugin;
}
/* Amend default configuration settings.*/
public function config( $config ) {
$keys = array( 'id', 'default_path', 'has_notices', 'dismissable', 'dismiss_msg', 'menu', 'is_automatic', 'message', 'strings' );
foreach ( $keys as $key ) {
if ( isset( $config[$key] ) ) {
if ( is_array( $config[$key] ) ) {
foreach ( $config[$key] as $subkey => $value ) {
$this->{$key}[$subkey] = $value;
} } else { $this->$key = $config[$key]; }
} } }
/* Amend action link after plugin installation. */
public function actions( $install_actions ) {
// Remove action links on the medicsPA install page.
if ( $this->is_medics_page() ) { return false; }
return $install_actions;
}
/* Flushes the plugins cache on theme switch to prevent stale entries */
public function flush_plugins_cache() { wp_cache_flush(); }
/* Set file_path key for each installed plugin. */
public function populate_file_path() {
// Add file_path key for all plugins.
foreach ( $this->plugins as $plugin => $values ) {
$this->plugins[$plugin]['file_path'] = $this->_get_plugin_basename_from_slug( $values['slug'] );
} }
/* Helper function to extract the file path of the plugin file from the plugin slug, if the plugin is installed. */
protected function _get_plugin_basename_from_slug( $slug ) {
$keys = array_keys( get_plugins() );
foreach ( $keys as $key ) {
if ( preg_match( '|^' . $slug .'/|', $key ) ) {
return $key;
} } return $slug;
}
/* Retrieve plugin data, given the plugin name. */
protected function _get_plugin_data_from_name( $name, $data = 'slug' ) {
foreach ( $this->plugins as $plugin => $values ) {
if ( $name == $values['name'] && isset( $values[$data] ) ) {
return $values[$data];
} } return false;
}
/* Determine if we're on the medicsPA Install page. */
protected function is_medics_page() {
if ( isset( $_GET['page'] ) && $this->menu === $_GET['page'] ) {
return true;
} return false;
}
/* Delete dismissable nag option when theme is switched. */
public function update_dismiss() {
delete_user_meta( get_current_user_id(), 'medics_dismissed_notice_' . $this->id );
}
/* Forces plugin activation if the parameter 'force_activation' is set to true.*/
public function force_activation() {
// Set file_path parameter for any installed plugins.
$this->populate_file_path();
$installed_plugins = get_plugins();
foreach ( $this->plugins as $plugin ) {
// Oops, plugin isn't there so iterate to next condition.
if ( isset( $plugin['force_activation'] ) && $plugin['force_activation'] && ! isset( $installed_plugins[$plugin['file_path']] ) ) { continue; }
// There we go, activate the plugin.
elseif ( isset( $plugin['force_activation'] ) && $plugin['force_activation'] && is_plugin_inactive( $plugin['file_path'] ) ) {
activate_plugin( $plugin['file_path'] );
} } }
/* Forces plugin deactivation if the parameter 'force_deactivation' is set to true.*/
public function force_deactivation() {
// Set file_path parameter for any installed plugins.
$this->populate_file_path();
foreach ( $this->plugins as $plugin ) {
// Only proceed forward if the parameter is set to true and plugin is active.
if ( isset( $plugin['force_deactivation'] ) && $plugin['force_deactivation'] && is_plugin_active( $plugin['file_path'] ) ) {
deactivate_plugins( $plugin['file_path'] );
} }}
/* Returns the singleton instance of the class. */
public static function get_instance() {
if ( ! isset( self::$instance ) && ! ( self::$instance instanceof medics_Plugin_Activation ) ) {
self::$instance = new medics_Plugin_Activation();
} return self::$instance;
} }
// Ensure only one instance of the class is ever invoked.
$medics = medics_Plugin_Activation::get_instance();
}
if ( ! function_exists( 'medics' ) ) {
/* Helper function to register a collection of required plugins. */
function medics( $plugins, $config = array() ) {
foreach ( $plugins as $plugin ) {
medics_Plugin_Activation::$instance->register( $plugin );
} if ( $config ) {
medics_Plugin_Activation::$instance->config( $config );
} } }
/* WP_List_Table isn't always available. If it isn't available, we load it here. */
if ( ! class_exists( 'WP_List_Table' ) ) { require_once( ABSPATH . 'wp-admin/includes/class-wp-list-table.php' );
}
if ( ! class_exists( 'medicsPA_List_Table' ) ) {
/* List table class for handling plugins. */
class medicsPA_List_Table extends WP_List_Table {
/* References parent constructor and sets defaults for class.*/
public function __construct() {
parent::__construct(
array(
'singular' => 'plugin',
'plural' => 'plugins',
'ajax' => false,
) );
}
/* Gathers and renames all of our plugin information to be used by WP_List_Table to create our table.*/
protected function _gather_plugin_data() {
// Load thickbox for plugin links.
medics_Plugin_Activation::$instance->admin_init();
medics_Plugin_Activation::$instance->thickbox();
// Prep variables for use and grab list of all installed plugins.
$table_data = array();
$i = 0;
$installed_plugins = get_plugins();
foreach ( medics_Plugin_Activation::$instance->plugins as $plugin ) {
if ( is_plugin_active( $plugin['file_path'] ) ) {
continue; // No need to display plugins if they are installed and activated.
}
$table_data[$i]['sanitized_plugin'] = $plugin['name'];
$table_data[$i]['slug'] = $this->_get_plugin_data_from_name( $plugin['name'] );
$external_url = $this->_get_plugin_data_from_name( $plugin['name'], 'external_url' );
$source = $this->_get_plugin_data_from_name( $plugin['name'], 'source' );
if ( $external_url && preg_match( '|^http(s)?://|', $external_url ) ) {
$table_data[$i]['plugin'] = '' . $plugin['name'] . '';
}
elseif ( ! $source || preg_match( '|^http://wordpress.org/extend/plugins/|', $source ) ) {
$url = add_query_arg(
array(
'tab' => 'plugin-information',
'plugin' => $this->_get_plugin_data_from_name( $plugin['name'] ),
'TB_iframe' => 'true',
'width' => '640',
'height' => '500',
),
admin_url( 'plugin-install.php' )
);
$table_data[$i]['plugin'] = '' . $plugin['name'] . '';
} else {
$table_data[$i]['plugin'] = '' . $plugin['name'] . ''; }
if ( isset( $table_data[$i]['plugin'] ) && (array) $table_data[$i]['plugin'] ) {
$plugin['name'] = $table_data[$i]['plugin']; }
if ( ! empty( $plugin['source'] ) ) {
// The plugin must be from a private repository.
if ( preg_match( '|^http(s)?://|', $plugin['source'] ) ) {
$table_data[$i]['source'] = __( 'Private Repository', 'medics' );
// The plugin is pre-packaged with the theme.
} else {
$table_data[$i]['source'] = __( 'Pre-Packaged', 'medics' );
} } else {
$table_data[$i]['source'] = __( 'WordPress Repository', 'medics' );
}
$table_data[$i]['type'] = isset( $plugin['required'] ) && $plugin['required'] ? __( 'Required', 'medics' ) : __( 'Recommended', 'medics' );
if ( ! isset( $installed_plugins[$plugin['file_path']] ) ) {
$table_data[$i]['status'] = sprintf( '%1$s', __( 'Not Installed', 'medics' ) );
} elseif ( is_plugin_inactive( $plugin['file_path'] ) ) {
$table_data[$i]['status'] = sprintf( '%1$s', __( 'Installed But Not Activated', 'medics' ) );
}
$table_data[$i]['file_path'] = $plugin['file_path'];
$table_data[$i]['url'] = isset( $plugin['source'] ) ? $plugin['source'] : 'repo';
$i++;
}
// Sort plugins by Required/Recommended type and by alphabetical listing within each type.
$resort = array();
$req = array();
$rec = array();
// Grab all the plugin types.
foreach ( $table_data as $plugin ) {
$resort[] = $plugin['type'];
}
// Sort each plugin by type.
foreach ( $resort as $type ) {
if ( 'Required' == $type ) {
$req[] = $type;
} else {
$rec[] = $type;
} }
// Sort alphabetically each plugin type array, merge them and then sort in reverse (lists Required plugins first).
sort( $req );
sort( $rec );
array_merge( $resort, $req, $rec );
array_multisort( $resort, SORT_DESC, $table_data );
return $table_data;
}
/* Retrieve plugin data, given the plugin name. Taken from the medics_Plugin_Activation class.*/
protected function _get_plugin_data_from_name( $name, $data = 'slug' ) {
foreach ( medics_Plugin_Activation::$instance->plugins as $plugin => $values ) {
if ( $name == $values['name'] && isset( $values[$data] ) ) {
return $values[$data];
} } return false;
}
/* Create default columns to display important plugin information */
public function column_default( $item, $column_name ) { return $item[$column_name]; }
/* Create default title column along with action links of 'Install' */
public function column_plugin( $item ) {
$installed_plugins = get_plugins();
// No need to display any hover links.
if ( is_plugin_active( $item['file_path'] ) ) { $actions = array(); }
// We need to display the 'Install' hover link.
if ( ! isset( $installed_plugins[$item['file_path']] ) ) {
$actions = array(
'install' => sprintf(
'' . __( 'Install', 'medics' ) . '',
wp_nonce_url(
add_query_arg(
array(
'page' => medics_Plugin_Activation::$instance->menu,
'plugin' => $item['slug'],
'plugin_name' => $item['sanitized_plugin'],
'plugin_source' => $item['url'],
'medics-install' => 'install-plugin',
), admin_url( 'themes.php' )
), 'medics-install'
), $item['sanitized_plugin']
),);
}
// We need to display the 'Activate' hover link.
elseif ( is_plugin_inactive( $item['file_path'] ) ) {
$actions = array(
'activate' => sprintf(
'' . __( 'Activate', 'medics' ) . '',
add_query_arg(
array(
'page' => medics_Plugin_Activation::$instance->menu,
'plugin' => $item['slug'],
'plugin_name' => $item['sanitized_plugin'],
'plugin_source' => $item['url'],
'medics-activate' => 'activate-plugin',
'medics-activate-nonce' => wp_create_nonce( 'medics-activate' ),
), admin_url( 'themes.php' )
), $item['sanitized_plugin']
), );
}
return sprintf( '%1$s %2$s', $item['plugin'], $this->row_actions( $actions ) );
}
/* Required for bulk installing. */
public function column_cb( $item ) {
$value = $item['file_path'] . ',' . $item['url'] . ',' . $item['sanitized_plugin'];
return sprintf( '', $this->_args['singular'], $value, $item['sanitized_plugin'] );
}
/* Sets default message within the plugins table if no plugins */
public function no_items() {
printf( __( 'No plugins to install or activate. Return to the Dashboard', 'medics' ), admin_url() );
echo '';
}
/* Output all the column information within the table.*/
public function get_columns() {
$columns = array(
'cb' => '',
'plugin' => __( 'Plugin', 'medics' ),
'source' => __( 'Source', 'medics' ),
'type' => __( 'Type', 'medics' ),
'status' => __( 'Status', 'medics' )
); return $columns;
}
/* Defines all types of bulk actions for handling*/
public function get_bulk_actions() {
$actions = array(
'medics-bulk-install' => __( 'Install', 'medics' ),
'medics-bulk-activate' => __( 'Activate', 'medics' ),
);
return $actions;
}
/* Processes bulk installation and activation actions. */
public function process_bulk_actions() {
// Bulk installation process.
if ( 'medics-bulk-install' === $this->current_action() ) {
check_admin_referer( 'bulk-' . $this->_args['plural'] );
// Prep variables to be populated.
$plugins_to_install = array();
$plugin_installs = array();
$plugin_path = array();
$plugin_name = array();
// Look first to see if information has been passed via WP_Filesystem.
if ( isset( $_GET['plugins'] ) ) { $plugins = explode( ',', stripslashes( $_GET['plugins'] ) ); }
// Looks like the user can use the direct method, take from $_POST.
elseif ( isset( $_POST['plugin'] ) ) { $plugins = (array) $_POST['plugin']; }
// Nothing has been submitted.
else { $plugins = array(); }
// Grab information from $_POST if available.
if ( isset( $_POST['plugin'] ) ) {
foreach ( $plugins as $plugin_data ) {
$plugins_to_install[] = explode( ',', $plugin_data );
}
foreach ( $plugins_to_install as $plugin_data ) {
$plugin_installs[] = $plugin_data[0];
$plugin_path[] = $plugin_data[1];
$plugin_name[] = $plugin_data[2];
} }
// Information has been passed via $_GET.
else {
foreach ( $plugins as $key => $value ) {
// Grab plugin slug for each plugin.
if ( 0 == $key % 3 || 0 == $key ) {
$plugins_to_install[] = $value;
$plugin_installs[] = $value;
} } }
// Look first to see if information has been passed via WP_Filesystem.
if ( isset( $_GET['plugin_paths'] ) ) { $plugin_paths = explode( ',', stripslashes( $_GET['plugin_paths'] ) ); }
// Looks like the user doesn't need to enter his FTP creds.
elseif ( isset( $_POST['plugin'] ) ) { $plugin_paths = (array) $plugin_path; }
// Nothing has been submitted.
else { $plugin_paths = array(); }
// Look first to see if information has been passed via WP_Filesystem.
if ( isset( $_GET['plugin_names'] ) ) { $plugin_names = explode( ',', stripslashes( $_GET['plugin_names'] ) ); }
// Looks like the user doesn't need to enter his FTP creds.
elseif ( isset( $_POST['plugin'] ) ) { $plugin_names = (array) $plugin_name; }
// Nothing has been submitted.
else { $plugin_names = array(); }
// Loop through plugin slugs and remove already installed plugins from the list.
$i = 0;
foreach ( $plugin_installs as $key => $plugin ) {
if ( preg_match( '|.php$|', $plugin ) ) {
unset( $plugin_installs[$key] );
// If the plugin path isn't in the $_GET variable, we can unset the corresponding path.
if ( ! isset( $_GET['plugin_paths'] ) )
unset( $plugin_paths[$i] );
// If the plugin name isn't in the $_GET variable, we can unset the corresponding name.
if ( ! isset( $_GET['plugin_names'] ) )
unset( $plugin_names[$i] );
} $i++;
}
// No need to proceed further if we have no plugins to install.
if ( empty( $plugin_installs ) ) {
echo '
' . __( 'No plugins are available to be installed at this time.', 'medics' ) . '
';
return false;
}
// Reset array indexes in case we removed already installed plugins.
$plugin_installs = array_values( $plugin_installs );
$plugin_paths = array_values( $plugin_paths );
$plugin_names = array_values( $plugin_names );
// If we grabbed our plugin info from $_GET, we need to decode it for use.
$plugin_installs = array_map( 'urldecode', $plugin_installs );
$plugin_paths = array_map( 'urldecode', $plugin_paths );
$plugin_names = array_map( 'urldecode', $plugin_names );
// Pass all necessary information via URL if WP_Filesystem is needed.
$url = wp_nonce_url(
add_query_arg(
array(
'page' => medics_Plugin_Activation::$instance->menu,
'medics-action' => 'install-selected',
'plugins' => urlencode( implode( ',', $plugins ) ),
'plugin_paths' => urlencode( implode( ',', $plugin_paths ) ),
'plugin_names' => urlencode( implode( ',', $plugin_names ) ),
), admin_url( 'themes.php' )
),'bulk-plugins'
);
$method = ''; // Leave blank so WP_Filesystem can populate it as necessary.
$fields = array( 'action', '_wp_http_referer', '_wpnonce' ); // Extra fields to pass to WP_Filesystem.
if ( false === ( $creds = request_filesystem_credentials( $url, $method, false, false, $fields ) ) ) { return true; }
if ( ! WP_Filesystem( $creds ) ) {
request_filesystem_credentials( $url, $method, true, false, $fields ); // Setup WP_Filesystem.
return true;
}
require_once ABSPATH . 'wp-admin/includes/plugin-install.php'; // Need for plugins_api
require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php'; // Need for upgrade classes
// Store all information in arrays since we are processing a bulk installation.
$api = array();
$sources = array();
$install_path = array();
// Loop through each plugin to install and try to grab information from WordPress API, if not create 'medics-empty' scalar.
$i = 0;
foreach ( $plugin_installs as $plugin ) {
$api[$i] = plugins_api( 'plugin_information', array( 'slug' => $plugin, 'fields' => array( 'sections' => false ) ) ) ? plugins_api( 'plugin_information', array( 'slug' => $plugin, 'fields' => array( 'sections' => false ) ) ) : (object) $api[$i] = 'medics-empty';
$i++;
}
if ( is_wp_error( $api ) ) { wp_die( medics_Plugin_Activation::$instance->strings['oops'] . var_dump( $api ) ); }
// Capture download links from $api or set install link to pre-packaged/private repo.
$i = 0;
foreach ( $api as $object ) {
$sources[$i] = isset( $object->download_link ) && 'repo' == $plugin_paths[$i] ? $object->download_link : $plugin_paths[$i];
$i++;
}
// Finally, all the data is prepared to be sent to the installer.
$url = add_query_arg( array( 'page' => medics_Plugin_Activation::$instance->menu ), admin_url( 'themes.php' ) );
$nonce = 'bulk-plugins';
$names = $plugin_names;
// Create a new instance of medics_Bulk_Installer.
$installer = new medics_Bulk_Installer( $skin = new medics_Bulk_Installer_Skin( compact( 'url', 'nonce', 'names' ) ) );
// Wrap the install process with the appropriate HTML.
echo '
';
echo '
' . esc_html( get_admin_page_title() ) . '
';
// Process the bulk installation submissions.
$installer->bulk_install( $sources );
echo '
';
return true;
}
// Bulk activation process.
if ( 'medics-bulk-activate' === $this->current_action() ) {
check_admin_referer( 'bulk-' . $this->_args['plural'] );
// Grab plugin data from $_POST.
$plugins = isset( $_POST['plugin'] ) ? (array) $_POST['plugin'] : array();
$plugins_to_activate = array();
// Split plugin value into array with plugin file path, plugin source and plugin name.
foreach ( $plugins as $i => $plugin ) {
$plugins_to_activate[] = explode( ',', $plugin );
}
foreach ( $plugins_to_activate as $i => $array ) {
if ( ! preg_match( '|.php$|', $array[0] ) ) {
unset( $plugins_to_activate[$i] );
} }
// Return early if there are no plugins to activate.
if ( empty( $plugins_to_activate ) ) {
echo '
' . __( 'No plugins are available to be activated at this time.', 'medics' ) . '
';
return false;
}
$plugins = array();
$plugin_names = array();
foreach ( $plugins_to_activate as $plugin_string ) {
$plugins[] = $plugin_string[0];
$plugin_names[] = $plugin_string[2];
}
$count = count( $plugin_names ); // Count so we can use _n function.
$last_plugin = array_pop( $plugin_names ); // Pop off last name to prep for readability.
$imploded = empty( $plugin_names ) ? '' . $last_plugin . '' : '' . ( implode( ', ', $plugin_names ) . ' and ' . $last_plugin . '.' );
// Now we are good to go - let's start activating plugins.
$activate = activate_plugins( $plugins );
if ( is_wp_error( $activate ) ) {
echo '
' . $activate->get_error_message() . '
';
} else {
printf( '
%1$s %2$s.
', _n( 'The following plugin was activated successfully:', 'The following plugins were activated successfully:', $count, 'medics' ), $imploded );
}
// Update recently activated plugins option.
$recent = (array) get_option( 'recently_activated' );
foreach ( $plugins as $plugin => $time ) {
if ( isset( $recent[$plugin] ) ) {
unset( $recent[$plugin] );
} }
update_option( 'recently_activated', $recent );
unset( $_POST ); // Reset the $_POST variable in case user wants to perform one action after another.
return true;
} }
/**
* Prepares all of our information to be outputted into a usable table.
*/
public function prepare_items() {
$columns = $this->get_columns(); // Get all necessary column information.
$hidden = array(); // No columns to hide, but we must set as an array.
$sortable = array(); // No reason to make sortable columns.
$this->_column_headers = array( $columns, $hidden, $sortable ); // Get all necessary column headers.
// Process our bulk actions here.
$this->process_bulk_actions();
// Store all of our plugin data into $items array so WP_List_Table can use it.
$this->items = $this->_gather_plugin_data();
} } }
/**
* The WP_Upgrader file isn't always available. If it isn't available,
*/
add_action( 'admin_init', 'medics_load_bulk_installer' );
function medics_load_bulk_installer() {
if ( ! class_exists( 'WP_Upgrader' ) && ( isset( $_GET['page'] ) && medics_Plugin_Activation::$instance->menu === $_GET['page'] ) ) {
require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';
if ( ! class_exists( 'medics_Bulk_Installer' ) ) {
/* Installer class to handle bulk plugin installations. */
class medics_Bulk_Installer extends WP_Upgrader {
/* Holds result of bulk plugin installation.*/
public $result;
/* Flag to check if bulk installation is occurring or not. */
public $bulk = false;
/* Processes the bulk installation of plugins. */
public function bulk_install( $packages ) {
// Pass installer skin object and set bulk property to true.
$this->init();
$this->bulk = true;
// Set install strings and automatic activation strings (if config option is set to true).
$this->install_strings();
if ( medics_Plugin_Activation::$instance->is_automatic ) { $this->activate_strings(); }
// Run the header string to notify user that the process has begun.
$this->skin->header();
// Connect to the Filesystem.
$res = $this->fs_connect( array( WP_CONTENT_DIR, WP_PLUGIN_DIR ) );
if ( ! $res ) { $this->skin->footer();
return false; }
// Set the bulk header and prepare results array.
$this->skin->bulk_header();
$results = array();
// Get the total number of packages being processed and iterate as each package is successfully installed.
$this->update_count = count( $packages );
$this->update_current = 0;
// Loop through each plugin and process the installation.
foreach ( $packages as $plugin ) {
$this->update_current++; // Increment counter.
// Do the plugin install.
$result = $this->run(
array(
'package' => $plugin, // The plugin source.
'destination' => WP_PLUGIN_DIR, // The destination dir.
'clear_destination' => false, // Do we want to clear the destination or not?
'clear_working' => true, // Remove original install file.
'is_multi' => true, // Are we processing multiple installs?
'hook_extra' => array( 'plugin' => $plugin, ), // Pass plugin source as extra data.
) );
// Store installation results in result property.
$results[$plugin] = $this->result;
// Prevent credentials auth screen from displaying multiple times.
if ( false === $result ) { break; } }
// Pass footer skin strings.
$this->skin->bulk_footer();
$this->skin->footer();
// Return our results.
return $results;
}
/* Performs the actual installation of each plugin. */
public function run( $options ) {
// Default config options.
$defaults = array(
'package' => '',
'destination' => '',
'clear_destination' => false,
'clear_working' => true,
'is_multi' => false,
'hook_extra' => array(),
);
// Parse default options with config options from $this->bulk_upgrade and extract them.
$options = wp_parse_args( $options, $defaults );
extract( $options );
// Connect to the Filesystem.
$res = $this->fs_connect( array( WP_CONTENT_DIR, $destination ) );
if ( ! $res ) { return false;}
// Return early if there is an error connecting to the Filesystem.
if ( is_wp_error( $res ) ) {
$this->skin->error( $res );
return $res;
}
// Call $this->header separately if running multiple times.
if ( ! $is_multi )
$this->skin->header();
// Set strings before the package is installed.
$this->skin->before();
// Download the package (this just returns the filename of the file if the package is a local file).
$download = $this->download_package( $package );
if ( is_wp_error( $download ) ) {
$this->skin->error( $download );
$this->skin->after();
return $download;
}
// Don't accidentally delete a local file.
$delete_package = ( $download != $package );
// Unzip file into a temporary working directory.
$working_dir = $this->unpack_package( $download, $delete_package );
if ( is_wp_error( $working_dir ) ) {
$this->skin->error( $working_dir );
$this->skin->after();
return $working_dir;
}
// Install the package into the working directory with all passed config options.
$result = $this->install_package(
array(
'source' => $working_dir,
'destination' => $destination,
'clear_destination' => $clear_destination,
'clear_working' => $clear_working,
'hook_extra' => $hook_extra,
)
);
// Pass the result of the installation.
$this->skin->set_result( $result );
// Set correct strings based on results.
if ( is_wp_error( $result ) ) {
$this->skin->error( $result );
$this->skin->feedback( 'process_failed' );
}
// The plugin install is successful.
else {
$this->skin->feedback( 'process_success' );
}
// Only process the activation of installed plugins if the automatic flag is set to true.
if ( medics_Plugin_Activation::$instance->is_automatic ) {
// Flush plugins cache so we can make sure that the installed plugins list is always up to date.
wp_cache_flush();
// Get the installed plugin file and activate it.
$plugin_info = $this->plugin_info( $package );
$activate = activate_plugin( $plugin_info );
// Re-populate the file path now that the plugin has been installed and activated.
medics_Plugin_Activation::$instance->populate_file_path();
// Set correct strings based on results.
if ( is_wp_error( $activate ) ) {
$this->skin->error( $activate );
$this->skin->feedback( 'activation_failed' );
}
// The plugin activation is successful.
else {
$this->skin->feedback( 'activation_success' );
}
}
// Flush plugins cache so we can make sure that the installed plugins list is always up to date.
wp_cache_flush();
// Set install footer strings.
$this->skin->after();
if ( ! $is_multi ) { $this->skin->footer(); }
return $result;
}
/* Sets the correct install strings for the installer skin to use. */
public function install_strings() {
$this->strings['no_package'] = __( 'Install package not available.', 'medics' );
$this->strings['downloading_package'] = __( 'Downloading install package from %s…', 'medics' );
$this->strings['unpack_package'] = __( 'Unpacking the package…', 'medics' );
$this->strings['installing_package'] = __( 'Installing the plugin…', 'medics' );
$this->strings['process_failed'] = __( 'Plugin install failed.', 'medics' );
$this->strings['process_success'] = __( 'Plugin installed successfully.', 'medics' );
}
/* Sets the correct activation strings for the installer skin to use.*/
public function activate_strings() {
$this->strings['activation_failed'] = __( 'Plugin activation failed.', 'medics' );
$this->strings['activation_success'] = __( 'Plugin activated successfully.', 'medics' );
}
/* Grabs the plugin file from an installed plugin.*/
public function plugin_info() {
// Return false if installation result isn't an array or the destination name isn't set.
if ( ! is_array( $this->result ) ) { return false; }
if ( empty( $this->result['destination_name'] ) ) { return false; }
/// Get the installed plugin file or return false if it isn't set.
$plugin = get_plugins( '/' . $this->result['destination_name'] );
if ( empty( $plugin ) ) { return false; }
// Assume the requested plugin is the first in the list.
$pluginfiles = array_keys( $plugin );
return $this->result['destination_name'] . '/' . $pluginfiles[0];
}
}
}
if ( ! class_exists( 'medics_Bulk_Installer_Skin' ) ) {
/* Installer skin to set strings for the bulk plugin installations. */
class medics_Bulk_Installer_Skin extends Bulk_Upgrader_Skin {
/* Holds plugin info for each individual plugin installation. */
public $plugin_info = array();
/* Holds names of plugins that are undergoing bulk installations. */
public $plugin_names = array();
/* Integer to use for iteration through each plugin installation.*/
public $i = 0;
/* Constructor. Parses default args with new ones and extracts them for use.*/
public function __construct( $args = array() ) {
// Parse default and new args.
$defaults = array( 'url' => '', 'nonce' => '', 'names' => array() );
$args = wp_parse_args( $args, $defaults );
// Set plugin names to $this->plugin_names property.
$this->plugin_names = $args['names'];
// Extract the new args.
parent::__construct( $args );
}
/* Sets install skin strings for each individual plugin. */
public function add_strings() {
// Automatic activation strings.
if ( medics_Plugin_Activation::$instance->is_automatic ) {
$this->upgrader->strings['skin_upgrade_start'] = __( 'The installation and activation process is starting. This process may take a while on some hosts, so please be patient.', 'medics' );
$this->upgrader->strings['skin_update_successful'] = __( '%1$s installed and activated successfully.', 'medics' ) . ' ' . __( 'Show Details', 'medics' ) . '' . __( 'Hide Details', 'medics' ) . '.';
$this->upgrader->strings['skin_upgrade_end'] = __( 'All installations and activations have been completed.', 'medics' );
$this->upgrader->strings['skin_before_update_header'] = __( 'Installing and Activating Plugin %1$s (%2$d/%3$d)', 'medics' );
}
// Default installation strings.
else {
$this->upgrader->strings['skin_upgrade_start'] = __( 'The installation process is starting. This process may take a while on some hosts, so please be patient.', 'medics' );
$this->upgrader->strings['skin_update_failed_error'] = __( 'An error occurred while installing %1$s: %2$s.', 'medics' );
$this->upgrader->strings['skin_update_failed'] = __( 'The installation of %1$s failed.', 'medics' );
$this->upgrader->strings['skin_update_successful'] = __( '%1$s installed successfully.', 'medics' ) . ' ' . __( 'Show Details', 'medics' ) . '' . __( 'Hide Details', 'medics' ) . '.';
$this->upgrader->strings['skin_upgrade_end'] = __( 'All installations have been completed.', 'medics' );
$this->upgrader->strings['skin_before_update_header'] = __( 'Installing Plugin %1$s (%2$d/%3$d)', 'medics' );
}
}
/* Outputs the header strings and necessary JS before each plugin installation. */
public function before( $title = '' ) {
// We are currently in the plugin installation loop, so set to true.
$this->in_loop = true;
printf( '
';
// Flush header output buffer.
$this->before_flush_output();
}
/* Outputs the footer strings and necessary JS after each plugin installation.*/
public function after( $title = '' ) {
// Close install strings.
echo '
';
// Output error strings if an error has occurred.
if ( $this->error || ! $this->result ) {
if ( $this->error ) {
echo '
';
echo '';
}
// Set in_loop and error to false and flush footer output buffer.
$this->reset();
$this->after_flush_output();
}
/* Outputs links after bulk plugin installation is complete.*/
public function bulk_footer() {
// Serve up the string to say installations (and possibly activations) are complete.
parent::bulk_footer();
// Flush plugins cache so we can make sure that the installed plugins list is always up to date.
wp_cache_flush();
// Display message based on if all plugins are now active or not.
$complete = array();
foreach ( medics_Plugin_Activation::$instance->plugins as $plugin ) {
if ( ! is_plugin_active( $plugin['file_path'] ) ) {
echo '
';
$complete[] = $plugin;
break;
} else {
$complete[] = '';
} }
// Filter out any empty entries.
$complete = array_filter( $complete );
// All plugins are active, so we display the complete string and hide the menu to protect users.
if ( empty( $complete ) ) {
echo '
 . ')