Changeset 61913

Timestamp:

03/10/2026 09:10:29 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.

Props dmsnell, westonruter.

Location:

trunk/src/wp-includes

Files:

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

trunk/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'] ) &&

trunk/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 ) &&