云策 WordPress 开发者社区

函数文档

wp_set_template_globals()

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

概述

wp_set_template_globals() 是一个 WordPress 函数，用于设置模板加载所需的全局变量。它初始化 $wp_stylesheet_path 和 $wp_template_path 变量，分别指向活动主题的样式表目录和模板目录。

关键要点

  • 函数定义在 wp-includes/theme.php 中，从 WordPress 6.5.0 版本引入。
  • 通过调用 get_stylesheet_directory() 和 get_template_directory() 来获取路径，并赋值给全局变量。
  • 主要用于支持主题切换和模板定位功能，如被 switch_theme() 和 locate_template() 调用。
📄 原文内容

Set up the globals used for template loading.

Source

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

	$wp_stylesheet_path = get_stylesheet_directory();
	$wp_template_path   = get_template_directory();
}

View all references View on Trac View on GitHub

Uses Description
get_stylesheet_directory()wp-includes/theme.php

Retrieves stylesheet directory path for the active theme.
get_template_directory()wp-includes/theme.php

Retrieves template directory path for the active theme.
Used by Description
switch_theme()wp-includes/theme.php

Switches the theme.
locate_template()wp-includes/template.php

Retrieves the name of the highest priority template file that exists.

Changelog

Version Description
6.5.0 Introduced.