<?php
/**
* This file represents an example of the code that themes would use to register
* the required plugins.
*
* It is expected that theme authors would copy and paste this code into their
* functions.php file, and amend to suit.
*
* @package TGM-Plugin-Activation
* @subpackage Example
* @version 2.4.0
* @author Thomas Griffin <thomasgriffinmedia.com>
* @author Gary Jones <gamajo.com>
* @copyright Copyright (c) 2014, Thomas Griffin
* @license http://opensource.org/licenses/gpl-2.0.php GPL v2 or later
* @link https://github.com/thomasgriffin/TGM-Plugin-Activation
*/
/**
* Include the TGM_Plugin_Activation class.
*/
require_once dirname( __FILE__ ) . '/class-tgm-plugin-activation.php';
add_action( 'tgmpa_register', 'genesischild_register_required_plugins' );
/**
* Register the required plugins for this theme.
*
* In this example, we register two plugins - one included with the TGMPA library
* and one from the .org repo.
*
* The variable passed to tgmpa_register_plugins() should be an array of plugin
* arrays.
*
* This function is hooked into tgmpa_init, which is fired within the
* TGM_Plugin_Activation class constructor.
*/
function genesischild_register_required_plugins() {
/**
* Array of plugin arrays. Required keys are name and slug.
* If the source is NOT from the .org repo, then source is also required.
*/
$plugins = array(
// This is an example of how to include a plugin pre-packaged with a theme.
array(
'name' => 'Beaver Builder Plugin (Pro Version)', // The plugin name.
'slug' => 'bb-plugin-pro', // The plugin slug (typically the folder name).
'source' => get_stylesheet_directory() . '/lib/plugins/bb-plugin-pro.zip', // The plugin source.
'required' => false, // If false, the plugin is only 'recommended' instead of required.
'version' => '1.5.7.2', // E.g. 1.0.0. If set, the active plugin must be this version or higher.
'force_activation' => false, // If true, plugin is activated upon theme activation and cannot be deactivated until theme switch.
'force_deactivation' => false, // If true, plugin is deactivated upon theme switch, useful for theme-specific plugins.
'external_url' => '', // If set, overrides default API URL and points to an external URL.
),
// This is an example of how to include a plugin pre-packaged with a theme.
array(
'name' => 'ACF', // The plugin name.
'slug' => 'advanced-custom-fields', // The plugin slug (typically the folder name).
'source' => get_stylesheet_directory() . '/lib/plugins/advanced-custom-fields-pro.zip', // The plugin source.
'required' => false, // If false, the plugin is only 'recommended' instead of required.
'version' => '5.2.5', // E.g. 1.0.0. If set, the active plugin must be this version or higher.
'force_activation' => false, // If true, plugin is activated upon theme activation and cannot be deactivated until theme switch.
'force_deactivation' => false, // If true, plugin is deactivated upon theme switch, useful for theme-specific plugins.
'external_url' => '', // If set, overrides default API URL and points to an external URL.
),
// This is an example of how to include a plugin pre-packaged with a theme.
array(
'name' => 'Gravity Forms', // The plugin name.
'slug' => 'gravityforms', // The plugin slug (typically the folder name).
'source' => get_stylesheet_directory() . '/lib/plugins/gravityforms_1.9.8.zip', // The plugin source.
'required' => false, // If false, the plugin is only 'recommended' instead of required.
'version' => '1.9.8', // E.g. 1.0.0. If set, the active plugin must be this version or higher.
'force_activation' => false, // If true, plugin is activated upon theme activation and cannot be deactivated until theme switch.
'force_deactivation' => false, // If true, plugin is deactivated upon theme switch, useful for theme-specific plugins.
'external_url' => '', // If set, overrides default API URL and points to an external URL.
),
// This is an example of how to include a plugin from a private repo in your theme.
array(
'name' => 'featured-custom-post-type-widget-for-genesis', // The plugin name.
'slug' => 'featured-custom-post-type-widget-for-genesis', // The plugin slug (typically the folder name).
'source' => 'https://github.com/neilgee/featured-custom-post-type-widget-for-genesis/archive/master.zip', // The plugin source.
'required' => false, // If false, the plugin is only 'recommended' instead of required.
'external_url' => 'https://github.com/neilgee/featured-custom-post-type-widget-for-genesis/', // If set, overrides default API URL and points to an external URL.
),
// This is an example of how to include a plugin from the WordPress Plugin Repository.
array(
'name' => 'Adminimize',
'slug' => 'adminimize',
'required' => false,
),
array(
'name' => 'Akismet',
'slug' => 'akismet',
'required' => false,
),
array(
'name' => 'Better Font Awesome',
'slug' => 'better-font-awesome',
'required' => false,
),
array(
'name' => 'BuddyPress',
'slug' => 'buddypress',
'required' => false,
),
array(
'name' => 'Bootstrap Modals',
'slug' => 'bootstrap-modals',
'required' => false,
),
array(
'name' => 'Business Profile',
'slug' => 'business-profile',
'required' => false,
),
array(
'name' => 'Cyclone Slider 2',
'slug' => 'cyclone-slider-2',
'required' => false,
),
array(
'name' => 'Disable Visual Editor',
'slug' => 'disable-visual-editor-wysiwyg',
'required' => false,
),
array(
'name' => 'Duplicate Post',
'slug' => 'duplicate-post',
'required' => false,
),
array(
'name' => 'Duplicator',
'slug' => 'duplicator',
'required' => false,
),
array(
'name' => 'Dynamic Widgets',
'slug' => 'dynamic-widgets',
'required' => false,
),
array(
'name' => 'EWWW Image Optimizer',
'slug' => 'ewww-image-optimizer',
'required' => false,
),
array(
'name' => 'Genesis eNews Extended',
'slug' => 'genesis-enews-extended',
'required' => false,
),
array(
'name' => 'Genesis Woocommerce',
'slug' => 'genesis-connect-woocommerce',
'required' => false,
),
array(
'name' => 'Genesis Simple Sidebars',
'slug' => 'genesis-simple-sidebars',
'required' => false,
),
array(
'name' => 'Genesis Simple Share',
'slug' => 'genesis-simple-share',
'required' => false,
),
array(
'name' => 'Genesis Title Toggle',
'slug' => 'genesis-title-toggle',
'required' => false,
),
array(
'name' => 'Genesis Visual Hook Guide',
'slug' => 'genesis-visual-hook-guide',
'required' => false,
),
array(
'name' => 'Genesis Responsive Slider',
'slug' => 'genesis-responsive-slider',
'required' => false,
),
array(
'name' => 'Genesis Featured Page Advanced',
'slug' => 'genesis-featured-page-advanced',
'required' => false,
),
array(
'name' => 'Post Types Order',
'slug' => 'post-types-Order',
'required' => false,
),
array(
'name' => 'Post Type Switcher',
'slug' => 'post-type-switcher',
'required' => false,
),
array(
'name' => 'Simple Social Icons',
'slug' => 'simple-social-icons',
'required' => false,
),
array(
'name' => 'Google Analytics by Yoast',
'slug' => 'google-analytics-for-wordpress',
'required' => false,
),
array(
'name' => 'InfiniteWP - Client',
'slug' => 'iwp-client',
'required' => false,
),
array(
'name' => 'Imsanity',
'slug' => 'imsanity',
'required' => false,
),
array(
'name' => 'Jetpack',
'slug' => 'jetpack',
'required' => false,
),
array(
'name' => 'Login LockDown',
'slug' => 'login-lockdown',
'required' => false,
),
array(
'name' => 'MapPress Easy Google Maps',
'slug' => 'mappress-google-maps-for-wordpress',
'required' => false,
),
array(
'name' => 'SlickNav Mobile Menu',
'slug' => 'slicknav-mobile-menu',
'required' => false,
),
array(
'name' => 'WP Video Lightbox',
'slug' => 'wp-video-lightbox',
'required' => false,
),
array(
'name' => 'Easy FancyBox',
'slug' => 'easy-fancybox',
'required' => false,
),
array(
'name' => 'Page Links To',
'slug' => 'page-links-to',
'required' => false,
),
array(
'name' => 'Placeholder Text',
'slug' => 'placeholder-fallback',
'required' => false,
),
array(
'name' => 'Required HTML5 Polyfill',
'slug' => 'required-attribute',
'required' => false,
),
array(
'name' => 'Raw HTML',
'slug' => 'raw-html',
'required' => false,
),
array(
'name' => 'Regenerate Thumbnails',
'slug' => 'regenerate-thumbnails',
'required' => false,
),
array(
'name' => 'Widget CSS Classes',
'slug' => 'widget-css-classes',
'required' => false,
),
array(
'name' => 'Woocommerce',
'slug' => 'woocommerce',
'required' => false,
),
array(
'name' => 'WordPress SEO',
'slug' => 'wordpress-seo',
'required' => false,
),
array(
'name' => 'WP-Piwik',
'slug' => 'wp-piwik',
'required' => false,
),
array(
'name' => 'WP Super Cache',
'slug' => 'wp-super-cache',
'required' => false,
),
array(
'name' => 'WP Optimize',
'slug' => 'wp-optimize',
'required' => false,
),
);
/**
* Array of configuration settings. Amend each line as needed.
* If you want the default strings to be available under your own theme domain,
* leave the strings uncommented.
* Some of the strings are added into a sprintf, so see the comments at the
* end of each line for what each argument will be.
*/
$config = array(
'default_path' => '', // Default absolute path to pre-packaged plugins.
'menu' => 'tgmpa-install-plugins', // Menu slug.
'has_notices' => true, // Show admin notices or not.
'dismissable' => true, // If false, a user cannot dismiss the nag message.
'dismiss_msg' => '', // If 'dismissable' is false, this message will be output at top of nag.
'is_automatic' => false, // Automatically activate plugins after installation or not.
'message' => '', // Message to output right before the plugins table.
'strings' => array(
'page_title' => __( 'Install Required Plugins', 'tgmpa' ),
'menu_title' => __( 'Install Plugins', 'tgmpa' ),
'installing' => __( 'Installing Plugin: %s', 'tgmpa' ), // %s = plugin name.
'oops' => __( 'Something went wrong with the plugin API.', 'tgmpa' ),
'notice_can_install_required' => _n_noop( 'This theme requires the following plugin: %1$s.', 'This theme requires the following plugins: %1$s.' ), // %1$s = plugin name(s).
'notice_can_install_recommended' => _n_noop( 'This theme recommends the following plugin: %1$s.', 'This theme recommends the following plugins: %1$s.' ), // %1$s = plugin name(s).
'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.' ), // %1$s = plugin name(s).
'notice_can_activate_required' => _n_noop( 'The following required plugin is currently inactive: %1$s.', 'The following required plugins are currently inactive: %1$s.' ), // %1$s = plugin name(s).
'notice_can_activate_recommended' => _n_noop( 'The following recommended plugin is currently inactive: %1$s.', 'The following recommended plugins are currently inactive: %1$s.' ), // %1$s = plugin name(s).
'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.' ), // %1$s = plugin name(s).
'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.' ), // %1$s = plugin name(s).
'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.' ), // %1$s = plugin name(s).
'install_link' => _n_noop( 'Begin installing plugin', 'Begin installing plugins' ),
'activate_link' => _n_noop( 'Begin activating plugin', 'Begin activating plugins' ),
'return' => __( 'Return to Required Plugins Installer', 'tgmpa' ),
'plugin_activated' => __( 'Plugin activated successfully.', 'tgmpa' ),
'complete' => __( 'All plugins installed and activated successfully. %s', 'tgmpa' ), // %s = dashboard link.
'nag_type' => 'updated' // Determines admin notice type - can only be 'updated', 'update-nag' or 'error'.
)
);
tgmpa( $plugins, $config );
}