W3cubDocs

/WordPress

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

Gets the page templates available in this theme.

$post

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

Default value: null

$post_type

(string) (Optional) Post type to get the templates for.

Default value: 'page'

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

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.

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

Uses	Description
wp-includes/theme.php: wp_get_theme()	Gets a WP_Theme object for a theme.
wp-includes/class-wp-theme.php: WP_Theme::get_page_templates()	Returns the theme’s post templates for a given post type.

Used By	Description
wp-admin/includes/meta-boxes.php: register_and_do_post_meta_boxes()	Registers the default post meta boxes, and runs the `do_meta_boxes` actions.
wp-admin/includes/template.php: page_template_dropdown()	Print out option HTML elements for the page templates drop-down.
wp-admin/includes/meta-boxes.php: page_attributes_meta_box()	Display page attributes form fields.
wp-admin/includes/class-wp-posts-list-table.php: WP_Posts_List_Table::inline_edit()	Outputs the hidden row displayed when inline editing
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_getPageTemplates()	Retrieve page templates.

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

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_page_templates