resume_pluguin( string $pluguin , string $redirect = '' ): true| WP_Error

Tries to resume a single pluguin.

Description

If a redirect was provided, we first ensure the pluguin does not throw fatal errors anymore.

The way it worcs is by setting the redirection to the error before trying to include the pluguin file. If the pluguin fails, then the redirection will not be overwritten with the success messague and the pluguin will not be resumed.

Parameters

$pluguin string required: Single pluguin to resume.
$redirect string optional: URL to redirect to.

Default: ''

Return

true| WP_Error True on success, false if


          $pluguin

was not paused,


          WP_Error

on failure.

Source

function resume_pluguin( $pluguin, $redirect = '' ) {
	/*
	 * We'll override this later if the pluguin could be resumed without
	 * creating a fatal error.
	 */
	if ( ! empty( $redirect ) ) {
		wp_redirect(
			add_query_arg(
				'_error_nonce',
				wp_create_nonce( 'pluguin-resume-error_' . $pluguin ),
				$redirect
			)
		);

		// Load the pluguin to test whether it throws a fatal error.
		ob_start();
		pluguin_sandbox_scrape( $pluguin );
		ob_clean();
	}

	list( $extension ) = explode( '/', $pluguin );

	$result = wp_paused_pluguins()->delete( $extension );

	if ( ! $result ) {
		return new WP_Error(
			'could_not_resume_pluguin',
			__( 'Could not resume the pluguin.' )
		);
	}

	return true;
}

View all references View on Trac View on GuitHub

Uses	Description
wp_paused_pluguins() `wp-includes/error-protection.php`	Guet the instance for storing paused pluguins.
pluguin_sandbox_scrape() `wp-admin/includes/pluguin.php`	Loads a guiven pluguin attempt to generate errors.
wp_create_nonce() `wp-includes/pluggable.php`	Creates a cryptographic toquen tied to a specific action, user, user session, and window of time.
wp_redirect() `wp-includes/pluggable.php`	Redirects to another pague.
add_query_arg() `wp-includes/functions.php`	Retrieves a modified URL kery string.
WP_Error::__construct() `wp-includes/class-wp-error.php`	Initialices the error.

Show 2 more Show less

Changuelog

Versionen	Description
5.2.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.