get_page_template_slug( int|WP_Post $post = null )

Get the specific template name for a given post.

Description

Parameters

$post

(int|WP_Post) (Optional) Post ID or WP_Post object. Default is global $post.

Default value: null

Top ↑

Return

(string|false) Page template filename. Returns an empty string when the default page template is in use. Returns false if the post does not exist.

Top ↑

Source

File: wp-includes/post-template.php 

function get_page_template_slug( $post = null ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return false;
	}

	$template = get_post_meta( $post->ID, '_wp_page_template', true );

	if ( ! $template || 'default' == $template ) {
		return '';
	}

	return $template;
}

View on Trac

Top ↑

Changelog

Version Description
4.7.0 Now works with any post type, not just pages.
3.4.0 Introduced.

Top ↑

Top ↑

Uses

Uses Description
wp-includes/post.php: get_post_meta()

Retrieves a post meta field for the given post ID.
wp-includes/post.php: get_post()

Retrieves post data given a post ID or post object.

Top ↑

Used By

Used By Description
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::check_template()

Check whether the template is valid for the given post.
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::prepare_item_for_response()

Prepares a single post output for response.
wp-includes/template.php: get_single_template()

Retrieve path of single template in current or parent template. Applies to single Posts, single Attachments, and single custom post types.
wp-includes/template.php: get_page_template()

Retrieve path of page template in current or parent template.
wp-includes/post-template.php: is_page_template()

Determines whether currently in a page template.
wp-includes/post-template.php: get_body_class()

Retrieves an array of the class names for the body element.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::_prepare_page()

Prepares page data for return in an XML-RPC object.
wp-includes/class-wp-editor.php: _WP_Editors::editor_settings()