模板——模板区块制作教程

模块制作步骤

第一步，根据要添加模块的模板名，简历模块文件夹

比如我新建了一个aoyun的模板，要为这个模板添加一个自己的模块。

在根目录/block下建立一个aoyun的文件夹。

在aoyun目录下建立一个自己唯一的模块名字，比如myblock。

第二步，为文件夹添加必须的文件。

在aoyun/myblock目录下建立一个block.php（名字固定）文件，内容如下：

<?php

$block['name']='我的测试';

$block['description'] = '学习模块的制作。';

$block['author']='互动百科';

$block['version']='4.2';

$block['time']='2010-6-12';

$block['fun'] = array(

'test2'=>'测试一下'

);

?>

在aoyun/myblock目录下建立一个myblock.php（与myblock目录一致）文件，内容如下：

<?php

class myblock{

var $db;

var $base;

function myblock(&$base) {

$this->base = $base;

$this->db = $base->db;

}

function test2(){

$data=array(123,456,789);

return $data;

}

}

?>

在aoyun/myblock目录下建立一个test2.htm（与myblock类的test2方法对应）文件，内容如下：

<div class="xxx" bid="{$bid}">

<h2 class="col-h2">我的测试</h2>

<ul class="col-ul font-14 ">

<!--{loop $data $val}-->

<li>$val</li>

<!--{/loop}-->

</ul>

</div>

这个模板页最简单可以写作<div bid="{$bid}"></div>只要保留外边框div和bid="{$bid}"属性，就可以了。

到此模块制作完成，可以在奥运模板的可视化编辑中，添加此刚刚添加的模块了。

模块目录介绍

上图，wiki根目录下面有个block目录，block目录里面包含了不同模板提供的模块。

default目录是HDwiki默认区块对应default模板，此目录里面的模块，可以被任何模板使用。

aoyun目录是刚才我们自己添加的下面提供的区块，只能被奥运模板使用。别的模板在添加区块的时候不会显示下面的区块。

aoyun目录也可以直接复制default里面的某一个区块或者区块的某一个文件，这样就覆盖掉了default里的区块。

上图，default目录下面包含了已经开发好几个模块。这里的模块可以被任何模板添加板块时看到。每个文件夹就是一个模块。

现在以doc模块为例，看看每个模块包含的文件列表。如下图：

block.php 必须有的文件 记录了此模块的一些基本信息。

doc.php 非必须的文件 根据参数为模块显示模板提供取出来的数据。

doc.inc.php 非必须的文件 模块配置表单提供程序数据，一般不需要写。

getlist.htm 非必须的文件 此模块方法的显示模板

getlist_inc.htm 非必须的文件 此模块方法的配置表单

具体的文件内容可以参考相应的文件。

模块使用条件

要使模板可以添加模块，必须让模板有可以添加模块的区域。以 default 模板的首页为例，在首页index.htm文件中，添加区域代码

<div id='block_middle'>{block:middle/}</div>

这样就添加了一个名字为middle的区域，这个区域将在后台可视化编辑时，以绿色虚框标示。

只要添加了类似标签的模板都可以使用可视化编辑，来添加模块。

制作过程的问题解答

模块模板中的js文件写在哪儿？

js文件直接写在模板的div中。参看用户登陆login.htm文件中的js。

模板参数若是需要程序提供数据，比如获取当前分类树，数据如何得到？

需要使用到XXX_inc.php的文件，这个文件，会被后台添加、编辑模块式时被调用，得到数据，这个文件的格式，类似于XXX.php文件。