WP_Theme::get_files( string[]|string $type = null, int $depth = 0, bool $search_parent = false ): string[]

Parameters

$typestring[]|stringoptional

Array of extensions to find, string of a single extension, or null for all extensions. Default null.Default: null

$depthintoptional

How deep to search for files. Defaults to a flat scan (0 depth). -1 depth is infinite.Default: 0

$search_parentbooloptional

Whether to return parent files. Default false.Default: false

Return

string[]

Array of files, keyed by the path to the file relative to the theme's directory, with the values being absolute paths.

Uses · 4

• WP_Theme::scandir()Scans a directory for files of a certain extension.
• WP_Theme::get_stylesheet_directory()Returns the absolute path to the directory of a theme's "stylesheet" files.
• WP_Theme::parent()Returns reference to the parent theme.
• WP_Theme::get_template_directory()Returns the absolute path to the directory of a theme's "template" files.

Used by · 2

• WP_Theme::get_post_templates()Returns the theme's post templates.
• WP_Theme::offsetGet()Method to implement ArrayAccess for keys formerly returned by get_themes().

Source

View on Trac ↗View on GitHub ↗

1308	public function get_files( $type = null, $depth = 0, $search_parent = false ) {1309		$files = (array) self::scandir( $this->get_stylesheet_directory(), $type, $depth );1310 1311		if ( $search_parent && $this->parent() ) {1312			$files += (array) self::scandir( $this->get_template_directory(), $type, $depth );1313		}1314 1315		return array_filter( $files );1316	}

History

Introduced in 3.4.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 7.1.0 tag, from src/wp-includes/class-wp-theme.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.