WP_Theme::get_page_templates() – Method

Returns the theme’s post templates for a given post type.

Parameters

$postWP_Post|nulloptional: The post being edited, provided for context.
Default:null
$post_typestringoptional: Post type to get the templates for. Default 'page'.
If a post is provided, its post type is used.
Default:'page'

Return

string[] Array of template header names keyed by the template file name.

Source

public function get_page_templates( $post = null, $post_type = 'page' ) {
	if ( $post ) {
		$post_type = get_post_type( $post );
	}

	$post_templates = $this->get_post_templates();
	$post_templates = isset( $post_templates[ $post_type ] ) ? $post_templates[ $post_type ] : array();

	/**
	 * Filters list of page templates for a theme.
	 *
	 * @since 4.9.6
	 *
	 * @param string[]     $post_templates Array of template header names keyed by the template file name.
	 * @param WP_Theme     $theme          The theme object.
	 * @param WP_Post|null $post           The post being edited, provided for context, or null.
	 * @param string       $post_type      Post type to get the templates for.
	 */
	$post_templates = (array) apply_filters( 'theme_templates', $post_templates, $this, $post, $post_type );

	/**
	 * Filters list of page templates for a theme.
	 *
	 * The dynamic portion of the hook name, `$post_type`, refers to the post type.
	 *
	 * Possible hook names include:
	 *
	 *  - `theme_post_templates`
	 *  - `theme_page_templates`
	 *  - `theme_attachment_templates`
	 *
	 * @since 3.9.0
	 * @since 4.4.0 Converted to allow complete control over the `$page_templates` array.
	 * @since 4.7.0 Added the `$post_type` parameter.
	 *
	 * @param string[]     $post_templates Array of template header names keyed by the template file name.
	 * @param WP_Theme     $theme          The theme object.
	 * @param WP_Post|null $post           The post being edited, provided for context, or null.
	 * @param string       $post_type      Post type to get the templates for.
	 */
	$post_templates = (array) apply_filters( "theme_{$post_type}_templates", $post_templates, $this, $post, $post_type );

	return $post_templates;
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘theme_templates’, string[] $post_templates, WP_Theme $theme, WP_Post|null $post, string $post_type ): Filters list of page templates for a theme.
apply_filters( “theme_{$post_type}_templates”, string[] $post_templates, WP_Theme $theme, WP_Post|null $post, string $post_type ): Filters list of page templates for a theme.

Uses	Description
WP_Theme::get_post_templates()`wp-includes/class-wp-theme.php`	Returns the theme’s post templates.
get_post_type()`wp-includes/post.php`	Retrieves the post type of the current post or of a given post.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Show 1 more Show less

Used by	Description
WP_REST_Posts_Controller::check_template()`wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php`	Checks whether the template is valid for the given post.
WP_REST_Posts_Controller::handle_template()`wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php`	Sets the template for a post.
get_page_templates()`wp-admin/includes/theme.php`	Gets the page templates available in this theme.
wp_insert_post()`wp-includes/post.php`	Inserts or update a post.

Changelog

Version	Description
4.7.0	Added the `$post_type` parameter.
3.4.0	Introduced.

User Contributed Notes

Skip to note 3 content

Jonas Lundman 7 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
As of 4.7 a safe way to get your custom post type available templates, outside the loop or if the global $post is intercepted:
```
$templates = wp_get_theme()->get_page_templates(null, 'my_post_type');
```
For a custom post type 'locations' this would give you something “like”:
```
array(2) {
  ["templates/locations-max.php"]=>
  string(21) "Locations, no sidebar",
  ["templates/locations-no-maps.php"]=>
  string(21) "Locations, information only"
}
```
As of 4.7 this might be filtered and then some template information might be missing, you can call wp_get_theme()->get_post_templates() instead, then you get an array with all post_types available templates within a deeper array.
Log in to add feedback
Skip to note 4 content

tiago26luiz 3 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
inside your page template file,example: page-twoColumns.php use this code:
```
$myModels = wp_get_theme()->get_page_templates();
	foreach ( $myModels as $template_name => $template_filename ) {
    echo "$template_name ($template_filename)<br />";
	}
	print_r( wp_get_theme()->get_page_templates() );
 
```
it will return all available custom page templates for your theme.

Output of type:

page-threeColumns.php (threeColumns)
page-twoColumns.php (twoColumns)
Array ( [page-threeColumns.php] => threeColumns [page-twoColumns.php] => twoColumns )
Log in to add feedback

WP_Theme::get_page_templates( WP_Post|null $post = null, string $post_type = ‘page’ ): string[]

In this article

Parameters

Return

Source

Hooks

Changelog

User Contributed Notes

WP_Theme::get_page_templates( WP_Post|null $post = null, string $post_type = ‘page’ ): string[]

In this article

Parameters

Return

Source

Hooks

Related

Changelog

User Contributed Notes