theme_templates

💡 云策文档标注

概述

theme_templates 过滤器用于修改主题的页面模板列表。它允许开发者在获取模板时动态调整或添加模板选项。

过滤器名称：theme_templates
参数：$post_templates（模板文件名键控的模板头名数组）、$theme（主题对象）、$post（当前编辑的文章对象或 null）、$post_type（文章类型）
用途：在 WP_Theme::get_page_templates() 中调用，用于返回指定文章类型的主题文章模板
引入版本：WordPress 4.9.6

$post_templates = (array) apply_filters( 'theme_templates', $post_templates, $this, $post, $post_type );

📄 原文内容

Filters list of page templates for a theme.

$post_templatesstring[]: Array of template header names keyed by the template file name.
$themeWP_Theme: The theme object.
$postWP_Post|null: The post being edited, provided for context, or null.
$post_typestring: Post type to get the templates for.

$post_templates = (array) apply_filters( 'theme_templates', $post_templates, $this, $post, $post_type );

Used by	Description
WP_Theme::get_page_templates()`wp-includes/class-wp-theme.php`	Returns the theme’s post templates for a given post type.

Version	Description
4.9.6	Introduced.