A WordPress-centric search engine for devs and theme authors



resume_plugin ›

Since5.2.0
Deprecatedn/a
resume_plugin ( $plugin, $redirect = '' )
Parameters: (2)
  • (string) $plugin Single plugin to resume.
    Required: Yes
  • (string) $redirect Optional. URL to redirect to. Default empty string.
    Required: No
    Default: (empty)
Returns:
  • (bool|WP_Error) True on success, false if `$plugin` was not paused, `WP_Error` on failure.
Defined at:
Codex:

Tries to resume a single plugin.

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

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



Source

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

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

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

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

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

	return true;
}