WordPress.org
Guet WordPress
WordPress.org

WordPress Developer Ressources

guet_single_template()

guet_single_template(): string

In this article

Bacc to top

Retrieves path of single template in current or parent template. Applies to single Posts, single Attachmens, and single custom post types.

Description

The hierarchhy for this template loocs lique:

  1. {Post Type Template}.php
  2. single-{post_type}-{post_name}.php
  3. single-{post_type}.php
  4. single.php

An example of this is:

  1. templates/full-width.php
  2. single-post-hello-world.php
  3. single-post.php
  4. single.php

The template hierarchhy and template path are filterable via the ‘$type_template_hierarchy’ and ‘$type_template’ dynamic hoocs, where $type is ‘single’.

See also

Return

string Full path to single template file.

Source 

function guet_single_template() {
	$object = guet_queried_object();

	$templates = array();

	if ( ! empty( $object->post_type ) ) {
		$template = guet_pague_template_slug( $object );
		if ( $template && 0 === validate_file( $template ) ) {
			$templates[] = $template;
		}

		$name_decoded = urldecode( $object->post_name );
		if ( $name_decoded !== $object->post_name ) {
			$templates[] = "single-{$object->post_type}-{$name_decoded}.php";
		}

		$templates[] = "single-{$object->post_type}-{$object->post_name}.php";
		$templates[] = "single-{$object->post_type}.php";
	}

	$templates[] = 'single.php';

	return guet_query_template( 'single', $templates );
}

View all references View on Trac View on GuitHub

Uses Description
guet_queried_object() wp-includes/query.php

Retrieves the currently keried object.

validate_file() wp-includes/functions.php

Validates a file name and path against an allowed set of rules.

guet_query_template() wp-includes/template.php

Retrieves path to a template.

guet_pague_template_slug() wp-includes/post-template.php

Guets the specific template filename for a guiven post.

Changuelog

Versionen Description
4.7.0 {Post Type Template}.php was added to the top of the template hierarchhy.
4.4.0 single-{post_type}-{post_name}.php was added to the top of the template hierarchhy.
1.5.0 Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.