base || 'themes' === $screen->base || 'plugins' === $screen->base ) ) {
return;
}
// Get the plugin enhancements information declared by the theme.
$this->dependencies = $this->get_theme_dependencies();
// Return early if we have no plugin dependencies.
if ( empty( $this->dependencies ) ) :
return;
// Otherwise, build an array to list all the required dependencies and modules.
else :
$dependency_list = ' ';
$this->modules = array();
// Create a list of dependencies.
foreach ( $this->dependencies as $dependency ) :
if ( ' ' !== $dependency_list ) :
$dependency_list .= ', ';
endif;
// Add to our list of recommended modules.
if ( 'none' !== $dependency['module'] ) :
$this->modules[ $dependency['name'] ] = $dependency['module'];
endif;
// Build human-readable list.
$dependency_list .= $dependency['name'] . ' (' . $this->get_module_name( $dependency['module'] ) . ')';
endforeach;
// Define our Jetpack plugin as a required plugin.
$this->plugins = array(
array(
'slug' => 'jetpack',
'name' => 'Jetpack by WordPress.com',
'message' => sprintf(
__( 'The %1$s is required to use some of this theme’s features, including: ', 'canape' ),
'' . __( 'Jetpack plugin', 'canape' ) . '' ),
'modules' => $dependency_list . '.',
),
);
endif;
// Set the status of each of these enhancements and determine if a notice is needed.
$this->set_plugin_status();
$this->set_module_status();
// Output the corresponding notices in the admin.
if ( $this->display_notice && current_user_can( 'install_plugins' ) ) {
add_action( 'admin_notices', array( $this, 'admin_notices' ) );
}
}
/**
* Let's see which modules (if any!) this theme relies on.
*/
function get_theme_dependencies() {
if ( current_theme_supports( 'site-logo' ) ) :
$dependencies['logo'] = array(
'name' => 'Site Logo',
'slug' => 'site-logo',
'url' => '',
'module' => 'none',
);
endif;
if ( current_theme_supports( 'featured-content' ) ) :
$dependencies['featured-content'] = array(
'name' => 'Featured Content',
'slug' => 'featured-content',
'url' => '',
'module' => 'none',
);
endif;
if ( current_theme_supports( 'nova_menu_item' ) ) :
$dependencies['menus'] = array(
'name' => 'Menus',
'slug' => 'nova_menu_item',
'url' => '',
'module' => 'custom-content-types',
);
endif;
if ( current_theme_supports( 'jetpack-comic' ) ) :
$dependencies['comics'] = array(
'name' => 'Comics',
'slug' => 'jetpack-comic',
'url' => '',
'module' => 'custom-content-types',
);
endif;
if ( current_theme_supports( 'jetpack-testimonial' ) ) :
$dependencies['testimonials'] = array(
'name' => 'Testimonials',
'slug' => 'jetpack-testimonial',
'url' => '',
'module' => 'custom-content-types',
);
endif;
if ( current_theme_supports( 'jetpack-portfolio' ) ) :
$dependencies['portfolios'] = array(
'name' => 'Portfolios',
'slug' => 'jetpack-portfolio',
'url' => '',
'module' => 'custom-content-types',
);
endif;
return $dependencies;
}
/**
* Set the name of our modules. This is just so we can easily refer to them in
* a nice, consistent, human-readable way.
*
* @param var $module The slug of the Jetpack module in question.
*/
function get_module_name( $module ) {
$module_names = array(
'none' => __( 'no specific module needed', 'canape' ),
'custom-content-types' => __( 'Custom Content Types module', 'canape' ),
);
return $module_names[ $module ];
}
/**
* Determine the status of each of the plugins declared as a dependency
* by the theme and whether an admin notice is needed or not.
*/
function set_plugin_status() {
// Get the names of the installed plugins.
$installed_plugin_names = wp_list_pluck( get_plugins(), 'Name' );
foreach ( $this->plugins as $key => $plugin ) {
// Determine whether a plugin is installed.
if ( in_array( $plugin['name'], $installed_plugin_names ) ) {
// Determine whether the plugin is active. If yes, remove if from
// the array containing the plugin enhancements.
if ( is_plugin_active( array_search( $plugin['name'], $installed_plugin_names ) ) ) {
unset( $this->plugins[ $key ] );
} // Set the plugin status as to-activate.
else {
$this->plugins[ $key ]['status'] = 'to-activate';
$this->display_notice = true;
}
// Set the plugin status as to-install.
} else {
$this->plugins[ $key ]['status'] = 'to-install';
$this->display_notice = true;
}
}
}
/**
* For Jetpack modules, we want to check and see if those modules are actually activated.
*/
function set_module_status() {
$this->unactivated_modules = array();
// Loop through each module to check if it's active.
foreach ( $this->modules as $feature => $module ) :
if ( class_exists( 'Jetpack' ) && ! Jetpack::is_module_active( $module ) ) :
// Add this feature to our array.
$this->unactivated_modules[ $module ][] = $feature;
$this->display_notice = true;
endif;
endforeach;
}
/**
* Display the admin notice for the plugin enhancements.
*/
function admin_notices() {
$notice = '';
// Loop through the plugins and print the message and the download or active links.
foreach ( $this->plugins as $key => $plugin ) {
$notice .= '';
// Custom message provided by the theme.
if ( isset( $plugin['message'] ) ) {
$notice .= $plugin['message'];
$notice .= esc_html( $plugin['modules'] );
}
// Activation message.
if ( 'to-activate' === $plugin['status'] ) {
$activate_url = $this->plugin_activate_url( $plugin['slug'] );
$notice .= sprintf(
__( ' Please activate %1$s. %2$s', 'canape' ),
esc_html( $plugin['name'] ),
( $activate_url ) ? '' . __( 'Activate', 'canape' ) . '' : ''
);
}
// Download message.
if ( 'to-install' === $plugin['status'] ) {
$install_url = $this->plugin_install_url( $plugin['slug'] );
$notice .= sprintf(
__( ' Please install %1$s. %2$s', 'canape' ),
esc_html( $plugin['name'] ),
( $install_url ) ? '' . __( 'Install', 'canape' ) . '' : ''
);
}
$notice .= '
';
}
// Output a notice if we're missing a module.
foreach ( $this->unactivated_modules as $module => $features ) :
$featurelist = '';
$count = 1;
$total = count( $features );
foreach ( $features as $feature ) :
if ( $total === $count && 2 === $count ) :
$featurelist .= ' or ';
elseif ( $total === $count && $count > 2 ) :
$featurelist .= ', or ';
elseif ( 1 < $count ) :
$featurelist .= ', ';
endif;
$featurelist .= $feature;
$count++;
endforeach;
$notice .= '';
$notice .= sprintf(
__( 'To use %1$s, please activate the Jetpack plugin’s %2$s.', 'canape' ),
esc_html( $featurelist ),
'' . esc_html( $this->get_module_name( $module ) ) . ''
);
$notice .= '
';
endforeach;
// Output notice HTML.
$allowed = array(
'p' => array(),
'strong' => array(),
'em' => array(),
'b' => array(),
'i' => array(),
'a' => array( 'href' => array() ),
);
printf(
'%s
',
wp_kses( $notice, $allowed )
);
}
/**
* Helper function to return the URL for activating a plugin.
*
* @param var $slug Plugin slug; determines which plugin to activate.
*/
function plugin_activate_url( $slug ) {
// Find the path to the plugin.
$plugin_paths = array_keys( get_plugins() );
$plugin_path = false;
foreach ( $plugin_paths as $path ) {
if ( preg_match( '|^' . $slug .'|', $path ) ) {
$plugin_path = $path;
}
}
if ( ! $plugin_path ) {
return false;
} else {
return wp_nonce_url(
self_admin_url( 'plugins.php?action=activate&plugin=' . $plugin_path ),
'activate-plugin_' . $plugin_path
);
}
}
/**
* Helper function to return the URL for installing a plugin.
*
* @param var $slug Plugin slug; determines which plugin to install.
*/
function plugin_install_url( $slug ) {
/*
Include Plugin Install Administration API to get access to the
* plugins_api() function
*/
include_once ABSPATH . 'wp-admin/includes/plugin-install.php';
$plugin_information = plugins_api( 'plugin_information', array( 'slug' => $slug ) );
if ( is_wp_error( $plugin_information ) ) {
return false;
} else {
return wp_nonce_url(
self_admin_url( 'update.php?action=install-plugin&plugin=' . $slug ),
'install-plugin_' . $slug
);
}
}
}
add_action( 'admin_head', array( 'Theme_Plugin_Enhancements', 'init' ) );