is_child_theme()

查看官方原文 ↗

💡 云策文档标注

概述

is_child_theme() 是一个 WordPress 函数，用于检测当前是否正在使用子主题。它通过比较全局变量 $wp_stylesheet_path 和 $wp_template_path 来判断，返回布尔值。

函数返回布尔值：true 表示正在使用子主题，false 表示未使用子主题。
内部实现基于全局变量 $wp_stylesheet_path 和 $wp_template_path 的比较。
在插件中调用时需注意，可能因 TEMPLATEPATH 和 STYLESHEETPATH 常量未定义而导致问题，建议使用 get_template_directory() !== get_stylesheet_directory() 替代。

在插件激活等场景中，TEMPLATEPATH 和 STYLESHEETPATH 常量可能未定义，使用 get_template_directory() 和 get_stylesheet_directory() 更安全。

📄 原文内容

Whether a child theme is in use.

bool True if a child theme is in use, false otherwise.

function is_child_theme() {
	global $wp_stylesheet_path, $wp_template_path;

	return $wp_stylesheet_path !== $wp_template_path;
}

Used by	Description
get_block_asset_url()`wp-includes/blocks.php`	Gets the URL to a block asset.
WP_Site_Health::get_test_theme_version()`wp-admin/includes/class-wp-site-health.php`	Tests if themes are outdated, or unnecessary.
wp_get_active_and_valid_themes()`wp-includes/load.php`	Retrieves an array of active and valid themes.
WP_Customize_Manager::prepare_starter_content_attachments()`wp-includes/class-wp-customize-manager.php`	Prepares starter content attachments.
get_editor_stylesheets()`wp-includes/theme.php`	Retrieves any registered editor stylesheet URLs.
validate_current_theme()`wp-includes/theme.php`	Checks that the active theme has the required files.
locate_template()`wp-includes/template.php`	Retrieves the name of the highest priority template file that exists.
get_body_class()`wp-includes/post-template.php`	Retrieves an array of the class names for the body element.

Version	Description
6.5.0	Makes use of global template variables.
3.0.0	Introduced.