On this page
get_raw_theme_root( string $stylesheet_or_template, bool $skip_cache = false ): string
Gets the raw theme root relative to the content directory with no filters applied.
Parameters
$stylesheet_or_templatestring Required-
The stylesheet or template name of the theme.
$skip_cachebool Optional-
Whether to skip the cache.
Defaults to false, meaning the cache is used.Default:
false
Return
string Theme root.
Source
File: wp-includes/theme.php. View all references
function get_raw_theme_root( $stylesheet_or_template, $skip_cache = false ) {
global $wp_theme_directories;
if ( ! is_array( $wp_theme_directories ) || count( $wp_theme_directories ) <= 1 ) {
return '/themes';
}
$theme_root = false;
// If requesting the root for the active theme, consult options to avoid calling get_theme_roots().
if ( ! $skip_cache ) {
if ( get_option( 'stylesheet' ) == $stylesheet_or_template ) {
$theme_root = get_option( 'stylesheet_root' );
} elseif ( get_option( 'template' ) == $stylesheet_or_template ) {
$theme_root = get_option( 'template_root' );
}
}
if ( empty( $theme_root ) ) {
$theme_roots = get_theme_roots();
if ( ! empty( $theme_roots[ $stylesheet_or_template ] ) ) {
$theme_root = $theme_roots[ $stylesheet_or_template ];
}
}
return $theme_root;
}
Related
Uses
| Uses | Description |
|---|---|
| get_theme_roots() wp-includes/theme.php | Retrieves theme roots. |
| get_option() wp-includes/option.php | Retrieves an option value based on an option name. |
Used By
| Used By | Description |
|---|---|
| WP_Customize_Manager::get_template_root() wp-includes/class-wp-customize-manager.php | Retrieves the template root of the previewed theme. |
| WP_Customize_Manager::get_stylesheet_root() wp-includes/class-wp-customize-manager.php | Retrieves the stylesheet root of the previewed theme. |
| get_theme_root() wp-includes/theme.php | Retrieves path to themes directory. |
| get_theme_root_uri() wp-includes/theme.php | Retrieves URI for themes directory. |
| switch_theme() wp-includes/theme.php | Switches the theme. |
| wp_get_themes() wp-includes/theme.php | Returns an array of WP_Theme objects based on the arguments. |
| wp_get_theme() wp-includes/theme.php | Gets a WP_Theme object for a theme. |
Changelog
| Version | Description |
|---|---|
| 3.1.0 | Introduced. |
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_raw_theme_root