函数文档

_preview_theme_template_filter()

💡 云策文档标注

概述

_preview_theme_template_filter() 是一个私有函数,用于在预览主题时修改当前模板。该函数已在 WordPress 4.3.0 版本中被弃用,返回空字符串。

关键要点

  • 函数用途:在主题预览期间调整当前模板
  • 弃用状态:自 WordPress 4.3.0 起被标记为弃用,使用 _deprecated_function() 通知
  • 返回值:始终返回空字符串
  • 版本历史:引入于 2.9.0,弃用于 4.3.0

注意事项

  • 开发者应避免在新代码中使用此函数,因其已弃用
  • 相关函数 _deprecated_function() 用于处理弃用通知

📄 原文内容

Private function to modify the current template when previewing a theme

Return

string

Source

function _preview_theme_template_filter() {
	_deprecated_function( __FUNCTION__, '4.3.0' );
	return '';
}

Changelog

Version Description
4.3.0 Deprecated.
2.9.0 Introduced.