Changeset 53560

Timestamp:

06/23/2022 06:57:24 PM (2 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 );
     }