wp_get_theme_preview_path( string $current_stylesheet = null ): string

Parameters

$current_stylesheetstringoptional

The current theme's stylesheet or template path.Default: null

Return

string

The previewed theme's stylesheet or template path.

Uses · 6

• current_user_can()Returns whether the current user has the specified capability.
• sanitize_text_field()Sanitizes a string from user input or from the database.
• wp_unslash()Removes slashes from a string or recursively removes slashes from strings within an array.
• wp_get_theme()Gets a WP_Theme object for a theme.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• current_filter()Retrieves the name of the current filter hook.

Used by · 1

• wp_block_theme_activate_nonce()Set a JavaScript constant for theme activation.

Source

View on Trac ↗View on GitHub ↗

16function wp_get_theme_preview_path( $current_stylesheet = null ) {17	if ( ! current_user_can( 'switch_themes' ) ) {18		return $current_stylesheet;19	}20 21	$preview_stylesheet = ! empty( $_GET['wp_theme_preview'] ) ? sanitize_text_field( wp_unslash( $_GET['wp_theme_preview'] ) ) : null;22	$wp_theme           = wp_get_theme( $preview_stylesheet );23	if ( ! is_wp_error( $wp_theme->errors() ) ) {24		if ( current_filter() === 'template' ) {25			$theme_path = $wp_theme->get_template();26		} else {27			$theme_path = $wp_theme->get_stylesheet();28		}29 30		return sanitize_text_field( $theme_path );31	}32 33	return $current_stylesheet;34}

History

Introduced in 6.3.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-includes/theme-previews.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.