云策 WordPress 开发者社区

函数文档

get_template()

查看官方原文 ↗
💡 云策文档标注

概述

get_template() 函数用于获取当前活动主题的目录名称，返回字符串类型。当使用子主题时，此函数返回父主题的目录名。

关键要点

  • 返回当前活动主题的目录名，不带尾部斜杠
  • 如果使用子主题，返回父主题的目录名；要获取子主题目录名，请使用 get_stylesheet()
  • 函数通过 apply_filters('template', $template) 应用过滤器，允许开发者修改返回值

代码示例

echo get_template(); // 输出：heli

注意事项

  • 在子主题激活时，get_template() 返回父主题名，而非子主题名；如需获取当前主题名（无论是否为子主题），请使用 get_stylesheet()
📄 原文内容

Retrieves name of the active theme.

Return

string Template name.

More Information

This function retrieves the directory name of the current theme, without the trailing slash. In the case a child theme is being used, the directory name of the parent theme will be returned. Use get_stylesheet() to get the directory name of the child theme.

Source

function get_template() {
	/**
	 * Filters the name of the active theme.
	 *
	 * @since 1.5.0
	 *
	 * @param string $template active theme's directory name.
	 */
	return apply_filters( 'template', get_option( 'template' ) );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘template’, string $template )

Filters the name of the active theme.

Uses Description
apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.
get_option()wp-includes/option.php

Retrieves an option value based on an option name.
Used by Description
WP_Debug_Data::get_wp_filesystem()wp-admin/includes/class-wp-debug-data.php

Gets the file system section of the debug data.
get_block_asset_url()wp-includes/blocks.php

Gets the URL to a block asset.
_get_block_template_file()wp-includes/block-template-utils.php

Retrieves the template file from the theme for a given slug.
_get_block_templates_files()wp-includes/block-template-utils.php

Retrieves the template files from the theme.
resolve_block_template()wp-includes/block-template.php

Returns the correct ‘wp_template’ to render for the request template type.
is_theme_paused()wp-admin/includes/theme.php

Determines whether a theme is technically active but was paused while loading.
wp_edit_theme_plugin_file()wp-admin/includes/file.php

Attempts to edit a file for a theme or plugin.
Theme_Upgrader::bulk_upgrade()wp-admin/includes/class-theme-upgrader.php

Upgrades several themes at once.
get_template_directory()wp-includes/theme.php

Retrieves template directory path for the active theme.
get_template_directory_uri()wp-includes/theme.php

Retrieves template directory URI for the active theme.
get_body_class()wp-includes/post-template.php

Retrieves an array of the class names for the body element.

Show 6 moreShow less

Changelog

Version Description
1.5.0 Introduced.

User Contributed Notes

  2. Skip to note 4 content


    Will Skora


    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

    Note that get_template will return the parent theme’s name, NOT the child theme’s name, if a child theme is currently activated.

    If you wish to obtain the current theme regardless if it is a child theme or the parent theme, use get_stylesheet

    (reference question on wordpress stack exchange)