W3cubDocs

/WordPress

activate_plugins( string|string[] $plugins, string $redirect = '', bool $network_wide = false, bool $silent = false )

Activate multiple plugins.

Description

When WP_Error is returned, it does not mean that one of the plugins had errors. It means that one or more of the plugin file paths were invalid.

The execution will be halted as soon as one of the plugins has an error.

Parameters

$plugins

(string|string[]) (Required) Single plugin or list of plugins to activate.

$redirect

(string) (Optional) Redirect to page after successful activation.

Default value: ''

$network_wide

(bool) (Optional) Whether to enable the plugin for all sites in the network.

Default value: false

$silent

(bool) (Optional) Prevent calling activation hooks.

Default value: false

Return

(bool|WP_Error) True when finished or WP_Error if there were errors during a plugin activation.

Source

File: wp-admin/includes/plugin.php 

function activate_plugins( $plugins, $redirect = '', $network_wide = false, $silent = false ) {
	if ( ! is_array( $plugins ) ) {
		$plugins = array( $plugins );
	}

	$errors = array();
	foreach ( $plugins as $plugin ) {
		if ( ! empty( $redirect ) ) {
			$redirect = add_query_arg( 'plugin', $plugin, $redirect );
		}
		$result = activate_plugin( $plugin, $redirect, $network_wide, $silent );
		if ( is_wp_error( $result ) ) {
			$errors[ $plugin ] = $result;
		}
	}

	if ( ! empty( $errors ) ) {
		return new WP_Error( 'plugins_invalid', __( 'One of the plugins is invalid.' ), $errors );
	}

	return true;
}

Uses

Uses Description
wp-admin/includes/plugin.php: activate_plugin()

Attempts activation of plugin in a “sandbox” and redirects on success.
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/functions.php: add_query_arg()

Retrieves a modified URL query string.
wp-includes/load.php: is_wp_error()

Check whether variable is a WordPress Error.
wp-includes/class-wp-error.php: WP_Error::__construct()

Initialize the error.

Changelog

Version Description
2.6.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/activate_plugins