本文详细介绍了如何在Z-BlogPHP中添加自定义字段,包括设置自定义域名选项、创建接口挂接页面以及在文章编辑界面显示和调用自定义字段的方法。
自定义字段是Z-BlogPHP的自定义域机制,即扩展数据机制,通过自定义域机制可以扩展文章的设置数据,比如实现自定义文章标题、关键词、描述、缩略图、文章评分等。给文章添加自定义字段很简单,只要定义选项及选项值(注意,选项的定义应是唯一的,不可与其它插件定义重复,值的要求与上述选项机制相同),在原数据保存时其自定义域操数据将同时被保存。
操作方法:
1、添加设置并保存自定义域名选项的函数,在当前主题的根目录新include.php文件中(注:如果已存在该文件,不需要再创建),并添加以下函数代码:
function boke8_meta(){
global $zbp,$article;
echo '<div class="editmod"><label for="meta_thumbnail" class="editinputname">自定义缩略图</label><input type="text" name="meta_thumbnail" style="width:99%;" value="'.htmlspecialchars($thumbnail).'"></div>';
}
2、创建接口挂接页面
在主题的include.php文件中添加如下格式代码,把主题ID改为当前使用的主题ID:
//注册插件
RegisterPlugin("主题ID","ActivePlugin_主题ID");
//具体的接口挂接
function ActivePlugin_主题ID() {
Add_Filter_Plugin('API名称','执行代码(函数)');
}
示例:
//注册插件
RegisterPlugin("boke8","ActivePlugin_boke8");
//具体的接口挂接
function ActivePlugin_boke8() {
Add_Filter_Plugin('Filter_Plugin_Edit_Response5','boke8_meta');
}
注:如果当前的主题是带有后台设置页面,那么只需要在挂接接口的位置挂载字段的接口即可:
Add_Filter_Plugin('Filter_Plugin_Edit_Response5','boke8_meta');
3、完成步骤2后,在文章编辑界面的标题输入框下就会出现一个输入缩略图地址的输入框,如下图:
zblog php主题添加支持文章自定义字段功能
4、调用字段:
调用自定义字段的值很简单,如在post-single.php文件中要显示自定义缩略图的位置,添加调用代码:
{$article.Metas.thumbnail}
注:如果不是在post-single.php文件调用,调用代码中的$article根据实际情况变化!
附:Z-BlogPHP提供众多系统级API接口,具体请看Z-BlogPHP系统接口分类与API。