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

Gets the page templates available in this theme.

Contents

Parameters

$post WP_Post|null Optional
The post being edited, provided for context.

Default: null

$post_type string Optional
Post type to get the templates for. Default 'page'.

Default: 'page'

Top ↑

Return

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

Top ↑

More Information

The function searches all the current theme’s template files for the commented “Template Name: name of template”. See also wp_get_theme() and the wp_get_theme() ->get_page_templates() method of the WP_Theme class.

Top ↑

Source

File: wp-admin/includes/theme.php. View all references 

function get_page_templates( $post = null, $post_type = 'page' ) {
	return array_flip( wp_get_theme()->get_page_templates( $post, $post_type ) );
}

View on Trac View on GitHub

Top ↑

Top ↑

Used By

Used By
Used By Description
register_and_do_post_meta_boxes() wp-admin/includes/meta-boxes.php

Registers the default post meta boxes, and runs the do_meta_boxes actions.
page_template_dropdown() wp-admin/includes/template.php

Prints out option HTML elements for the page templates drop-down.
page_attributes_meta_box() wp-admin/includes/meta-boxes.php

Displays page attributes form fields.
WP_Posts_List_Table::inline_edit() wp-admin/includes/class-wp-posts-list-table.php

Outputs the hidden row displayed when inline editing
wp_xmlrpc_server::wp_getPageTemplates() wp-includes/class-wp-xmlrpc-server.php

Retrieves page templates.

Top ↑

Changelog

Changelog
Version Description
4.7.0 Added the $post_type parameter.
1.5.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    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
    Contributed by Codex —

    Output a list of available templates

    The following code snippet loops through the available page templates and outputs their template names and the filenames.

    <?php 
$templates = wp_get_theme()->get_page_templates();
print_r( $templates );
?>

    Returns:

    Array (
	[template-contact.php] => Contact
	[template-landing-page.php] => Landing Page
	[template-another-template.php] => Another Template
)

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