备注
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%>
<%:hello world%>
<%+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文件---直接调用