用 seagull 已有的module创建一个简单站点

一、安装 simplesite 模块

1、  在首页 ( 例如 http://localhost/seagull/www/index.php) 右边的登入框（如下图所示）中输入用户名和密码，登入系统后台。（这里的用户名和密码是之后在安装时创建的“ Admin username ”）

      

2、      进入后台的界面，如下图，选择左边菜单的“ General ”－ > “ Manage Modules ” （如下图的 1,2 标示）进入“模组管理”。在这里打勾复选框“显示未安装的模块”（如下图的标示 3 ）

3 、勾选“显示未安装的模块 ”之后，模块列表将列出所有的模块信息。如下图所示。

这里，点击标题为“ simplesite ”后面的“ ”号，此时页面刷新，显示提示信息“ The simplesite module was successfully installed ”（如下图标示 1 所示）说明，安装 simplesite  模块完功。

这里可以在“模块列表”中看到“ simplesite ”已安装成功（如下图标示 2 所示）。

      

 

二、设置导航栏显示菜单

1 、在后台左边菜单中选择“ Navigation ”－ > “ Manage Navigation ”，（如下图的 1,2 标示）进入“ Section 管理”。在这里，点击“动作”中的“新建 Section ”按键（如下图的标示 3 ），进入“ Section 管理 :: 新建 Section ”界面。

 

 

 

2、      在“ Section 管理 :: 新建 Section ”界面的“ section 信息 ”标签页中，如下图所示：

其中：

1、  section 标题 ：输入在导航栏显示菜单中要显示的名称，例如这里用“简单站点 ”。

2、  父 section ：选择菜单名称的父级菜单。如下图所示，这里在两大类： a) User menu ，一般用户的显示菜单，即前台导航栏的显示菜单； b) Admin menu ，管理员的显示菜单，即后台左边的导航菜单。

我们现在的制作的“简单站点 ”是希望一般用户不用登入也可以看到的，所以这里选择“ User menu ”作为父级。

 

 

3、      目标 ：即选择菜单“简单站点 ”的链接指向。因为我们现在是要使用之前创建的“ simplesite ”模块，所以，这里我们选择“从指定模块输出 ”这个选项。

 

选择“从指定模块输出 ”选项之后，“目标 ”下面的栏位（“静态文章标题 ”栏位是针对“现存的静态内容 ”选项）就相应改变了，如下图所示：

4、      模块 ：指定菜单“简单站点 ”的所在模块。如下图所示：

下拉框中，列出所有已安装的模块名称，这里我们选择“ simplesite ”模块。

5、      管理类 ：选择完“模块 ”之后，“管理类 ”的下拉框中将列出该模块的所有 MGR 类（即 seagull 目录 modules/ 模块名 /classes/ 目录下所有后缀为 Mgr.php 的类名）如下图所示：

这里我们的“ simplesite ”模块只有一个管理类，即“ SimplesiteMgr ”。

6、      action ：指定上面“管理类 ”中的 action 名称，下拉框中，列出“管理类 ”中所有的 action 名称。如下图所示：

            这里只有一个“ list ”选项，我们可以选择“ list ”，也可以不做选择。

当不做选择时，系统会自动读取管理类代码中设定的默认 action ，一般情况下代码中的默认 action 值是 list 。

 

 

 

3、      选择“ Section 管理 :: 新建 Section ”界面的“编辑选项 ”标签页，如下图标示 1 所示：

然后在图上标示 2 中设置如下：

1）  发布： 即发布菜单“简单站点 ”。这里的复选框必需打勾 。

2）  允许浏览： 即选择允许查看菜单“简单站点 ”的用户组角色，也可以说是，为其设置访问权限。（注：这里列出了所有的用户组以供选择 ）

设置好以上，点击“存贮 ”按键（图上标示 3 所示）之后，页面跳回“ Section 管理 :: 浏览 ”界面，并显示提示信息“完成区段新增 ”（如下图标示 1 所示）。此时你可以在列表中看到新增的“简单站点 ”菜单，如下图标示 2 所示。

 

4、      此时，再回到首页 ( 即，例如 http://localhost/seagull/www/index.php ) ，你可以在导航栏上看到“简单站点 ”菜单。

 

如下图 1 为未登入的首页界面

 

 

图 2 为管理员登入后的首页界面

5、      此时点击导航栏上的“简单站点 ”菜单，即可进入对应界面，界面情况如下图所示：

 

图中红色区域，便是“简单站点 ”所在的模块“ simplesite ”中的管理类“ SimplesiteMgr ”对应 action 为“ list ”中所指定的模板的显示内容，即 seagull 目录下，总路径为： seagull/modules/simplesite/templates/ 下面的“ index.html ” 模板。

此时，一个站点即已建成。

 

  三、备注

1 、 查看模块管理类中某个 action 调用的是哪个模板的方法（这里以 SimplesiteMgr 为例）：

Seagull 目录下，找到 seagull/modules/simplesite/classes/SimplesiteMgr.php 文件中的 action 为“ list ”，即“ function _cmd_list(&$input, &$output) ”。

其中的“ $output->template ”变量的值，便是最后显示的模板。如下图的标示 1 、 2 、 3 所示，我们可以看到 action 为“ list ”所调用的模板是“ index.html ”。

 

       

2、      action 为“ list ”所调用的模板“ index.html ”的内容，我们可以在 seagull/modules/simplesite/templates/index.html 文件中看到，其中的代码内容就是网页中的显示内容。代码载图如下：