Ticket #40842: template_filters.patch

src/wp-includes/general-template.php

@@ -42 +42 @@
 
         $templates[] = 'header.php';
 
+        /**
+         * Filters the header templates.
+         *
+         * @since 4.8.0
+         *
+         * @param array $templates Templates of all possible headers.
+         * @param string|null $name Name of the specific header file to use.
+         */
+        $templates = apply_filters( 'get_header_templates', $templates, $name );
+
         locate_template( $templates, true );
 }
 
@@ -81 +91 @@
 
         $templates[]    = 'footer.php';
 
+        /**
+         * Filters the footer templates.
+         *
+         * @since 4.8.0
+         *
+         * @param array $templates Templates of all possible footers.
+         * @param string|null $name Name of the specific footer file to use.
+         */
+        $templates = apply_filters( 'get_footer_templates', $templates, $name );
+
         locate_template( $templates, true );
 }
 
@@ -119 +139 @@
 
         $templates[] = 'sidebar.php';
 
+        /**
+         * Filters the sidebar templates.
+         *
+         * @since 4.8.0
+         *
+         * @param array $templates Templates of all possible sidebars.
+         * @param string|null $name Name of the specific sidebar file to use.
+         */
+        $templates = apply_filters( 'get_sidebar_templates', $templates, $name );
+
         locate_template( $templates, true );
 }
 

src/wp-includes/template.php

@@ -643 +643 @@
                 }
         }
 
+        /**
+         * Filters the template location.
+         *
+         * @since 4.8.0
+         *
+         * @param string       $located        Path to the template location.
+         * @param string|array $template_names Template file(s) to search for, in order.
+         * @param boolean      $load           If true the template file will be loaded if it is found.
+         * @param boolean      $require_once   Whether to require_once or require. Default true. Has no effect if $load is false.
+         */
+        $located = apply_filters( 'located_template', $located, $template_names, $load, $require_once );
+
         if ( $load && '' != $located )
                 load_template( $located, $require_once );