luci 添加helloword模块

备注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文件---直接调用