8. 前台檔案結構

一、 前台結構

1. 前台的結構如下：
   view source

   print?

   01

   <?php

   02

   /*

   03	index.php 是模組的預設首頁（入口）。

   04	若前台還有需要別的檔案，可以直接複製此檔然後改名即可。

   05

   */

   06

   07

   08	/*------------------ 檔頭（引入檔案） ------------------*/

   09

   10	//引入共同檔案設定檔及共同函數檔 function.php（必要）

   11	include "header.php";

   12

   //使用樣板檔

   13	$xoopsOption['template_main'] = "前台樣板檔.html";

   14	//引入XOOPS前台檔案檔頭（必要）

   15	include_once XOOPS_ROOT_PATH."/header.php";

   16

   17

   18

   19	/*------------------ 流程判斷（告訴程式現在要做什麼） -----------------*/

   20

   21	//$op 為XOOPS常用之動作變數，用來告知程式欲執行之動作

   22	$op=isset($_REQUEST['op'])?$_REQUEST['op']:"";

   23

   24	//判斷目前動作該執行哪一個

   25	switch($op){

   26	//當 $op 的值等於「動作1」時，欲執行的動作

   27	case "動作1":

   28	do_something();

   29

   break;

   30

   31

   //預設動作

   32

   default:

   33

   34

   break;

   35

   }

   36

   37	/*------------------ 所有函數（實際執行動作） ------------------*/

   38

   39	//當 $op 的值等於「動作1」時，欲執行的函數

   40	function do_something(){

   41

   42

   }

   43

   44

   45

   46	/*------------------ 檔尾（輸出內容到樣板） ------------------*/

   47

   48	//套用工具列的程式碼到樣板檔（toolbar_bootstrap()來自tadtools函式庫）

   49	$xoopsTpl->assign( "toolbar" , toolbar_bootstrap($interface_menu)) ;

   50	//套用 bootstrap 的引入語法到樣板檔（get_bootstrap()來自tadtools函式庫）

   51	$xoopsTpl->assign( "bootstrap" , get_bootstrap()) ;

   52	//套用 jquery 的引入語法到樣板檔（get_jquery()來自tadtools函式庫）

   53	$xoopsTpl->assign( "jquery" , get_jquery(true)) ;

   54	//將「是否為該模組管理員」的變數傳送到樣板檔（$isAdmin來自header.php檔）

   55	$xoopsTpl->assign( "isAdmin" , $isAdmin) ;

   56

   57	//引入XOOPS前台檔案檔尾（必要）

   58	include_once XOOPS_ROOT_PATH.'/footer.php';

   59

   ?>

2. 一定要引入：include_once '../../mainfile.php'; （已包含在 header.php 中）
3. 頁首：include_once XOOPS_ROOT_PATH."/header.php";
4. 頁尾：include_once XOOPS_ROOT_PATH.'/footer.php';
5. 其餘結構可比照後台頁面結構。

二、 前台主選單設定

1. 有前台時，記得到xoops_version.php去加入 $modversion['hasMain'] = 1;
2. 若前台有好幾個子功能，可以在主選單中加入子選項：
3. $modversion['sub'][1]['name'] = '子選項名稱';
4. $modversion['sub'][1]['url'] = '連結位置';

三、前台樣板檔

1. 前台樣板檔作法和後台沒兩樣，所以可以將後台樣板語法複製到前台，修改後（例如拿掉管理工具）使用。
2. 也可以把抓取資料內容的部份做成共同函數放到 function.php，如此，前後臺便可共用函數。