wpseek.com
A WordPress-centric search engine for devs and theme authors



resume_theme › WordPress Function

Since5.2.0
Deprecatedn/a
› resume_theme ( $theme, $redirect = '' )
Parameters: (2)
  • (string) $theme Single theme 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 `$theme` was not paused, `WP_Error` on failure.
Defined at:
Codex:

Tries to resume a single theme.

If a redirect was provided and a functions.php file was found, we first ensure that functions.php file does not throw fatal errors anymore. The way it works is by setting the redirection to the error before trying to include the file. If the theme fails, then the redirection will not be overwritten with the success message and the theme will not be resumed.


Related Functions: preview_theme, remove_theme_mod, remove_theme_mods, get_theme, delete_theme

Source 

function resume_theme( $theme, $redirect = '' ) {
	global $wp_stylesheet_path, $wp_template_path;

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

	/*
	 * We'll override this later if the theme could be resumed without
	 * creating a fatal error.
	 */
	if ( ! empty( $redirect ) ) {
		$functions_path = '';
		if ( str_contains( $wp_stylesheet_path, $extension ) ) {
			$functions_path = $wp_stylesheet_path . '/functions.php';
		} elseif ( str_contains( $wp_template_path, $extension ) ) {
			$functions_path = $wp_template_path . '/functions.php';
		}

		if ( ! empty( $functions_path ) ) {
			wp_redirect(
				add_query_arg(
					'_error_nonce',
					wp_create_nonce( 'theme-resume-error_' . $theme ),
					$redirect
				)
			);

			// Load the theme's functions.php to test whether it throws a fatal error.
			ob_start();
			if ( ! defined( 'WP_SANDBOX_SCRAPING' ) ) {
				define( 'WP_SANDBOX_SCRAPING', true );
			}
			include $functions_path;
			ob_clean();
		}
	}

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

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

	return true;
}