Themes: Allow files in a block theme's 'patterns' directory to be filterable.

Since [59872] all PHP files in the 'patterns' directory or subdirectories are auto registered. Adding a filter prior to autoregistration allows theme developers to modify the list of files before the auto registration.

Props webmandesign, joemcgill, jorbin, poena.
Fixes #63212.


git-svn-id: https://develop.svn.wordpress.org/trunk@60142 602fd350-edb4-49c9-b593-d223f7449a82

Author: joemcgill

src/wp-includes/class-wp-theme.php

@@ -1860,6 +1860,16 @@ public function get_block_patterns() {
 
 		$files = (array) self::scandir( $dirpath, 'php', -1 );
 
+		/**
+		 * Filters list of block pattern files for a theme.
+		 *
+		 * @since 6.8.0
+		 *
+		 * @param array  $files   Array of theme files found within `patterns` directory.
+		 * @param string $dirpath Path of theme `patterns` directory being scanned.
+		 */
+		$files = apply_filters( 'theme_block_pattern_files', $files, $dirpath );
+
 		$dirpath = trailingslashit( $dirpath );
 
 		if ( ! $files ) {