Changeset 61914

Timestamp:

03/10/2026 09:18:06 PM (3 days ago)

Author:

johnbillion

Message:

Customize: Introduce a fix for themes that pass a stringable object through the template_include filter despite it being documented as only accepting a string.

This has historically worked until [61892] increased the strictness of the template file validation which dismissed any value of a type other than a string, which a stringable object is not.

Merges [61913] into the 6.9 branch.

Props dmsnell, westonruter.

Location:

branches/6.9

Files:

• . (modified) (1 prop)
• src/wp-includes/class-wp-block-patterns-registry.php (modified) (1 diff)
• src/wp-includes/template-loader.php (modified) (1 diff)

branches/6.9/src/wp-includes/class-wp-block-patterns-registry.php

@@ -175 +175 @@
         }
 
-        $pattern_path = realpath( $patterns[ $pattern_name ]['filePath'] ?? '' );
+        $file_path    = $patterns[ $pattern_name ]['filePath'] ?? '';
+        $is_stringy   = is_string( $file_path ) || ( is_object( $file_path ) && method_exists( $file_path, '__toString' ) );
+        $pattern_path = $is_stringy ? realpath( (string) $file_path ) : null;
         if (
             ! isset( $patterns[ $pattern_name ]['content'] ) &&

branches/6.9/src/wp-includes/template-loader.php

@@ -112 +112 @@
      * @param string $template The path of the template to include.
      */
-    $template = apply_filters( 'template_include', $template );
-    $template = is_string( $template ) ? realpath( $template ) : null;
+    $template   = apply_filters( 'template_include', $template );
+    $is_stringy = is_string( $template ) || ( is_object( $template ) && method_exists( $template, '__toString' ) );
+    $template   = $is_stringy ? realpath( (string) $template ) : null;
     if (
         is_string( $template ) &&