Emlog模板设置插件使用教程及开发规范

一直以来，emlog走的轻量级路线，没有集成模板后台设置，于是很多功能强大的模板不得不在需要的时候，修改文件以改变设置。那么，有了这个插件以后，就可以不用如此纠结了，只要模板按照开发规范来开发，就可以使用本插件在后台进行设置了。重点强调，本插件是辅助插件，所有设置依赖于模板的功能，而不是插件本身，因此不要问我为什么没有blabla功能，请去寻求模板作者。

插件名称：模板设置
插件作者：奇遇
下载地址：https://www.tuyuanma.com/news-1124-1-1

哪些模板支持？
多模板，尤其是CMS模板，会有很多设置项，大多会有一个options.php文件，当你需要修改配置时，就得去修改文件，那么哪些模板才能用上插件的后台设置功能呢？
答案是：按照规范来开发的模板。模板开发者请看下面！

如何让模板能被插件识别？
在模板目录里放入options.php，内容格式如下即可，可以任意增加设置项，注意$options变量和注释：

* a+ w$ W3 ^: [
<?php6 O3 z' L' e% |# v+ W0 [
/*@support tpl_options*/
& {; N0 E2 t3 T7 W5 ^( u( W
!defined('EMLOG_ROOT') && exit('access deined!');$ [" _3 D" p, C/ l0 Q7 k
$options = array(
% R: _7 k5 O1 `
'sidebar' => array(5 L7 ~) t1 p' `* N$ d$ t
'type' => 'radio',* X+ a/ ? _9 [
'name' => '侧边栏位置',6 g. h' c/ V$ l! o3 s% l9 G
'values' => array(
+ V0 n& ~; S% h8 g- ? s
'left' => '左边',
$ m" C1 A4 }' o4 |7 f5 z
'right' => '右边'
# W1 u% y+ c- H( x; I. M
),
- D, C! t2 Y) p( J6 J- i
'default' => 'right'," m8 ^! l: T2 L
),) g( x9 E% R7 x' \
'sortIcon' => array(; o5 b+ t2 y/ {: S) m& {
'type' => 'image',# b' V4 f2 t" M" |$ E7 ]
'name' => '分类图标设置',- \2 p x5 Y% X8 b
'values' => array() y/ b' Y5 T8 w F- _2 p& h: O* @/ _3 e& S
TEMPLATE_URL . 'images/star.png',- I: o7 \1 t# X x
),
3 c. i# e' c6 S. z& J f8 R
'depend' => 'sort', `4 u8 I6 K/ W: s9 N/ c5 t! w
'unsorted' => true,
, L/ O: \: m$ T4 F. `, m
'description' => '给不同的分类设置不一样的小icon，以20×20为宜',
0 z$ V, L4 e8 l. W) `6 \, p
),! g5 ^9 D$ J- m6 [& m
);

复制代码

options.php里，每个元素都该写什么？
如上所示，$options数组里，key为设置项的id，而value是一个数组，数组里包含若干个元素。其中type属性和name属性必选，name是设置项名字，而type用来指定设置项的类型，支持的类型如下：

radio: 单选按钮% ]9 q7 e M: Z* V7 P8 W
checkbox: 复选按钮3 J" G2 ~$ Q% v2 Z- x$ Z
text: 文本
* L/ |, I* }8 U& t7 u
image: 图片
0 U ?0 W2 O/ R* Z; T: I
page: 页面. R' U$ L) r$ q! Q
sort: 分类1 g0 p2 V F" C3 S
TAG: 标签

复制代码

对于所有类型，default属性用于指定默认值，当没有指定default时，使用values里第一个值，若都没有指定，则会使用奇怪的默认值。
对于radio和chexkbox，values属性用来设置各个按钮的值和显示名称。
除sort外，均可以指定depend为sort，表示该选项可以根据不同的分类设置不同的值，当指定depend为sort时，可选unsorted属性，为true时，表示包括未分类，为false不包括，默认为true。
sort和page可设置multi属性为true，表示多选。
description属性可选，用以描述该选项。
若type为text，可设置multi属性为true，表示多行文本，即input和textarea的区别，可选属性rich用以支持富文本，若设置该值，将加载编辑器。
若type为sort、page或者tag，且设置了多选，默认值将为空，否则将为第一个该类型的值。

模板里如何调用设置项
插件提供简单方法_g($key)，如上示例，可以使用_g('sidebar')来获取侧边栏的设置，取到的值将为0或者1，使用_g('sortIcon')来获取分类icon的全部设置，以分类id为key的数组，使用_g('sortIcon.1')来获取分类id为1（如果存在）的sortIcon。需要注意的是，对于类型为page的，将取到页面id，类型为sort的，将取到分类id，类型为tag的，将取到标签名。若不传递参数，即使用_g()方法将获取到所有设置项，对于老的模板迁移来的，可以用extract(_g());来代替原来的加载option文件。

		自动登录	找回密码
密码			立即注册

Emlog模板设置插件使用教程及开发规范-站长杂谈下载

Emlog模板设置插件使用教程及开发规范

相关文章

全部评论 0

最佳新人

贡献之王

土豪装逼

管理/版主

教程 / CSS+DIV素材

【原创】去除Discuz!X3.5门户编辑器勾选源码后，编辑器中自带的165人阅读

【原创】解除Discuz!X3.5登录admin.php管理员后台被强制登录账号363人阅读

【原创】Discuz搜索门户文章内容实现展示栏目名称，搜索门户文章478人阅读

【原创】通过计划任务，实现Sitemap.xml地图制作403人阅读

修改Discuz!X3.5系统内置的DIY幻灯片样式734人阅读

【原创】左侧导航栏样式，点击展开一级分类二级分类的DIY+CSS+JS1022人阅读

【原创】discuz论坛首页四格，幻灯片+文字列表切换功能DIY+CSS+j2779人阅读

【原创】侧边导航栏样式，点击跳转到对应位置的DIY+CSS模块2593人阅读

【原创】分享一款html5+css3带倒计时效果并跳转指定网址的单页DI2718人阅读

【原创】分享一款横排5格免扣字体素材资源下载风格DIY+JS+CSS模3145人阅读

所属版块