WP_REST_Plugins_Controller::plugin_status_permission_check │ protected │ WP 5.5.0

Handle updating a plugin's status.

Method of the class: WP_REST_Plugins_Controller{}

No Hooks.

Returns

true|WP_Error.

Usage

// protected - for code of main (parent) or child class
$result = $this->plugin_status_permission_check( $plugin, $new_status, $current_status );

$plugin(string) (required)

The plugin file to update.

$new_status(string) (required)

The plugin's new status.

$current_status(string) (required)

The plugin's current status.

Changelog

WP_REST_Plugins_Controller::plugin_status_permission_check() WP REST Plugins Controller::plugin status permission check code ^{WP 7.0}

protected function plugin_status_permission_check( $plugin, $new_status, $current_status ) {
	if ( is_multisite() && ( 'network-active' === $current_status || 'network-active' === $new_status ) && ! current_user_can( 'manage_network_plugins' ) ) {
		return new WP_Error(
			'rest_cannot_manage_network_plugins',
			__( 'Sorry, you are not allowed to manage network plugins.' ),
			array( 'status' => rest_authorization_required_code() )
		);
	}

	if ( ( 'active' === $new_status || 'network-active' === $new_status ) && ! current_user_can( 'activate_plugin', $plugin ) ) {
		return new WP_Error(
			'rest_cannot_activate_plugin',
			__( 'Sorry, you are not allowed to activate this plugin.' ),
			array( 'status' => rest_authorization_required_code() )
		);
	}

	if ( 'inactive' === $new_status && ! current_user_can( 'deactivate_plugin', $plugin ) ) {
		return new WP_Error(
			'rest_cannot_deactivate_plugin',
			__( 'Sorry, you are not allowed to deactivate this plugin.' ),
			array( 'status' => rest_authorization_required_code() )
		);
	}

	return true;
}