activate_plugins() — описание функции WordPress на русском

Сигнатура

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

Описание

Возврат WP_Error не означает, что в одном из плагинов возникли ошибки. Это означает, что один или несколько путей к файлам плагинов оказались недействительными.
Выполнение будет остановлено, как только в одном из плагинов возникнет ошибка.

Оригинал (английский)

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.

Параметры

$plugins string|string[] обязательный

Один плагин или список плагинов для активации.

$redirect string необязательный = ''

Перенаправление на страницу после успешной активации.

$network_wide bool необязательный = false

Включить ли плагин для всех сайтов сети.

$silent bool необязательный = false

Предотвратить вызов хуков активации.

Возвращаемое значение

true|WP_Error

WP_Error

Исходный код

wp-admin/includes/plugin.php:869

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;
}

История изменений

Версия	Описание
2.6.0	Introduced.