From 2e2761079379852679d08be70b4f4983503b81cc Mon Sep 17 00:00:00 2001 From: Drew Jaynes Date: Sun, 6 Oct 2013 19:00:05 +0000 Subject: [PATCH] Inline documentation for a hooks in wp-includes/template.php. Props jonlynch for the initial patch. Fixes #25487. git-svn-id: https://develop.svn.wordpress.org/trunk@25703 602fd350-edb4-49c9-b593-d223f7449a82 --- src/wp-includes/template.php | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/src/wp-includes/template.php b/src/wp-includes/template.php index c5baa3f393..c288995478 100644 --- a/src/wp-includes/template.php +++ b/src/wp-includes/template.php @@ -26,7 +26,19 @@ function get_query_template( $type, $templates = array() ) { if ( empty( $templates ) ) $templates = array("{$type}.php"); - return apply_filters( "{$type}_template", locate_template( $templates ) ); + $template = locate_template( $templates ); + /** + * Filter the path of the queried template by type. + * + * The dynamic portion of the hook name, $type, refers to the filename + * -- minus the extension -- of the file to load. This hook also applies + * to various types of files loaded as part of the Template Hierarchy. + * + * @since 1.5.2 + * + * @param string $template Path to the template. @see locate_template() + */ + return apply_filters( "{$type}_template", $template ); } /**