Ticket #13239: 13239.template.php.2.diff

template.php

@@ -496 +496 @@
  * @param bool         $require_once   Whether to require_once or require. Default true. Has no effect if $load is false.
  * @return string The template filename if one is located.
  */
-function locate_template($template_names, $load = false, $require_once = true ) {
+function locate_template( $template_names, $load = false, $require_once = true ) {
         $located = '';
         foreach ( (array) $template_names as $template_name ) {
-                if ( !$template_name )
+                if ( ! $template_name ) {
                         continue;
-                if ( file_exists(STYLESHEETPATH . '/' . $template_name)) {
+                }
+                if ( file_exists( STYLESHEETPATH . '/' . $template_name ) ) {
                         $located = STYLESHEETPATH . '/' . $template_name;
                         break;
-                } elseif ( file_exists(TEMPLATEPATH . '/' . $template_name) ) {
+                } elseif ( file_exists( TEMPLATEPATH . '/' . $template_name ) ) {
                         $located = TEMPLATEPATH . '/' . $template_name;
                         break;
                 }
         }
 
-        if ( $load && '' != $located )
+        /**
+         * Filter the path of the template.
+         *
+         * @since 4.3.0
+         *
+         * @param string $located Path to the template.
+         * @param string|array $template_names Template file(s) to search for, in order.
+         */
+        $located = apply_filters( 'locate_template', $located, $template_names );
+
+        if ( $load && '' != $located ) {
                 load_template( $located, $require_once );
+        }
 
         return $located;
 }
@@ -557 +569 @@
                 require( $_template_file );
         }
 }
-