Changeset 60144

Timestamp:

04/08/2025 02:16:45 PM (6 weeks ago)

Author:

joemcgill

Message:

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.

Reviewed by audrasjb.
Merges [60142] to the 6.8 branch

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

Location:

branches/6.8

Files:

• . (modified) (1 prop)
• src/wp-includes/class-wp-theme.php (modified) (1 diff)

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

@@ -1861 +1861 @@
         $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 );