Changeset 53560

Timestamp:

06/23/2022 06:57:24 PM (4 years ago)

Author:

johnbillion

Message:

Themes: Add actions to template loading to assist with collecting debug info.

This introduces the following new actions which wrap the process of loading a template file:

• wp_before_load_template
• wp_after_load_template

Props rmccue, tabrisrp, peterwilsoncc

Fixes #54541

File:

• trunk/src/wp-includes/template.php (modified) (1 diff)

trunk/src/wp-includes/template.php

@@ -714 +714 @@
 
         if ( $load && '' !== $located ) {
+                /**
+                 * Fires before a located template is loaded.
+                 *
+                 * @since 6.1.0
+                 *
+                 * @param string       $located        The template filename.
+                 * @param string|array $template_names Template file(s) to search for, in order.
+                 * @param bool         $require_once   Whether to require_once or require.
+                 * @param array        $args           Additional arguments passed to the template.
+                 */
+                do_action( 'wp_before_load_template', $located, $template_names, $require_once, $args );
+
                 load_template( $located, $require_once, $args );
+
+                /**
+                 * Fires after a located template is loaded.
+                 *
+                 * @since 6.1.0
+                 *
+                 * @param string       $located        The template filename.
+                 * @param string|array $template_names Template file(s) to search for, in order.
+                 * @param bool         $require_once   Whether to require_once or require.
+                 * @param array        $args           Additional arguments passed to the template.
+                 */
+                do_action( 'wp_after_load_template', $located, $template_names, $require_once, $args );
         }