发布时间：2025-12-31 浏览：28 评论: 0 留言/反馈/举报 您的位置：美国
资源下载
温馨提示：本站免费源码只供您学习研究使用，请勿商业运营，违法使用和传播！否则因为版权及其他原因造成纠纷或者损失，本站概不负责！
ArticleExt 简介：
Emlog自定义字段插件ArticleExt使用说明：
我一直用的是Typecho，最近想换成Emlog试试水。作为一个爱捣鼓主题的新手开发者（说白了就是菜鸡瞎折腾），研究了一圈Emlog，整体功能都能满足我的需求，唯独少了个自定义字段——做主题开发的都懂，文章页面经常要靠自定义字段做各种判断逻辑，没这个功能太别扭了。所以我就自己捣鼓了这个ArticleExt插件，专门补Emlog这个短板。
重要提醒：这个插件不是单独用的，必须配合主题一起用，光装插件不改主题没用哈！下面就给大家说下具体怎么用，手把手教你上手。
一、先在主题里创建必要文件
首先得在你的Emlog主题文件夹里，新建一个文件，文件名固定叫articleSettings.php，这个文件是用来配置自定义字段的模板，相当于告诉插件你要加哪些自定义字段、字段类型是什么。
二、基础模板代码及配置说明
把下面这段代码复制到刚创建的articleSettings.php里，然后根据自己的需求修改配置就行，每一项我都用大白话解释清楚了：
<?php
/*@support AritcleExt*/ // 这行是标识，告诉插件这个文件是适配它的，别删
!defined('EMLOG_ROOT') && exit('access deined!'); // 安全防护，防止直接访问文件
$articleSettings = array(
array(
'type' => 'select', // 必选项！字段类型，可选：单选框（radio）、普通文本（text）、文本域（textarea）、下拉框（select）
'name' => 'xiao', // 必选项！表单的名称，后续调用字段就靠这个名，自己起个好记的
'title' => '自定义字段名字', // 必选项！字段在后台显示的名称，比如“文章封面类型”
'diyClass' => '自定义Class类名', // 必选项！给字段加自定义样式类，用不上就空着（直接写''）
'default' => '文字', // 非必选项！只有text和textarea类型能用，设置默认显示的内容
'explain' => '说明，支持html标签<b>加粗</b>', // 必选项！字段说明，告诉自己/别人这个字段是干嘛的，支持HTML标签
'singleChoice'=>array( // 非必选项！只有radio和select类型能用，用来设置选项
/*** 下面这组代码千万别删、也别挪位置，固定放第一个 ***/
array(
'name' => "check", // 固定值，别动
"check"=>'maxImg' // 默认选中的选项值，要和下面的选项value对应上
),
/*** 上面这部分是固定配置，结束 ***/
array(
'name' => "大图", // 选项显示名称，比如下拉框里显示“大图”
'value' => 'maxImg' // 选项对应的值，后台选中后存储的就是这个值
),
array(
'name' => "小图", // 另一个选项的显示名称
'value' => 'minImg' // 另一个选项对应的值
)
)
),
);三、关键注意点
重点说下singleChoice里的配置：第一个数组（带check的那组）是核心配置，必须保留，而且位置不能动，一动整个字段就失效了，就按模板里的写，只改check后面的值就行，改成你想默认选中的选项value。
四、前台主题调用方法
配置好字段后，就要在主题前台页面（比如文章详情页single.php）调用这个字段的值了，方法很简单，把下面这段代码插在你要显示的位置：
<?php $AeArr = queryArtcleExt($gid); // 调用插件方法，获取当前文章的自定义字段数据，$gid是文章自带的ID，不用改 $AeArr[$name]; // 取出对应字段的值，$name换成你前面配置的字段name（比如示例里的xiao） ?>
举个例子：如果我配置的字段name是xiao，想在文章页显示这个字段的值，就写成
$AeArr['xiao']; 就行。五、返回值说明
调用后返回的是纯字段内容，格式很简单，就是你在后台设置的字段值，比如选中“大图”的话，返回的就是
maxImg，直接用这个值做判断、显示内容都可以。整体用法就是这样，核心就是先建配置文件、设置字段参数，再在前台调用，适合需要给Emlog主题加自定义字段功能的开发者，新手也能跟着一步步操作，有问题可以多捣鼓几遍配置文件~
网友评论