編輯“HDWiki/模塊區(qū)版塊制作教程”

{{HDWiki top}}
==模塊制作步驟==
第一步，根據(jù)要添加模塊的模板名，簡歷模塊文件夾

比如新建了一個aoyun的[[模板]]，要為這個模板添加一個自己的模塊。

在根目錄/block下建立一個aoyun的文件夾。

[[Image:HDmodule 1.jpg]]

在aoyun目錄下建立一個自己唯一的模塊名字，比如myblock。

[[Image:HDmodule 2.jpg]]

第二步，為文件夾添加必須的文件。

在aoyun/myblock目錄下建立一個block.php（名字固定）文件，內(nèi)容如下：
<pre>
<?php
$block['name']='我的測試';
$block['description'] = '學(xué)習(xí)模塊的制作。';
$block['author']='互動百科';
$block['version']='4.2';
$block['time']='2010-6-12';
$block['fun'] = array(
'test2'=>'測試一下'
);
?>
</pre>
在aoyun/myblock目錄下建立一個myblock.php（與myblock目錄一致）文件，內(nèi)容如下：
<pre>
<?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;
}
}
?>
</pre>
在aoyun/myblock目錄下建立一個test2.htm（與myblock類的test2方法對應(yīng)）文件，內(nèi)容如下：
<pre>
<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>
</pre>
這個模板頁最簡單可以寫作<div  bid="{$bid}"></div>只要保留外邊框div和bid="{$bid}"屬性，就可以了。

到此模塊制作完成，可以在奧運模板的可視化編輯中，添加此剛剛添加的模塊了.

[[Image:HDmodule 3.jpg]]

==模塊目錄介紹==
[[Image:HDmodule 4.jpg]]

上圖中，wiki根目錄下面有個block目錄，block目錄里面包含了不同模板提供的模塊。
*default目錄是HDwiki默認區(qū)塊對應(yīng)default模板，此目錄里面的模塊，可以被任何模板使用。
*aoyun目錄是剛才我們自己添加的下面提供的區(qū)塊，只能被奧運模板使用。別的模板在添加區(qū)塊的時候不會顯示下面的區(qū)塊。
*aoyun目錄也可以直接復(fù)制default里面的某一個區(qū)塊或者區(qū)塊的某一個文件，這樣就覆蓋掉了default里的區(qū)塊。

[[Image:HDmodule 5.jpg]]

上圖中，default目錄下面包含了已經(jīng)開發(fā)好幾個模塊。這里的模塊可以被任何模板添加板塊時看到。每個文件夾就是一個模塊。

現(xiàn)在以doc模塊為例，看看每個模塊包含的文件列表。如下圖：

[[Image:HDmodule 6.jpg]]

*block.php 必須有的文件 記錄了此模塊的一些基本信息。
*doc.php 非必須的文件 根據(jù)參數(shù)為模塊顯示模板提供取出來的[[數(shù)據(jù)]]。
*doc.inc.php 非必須的文件 模塊配置表單提供程序數(shù)據(jù)，一般不需要寫。
*getlist.htm 非必須的文件 此模塊方法的顯示模板
*getlist_inc.htm 非必須的文件 此模塊方法的配置表單
具體的文件內(nèi)容可以參考相應(yīng)的文件。

==模塊使用條件==
要使模板可以添加模塊，必須讓模板有可以添加模塊的區(qū)域。以 default 模板的首頁為例，在首頁index.htm文件中，添加區(qū)域代碼
 <div id='block_middle'>{block:middle/}</div>
這樣就添加了一個名字為middle的區(qū)域，這個區(qū)域?qū)⒃诤笈_可視化編輯時，以綠色虛框標(biāo)示。

只要添加了類似標(biāo)簽的模板都可以使用可視化編輯，來添加模塊。

==制作過程的問題解答==
模塊模板中的js文件寫在哪兒？

[[js]]文件直接寫在模板的div中。參看用戶登陸login.htm文件中的js。

模板參數(shù)若是需要程序提供數(shù)據(jù)，比如獲取當(dāng)前分類樹，數(shù)據(jù)如何得到？

需要使用到XXX_inc.php的文件，這個文件，會被后臺添加、編輯模塊式時被調(diào)用，得到數(shù)據(jù)，這個文件的格式，類似于XXX.php文件。

==參考來源==
http://kaiyuan.hudong.com/

{{HDWIKI}}

[[category:HDWiki|M]]