默认WordPress的样式表需要遵从第一行是主题的名字、第二行是主题的地址,如果用来发布付费主题。第三行是主题的描述、第四行是版本号、第五和第六行分别是主题作者的名字和主页。
get_theme_data()
该函数将主题文件内的style.css文件中的主题相关信息(也就是每个wordpress的主题样式页头必须遵守的主题描述格式)通过数组返回,需要说明的是该函数没有默认参数,参数必须指定为你的主题文件名。
下面将列举该函数能够返回的主题信息:
主题的URI
Description
–wordpress格式的主题描述内容AuthorURI
–主题作者的URITemplate
–主题的主模板名称(在wordpress中属于可选填的内容)Version
–主题版本Status
–主题状态(默认值:发布)Tags
–主题标签Author
–主题作者名
例如:在style.css中写:
/*
ThemeName:brokensky
ThemeURI:http://www.brokenjoin.org
Description:It'sathemecreatebybrokenjoin
Version:1.0
Author:guolizhou
AuthorURI:join
Tags:customheader,fixedwidth,twocolumns,widgets
*/
需要注意的是,这些返回值的参数名必须首字母大写,否则将没有正确值返回。
最直接简单的用法,如果需要获取其他信息仅仅需要替换方括号内的内容即可。
$theme_name='twentyeleven';
$theme_data=get_theme_data(get_theme_root().'/'.$theme_name.'/style.css');
echo$theme_data['Title'];
echo$theme_data['Author'];
实例运用说明
主题开发者对于自己开发的主题都有版本跟踪,或者你是个某个付费主题的使用者,当作者升级以后,你不清楚当前的主题版本,那么下面这个函数将对让你清楚的了解到当前的版本是多少
//获取并显示主题版本号
functiontheme_version(){
$theme_name='twentyeleven';//你所使用的主题名
$theme_data=get_theme_data(get_theme_root().'/'.$theme_name.'/style.css');
echo'?v='.$theme_data['Version'];
}
页面前台调用代码和最终的HTML输出如下所示
当然我们通过一些适当的修改还可以将我们的theme_version()函数改为短码调用(shortcode)方便使用
//版本号短码函数
functiontheme_version_shortcode(){
$theme_name='xycss';//customizewithyourthemename
$theme_data=get_theme_data(get_theme_root().'/'.$theme_name.'/style.css');
return$theme_data['Version'];
}
那么短码调用方式如下:
[theme_version]
输出的html结果为:
1.3
以上的例子只是最简便的的get_theme_data()函数的运用