WP_Theme::get_page_templates( WP_Post|null $post = null, string $post_type = 'page' )
Returns the theme’s post templates for a given post type.
Parameters
- $post
-
(Optional) The post being edited, provided for context.
Default value: null
- $post_type
-
(Optional) Post type to get the templates for. Default 'page'. If a post is provided, its post type is used.
Default value: 'page'
Return
(array) Array of page templates, keyed by filename, with the value of the translated header name.
Source
File: wp-includes/class-wp-theme.php
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 WP-4.9.6
*
* @param string[] $post_templates Array of page templates. Keys are filenames,
* values are translated names.
* @param WP_Theme $this 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.
*
* @since WP-3.9.0
* @since WP-4.4.0 Converted to allow complete control over the `$page_templates` array.
* @since WP-4.7.0 Added the `$post_type` parameter.
*
* @param array $post_templates Array of page templates. Keys are filenames,
* values are translated names.
* @param WP_Theme $this 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;
}
Changelog
Version | Description |
---|---|
WP-4.7.0 | Added the $post_type parameter. |
WP-3.4.0 | Introduced. |