* the use of locate_template(). Allows for more generic template location

 * @param string $type      Filename without extension.

 * @param array  $templates An optional list of template candidates

	 * Filters the list of template filenames that are searched for when retrieving a template to use.

	 *

	 * The last element in the array should always be the fallback template for this query type.

	 *

	 * Possible values for `$type` include: 'index', '404', 'archive', 'author', 'category', 'tag', 'taxonomy', 'date',

	 * 'embed', 'home', 'frontpage', 'page', 'paged', 'search', 'single', 'singular', and 'attachment'.

	 *

	 * @since 4.7.0

	 * @param array $templates A list of template candidates, in descending order of priority.

	 */

	$templates = apply_filters( "{$type}_template_hierarchy", $templates );

	$template = locate_template( $templates );

	/**

	 * Filters the path of the queried template by type.

	 *

	 * The dynamic portion of the hook name, `$type`, refers to the filename -- minus the file

	 * extension and any non-alphanumeric characters delimiting words -- of the file to load.

	 * This hook also applies to various types of files loaded as part of the Template Hierarchy.

	 *

	 * Possible values for `$type` include: 'index', '404', 'archive', 'author', 'category', 'tag', 'taxonomy', 'date',

	 * 'embed', 'home', 'frontpage', 'page', 'paged', 'search', 'single', 'singular', and 'attachment'.

	 * @since 4.8.0 The `$type` and `$templates` parameters were added.

	 * @param string $template  Path to the template. See locate_template().

	 * @param string $type      Filename without extension.

	 * @param array  $templates A list of template candidates, in descending order of priority.

	return apply_filters( "{$type}_template", $template, $type, $templates );

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is 'index'.

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is '404'.

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is 'archive'.

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is 'archive'.

	if ( ! ( $obj instanceof WP_Post_Type ) || ! $obj->has_archive ) {

	}

 * The hierarchy for this template looks like:

 *

 * 1. author-{nicename}.php

 * 2. author-{id}.php

 * 3. author.php

 *

 * An example of this is:

 *

 * 1. author-john.php

 * 2. author-1.php

 * 3. author.php

 *

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is 'author'.

 * The hierarchy for this template looks like:

 *

 * 1. category-{slug}.php

 * 2. category-{id}.php

 * 3. category.php

 * An example of this is:

 *

 * 1. category-news.php

 * 2. category-2.php

 * 3. category.php

 *

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is 'category'.

 * @since 4.7.0 The decoded form of `category-{slug}.php` was added to the top of the

 *              template hierarchy when the category slug contains multibyte characters.

		$slug_decoded = urldecode( $category->slug );

		if ( $slug_decoded !== $category->slug ) {

			$templates[] = "category-{$slug_decoded}.php";

		}

 * The hierarchy for this template looks like:

 *

 * 1. tag-{slug}.php

 * 2. tag-{id}.php

 * 3. tag.php

 * An example of this is:

 *

 * 1. tag-wordpress.php

 * 2. tag-3.php

 * 3. tag.php

 *

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is 'tag'.

 * @since 4.7.0 The decoded form of `tag-{slug}.php` was added to the top of the

 *              template hierarchy when the tag slug contains multibyte characters.

		$slug_decoded = urldecode( $tag->slug );

		if ( $slug_decoded !== $tag->slug ) {

			$templates[] = "tag-{$slug_decoded}.php";

		}

 * Retrieve path of custom taxonomy term template in current or parent template.

 *

 * The hierarchy for this template looks like:

 * 1. taxonomy-{taxonomy_slug}-{term_slug}.php

 * 2. taxonomy-{taxonomy_slug}.php

 * 3. taxonomy.php

 * An example of this is:

 * 1. taxonomy-location-texas.php

 * 2. taxonomy-location.php

 * 3. taxonomy.php

 *

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is 'taxonomy'.

 * @since 4.7.0 The decoded form of `taxonomy-{taxonomy_slug}-{term_slug}.php` was added to the top of the

 *              template hierarchy when the term slug contains multibyte characters.

 * @return string Full path to custom taxonomy term template file.

		$slug_decoded = urldecode( $term->slug );

		if ( $slug_decoded !== $term->slug ) {

			$templates[] = "taxonomy-$taxonomy-{$slug_decoded}.php";

		}

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is 'date'.

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is 'home'.

 * Retrieve path of front page template in current or parent template.

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is 'frontpage'.

 * The hierarchy for this template looks like:

 *

 * 1. {Page Template}.php

 * 2. page-{page_name}.php

 * 3. page-{id}.php

 * 4. page.php

 * An example of this is:

 *

 * 1. page-templates/full-width.php

 * 2. page-about.php

 * 3. page-4.php

 * 4. page.php

 *

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is 'page'.

 * @since 4.7.0 The decoded form of `page-{page_name}.php` was added to the top of the

 *              template hierarchy when the page name contains multibyte characters.

	if ( $pagename ) {

		$pagename_decoded = urldecode( $pagename );

		if ( $pagename_decoded !== $pagename ) {

			$templates[] = "page-{$pagename_decoded}.php";

		}

		$templates[] = "page-{$pagename}.php";

	}

		$templates[] = "page-{$id}.php";

 * The template hierarchy and template path are filterable via the {@see '$type_template_hierarchy'}

 * and {@see '$type_template'} dynamic hooks, where `$type` is 'search'.