bbp_locate_template (字符串|数组template_names美元,保龄球美元的负载=假,保龄球美元require_once=真正的)
检索现有的最高优先级模板文件的名称。
描述
在父主题之前搜索子主题,以便从父主题继承的主题只会重载一个文件。如果在这两个文件夹中都找不到模板,则最后查找theme-compat文件夹。
参数
- template_names美元
-
(字符串|数组)(必需)按顺序搜索的模板文件。
- 美元的负载
-
(保龄球)(可选)如果为true,模板文件将被加载。
默认值:假
- 美元require_once
-
(保龄球)(可选)是require_once还是require。如果$load为false,则没有效果。
默认值:真
返回
(字符串)模板文件名(如果找到的话)。
源
文件:bp-forums /核心/ template-functions.php
function bbp_locate_template($template_names, $load = false, $require_once = true){//未找到文件$locate = false;$ template_locations = bbp_get_template_stack ();//尝试找到一个模板文件foreach ((array) $template_names as $template_name){//继续如果模板为空if (empty($template_name)){继续;} //去掉模板名中的斜杠$template_name = ltrim($template_name, '/');//循环遍历模板栈foreach ((array) $template_locations as $template_location){//如果$template_location为空if (empty($template_location)) {Continue;} //先检查子主题如果(file_exists(trailingslashit($template_location))。美元template_name)){$位于= trailingslashit (template_location美元)。template_name美元;打破2;}}} /** *这个动作的存在只是为了遵循标准的论坛编码约定,*不应该被用来短路模板定位器的任何部分。 * * If you want to override a specific template part, please either filter * 'bbp_get_template_part' or add a new location to the template stack. */ do_action( 'bbp_locate_template', $located, $template_name, $template_names, $template_locations, $load, $require_once ); // Maybe load the template if one was located if ( ( true === $load ) && !empty( $located ) ) { load_template( $located, $require_once ); } return $located; }
更新日志
版本 | 描述 |
---|---|
bbPress (r3618) | 介绍了。 |