WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

get_block_theme_folders()

get_block_theme_folders( string $theme_stylesheet = null ): string[]

In this article

Back to top

For backward compatibility reasons, block themes might be using block-templates or block-template-parts, this function ensures we fallback to these folders properly.

Parameters

$theme_stylesheetstringoptional
The stylesheet. Default is to leverage the main theme root.

Default:null

Return

string[] Folder names used by block themes.
  • wp_template string
    Theme-relative directory name for block templates.
  • wp_template_part string
    Theme-relative directory name for block template parts.

Source

function get_block_theme_folders( $theme_stylesheet = null ) {
	$theme = wp_get_theme( (string) $theme_stylesheet );
	if ( ! $theme->exists() ) {
		// Return the default folders if the theme doesn't exist.
		return array(
			'wp_template'      => 'templates',
			'wp_template_part' => 'parts',
		);
	}
	return $theme->get_block_template_folders();
}

View all references View on Trac View on GitHub

UsesDescription
wp_get_theme()wp-includes/theme.php

Gets a WP_Theme object for a theme.

Used byDescription
_get_block_template_file()wp-includes/block-template-utils.php

Retrieves the template file from the theme for a given slug.

_get_block_templates_files()wp-includes/block-template-utils.php

Retrieves the template files from the theme.

Changelog

VersionDescription
5.9.0Introduced.

User Contributed Notes

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