备注1:本文 讲述的是原生的openWRT环境下的LUCI
备注2:本文參考了诸多资料。感谢网友分享。參考资料:
http://www.cnblogs.com/zmkeil/archive/2013/05/14/3078774.html
文章开篇:加入一个选项,该选项处理结果:显示hello world字串的网页
注:我们先将页面加入出来。然后我将分析怎样为什么这么加入的。
目的:在system菜单下加入一个名字为heyg1的选项,处理结果显示“hello world”
第一步:/usr/lib/lua/luci/controller/admin/system.lua中注冊选项:
entry({"admin", "system", "heyg1"}, template("heyg/heyg1"), _("heyg1"), 3).dependent=false
第二步:在view文件夹下加入对应的heyg1.htm文件
/usr/lib/lua/luci/view/heyg/heyg1.htm
Heyg.htm源代码为:
<%+header%>
<h1><%:hello world%></h1>
<%+footer%>
第三步:将上面文件加入完毕后,保存登录路由后台能够看到结果(有时可能须要又一次启动 路由)
分析为什么要这么加入(个人分析,不对相互讨论,勿喷):
实际上我们看到的web界面,在luci下是以“树-结点”的方式存在:
第一步分析:
我们看到/usr/lib/lua/luci/controller/admin/下非常多*.lua文件,基本都是注冊模块,然后注冊“结点”,每一个lua文件都是一个结点生成文件(初学能够这么理解),正如我们web后台界面看到的:在后端system就是system.lua这个结点文件生成的。
所以我们须要在system.lua文件里通过entry()函数去注冊我们要加入的节点hey1
entry({"admin", "system", "heyg1"}, template("heyg/heyg1"), _("heyg1"), 3).dependent=false
Entry()函数分析:
參数一:插入的节点名字,如:{“admin”, “system”, “heyg1”},表示在admin下system中插入节点heyg1
參数二:插入的heyg1节点要做什么(动作时什么),通常有以下几种方式:
方式一:template方式。即调该节点会直接调用view下的对应htm文件
方式二:cbi/form方式。会调用model下的对应文件做对应的处理
方式三:call方式,会调用本文件或者导入文件的函数
其它方式:
Alias:表示链接到其它某个节点
这里template(“heyg/heyg1”)会调用view/heyg/heyg1.htm文件
參数三:插入节点在相应位置的名字,在web界面相应菜单中的显示名字
这里_(“heyg1”),在web的菜单中显示为heyg1
參数四:插入结点的同等级的不同分类,或者说是差别同等级下的其它结点的数字代号
这里3,不能和同级别下的其它选项反复
在菜单中级别是从小到大的显示如:system(1)、Administration(2)、heyg1(3)....
Entry()函数的一些属性解析:对于插入一个结点,该结点除了有对应的名称和处理动作之外,它另一些对应的属性,我们能够手动的设置它的属性值类似于entry().dependent=false
官方文旦中给出下面属性:
dependent :当该节点的父节点丢失时。将该节点保护起来,不让它被意外调用
leaf:假设该节点下还有其它子节点,解析到该结点时。就不向下继续解析其子节点。
sysauth:在使用该节点时须要一个系统账户验证
I18n:定义了当求页面请求时。哪些文件会自己主动载入
其它属性(纯属自己推測,如有不正,多多不吝赐教,勿喷):
Index:将该节点作为同级文件夹下的作为首页,或者说默认的第一个页面
能够參考luci官方文旦:
http://luci.subsignal.org/trac/wiki/Documentation/ModulesHowTo
第二步分析:依据第一步分析,我们要在对应的view文件夹下加入我们的htm文件---直接调用