BEA - Manage theme plugins

Dev oriented plugin to manage theme's plugins (activation and deactivation) by forcing or suggesting it.

Installation

WordPress

• Download and install using the built-in WordPress plugin installer.
• Site Activate in the "Plugins" area of the admin.
• Optionally drop the entire bea-manage-theme-plugins directory into mu-plugins.
• Add into your theme's functions.php file how to manage your list of plugins, see Usages.

Composer

• Add repository source : { "type": "vcs", "url": "https://github.com/BeAPI/bea-manage-theme-plugins" }.
• Include "bea/bea-manage-theme-plugins": "dev-master" in your composer file.
• Add into your theme's functions.php file how to manage your list of plugins, see Usages.

Usages

In your theme's functions.php file, hook on bea\manage_theme_plugins\theme_plugins to manage theme's plugins dependencies.

Here is an example of how theme's plugins array is formatted :

$theme_plugins = [
    plugin-folder1 => $action1,
    plugin-file2.php => $action1
];

Available actions are :

• force_activation
• suggest_activation
• force_deactivation
• suggest_deactivation

Example

<?php
/**
 * Manage all plugin dependencies
 */
add_filter( 'bea\manage_theme_plugins\theme_plugins', 'manage_my_theme_plugins' );
function manage_my_theme_plugins( $plugins ) {
	$theme_plugins = [
    	'plugin-folder1' => 'force_activation',
    	'plugin2' => 'force_deactivation'
    ];

	return $plugins;
}

WP-Cli

Single site management

Will exec only on given site, the theme's plugins management.

wp plugin theme_management --url={site_url}

All sites management

Will exec on all sites, the theme's plugins management.

wp site list --fields=url \ | xargs -I % wp plugin theme_management --url=%

The old command "plugins manage_all" is deprecated/removed.

Changelog

2.1 - 04 Apr 2018

• Minor refactoring PHP comments (thanks @TweetPressFr)
• Rename WP-CLI command from "plugins manage_single" to "plugin theme_management" (issue #7)

2.0 - 04 Apr 2018

• Refactoring plugin, use new plugin array structure
• Remove "manage_all" WP-Cli command
• Allow call plugin by short name, eg: advanced-custom-fields (without end part)
• Remove some plugin actions from Plugins list

1.1.1 / 1.1.2 - 13 Dec 2016

• Fix multiple wp-cli call.
• Refactoring & reformatting.
• More wp-cli messages (logs / success).

1.1.0 - 12 Dec 2016

• Add wp cli to single or multiple management.
• Update WP warnings messages.

1.0.1 - 02 Dec 2016

• Implement main methods to register/deregister theme's plugins depending in if it's forced or suggested.
• Update readme with usage & example.
• Add plugin's .pot.
• Add French translation (po/mo).
• Add composer.json !

1.0.0 - 02 Dec 2016

• Init with boilerplate 2.1.6