線上書籍

Home

1041 XOOPS模組開發

一、 smarty樣板
  1. 樣板(template)是使用者眼睛看到的界面,我們經由程式產生的任何結果,都可以傳送至樣板以便呈現在畫面上。
  2. 樣板檔=html檔+smarty樣板標籤,樣板標籤看起來像這樣:<{$樣板標籤}>
  3. XOOPS透過$xoopsTpl物件,來將PHP產生的值套用到樣板中(即樣板標籤):
  4. $xoopsTpl->assign('樣板標籤' , $值);
  5. 若是在函數中要使用$xoopsTpl樣板物件,記得用global $xoopsTpl,才能使用。
  6. 若要在樣板中直接使用語系,請用:
  7. <{$smarty.const._語系名稱}>
二、 smarty迴圈:製作樣板標籤二維陣列變數
  1. 樣板標籤除了一次傳一個值外,也可以傳陣列,方法一模一樣,但陣列格式必須像這樣:
    資料庫 二維陣列格式 實際範例
    第一筆資料 $陣列名稱[0]['索引名稱1']
    $陣列名稱[0]['索引名稱2']
    $陣列名稱[0]['索引名稱3']
    $list_ebook[0]['ebook_sn']=1;
    $list_ebook[0]['ebook_title']="第一期 創刊號";
    $list_ebook[0]['ebook_post_date']="2015-04-15";
    第二筆資料 $陣列名稱[1]['索引名稱1']
    $陣列名稱[1]['索引名稱2']
    $陣列名稱[1]['索引名稱3']
    $list_ebook[1]['ebook_sn']=2;
    $list_ebook[1]['ebook_title']="第二期 會考特輯";
    $list_ebook[1]['ebook_post_date']="2015-05-15";
  2. 利用 $ebook = $xoopsDB->fetchArray($result); 剛好可以取得一維陣列,即:
    $ebook['ebook_sn']=1;
    $ebook['ebook_title']="第一期 創刊號";
    $ebook['ebook_post_date']="2015-04-15";
    該筆資料的「ebook_sn」欄位值
    該筆資料的「ebook_title」欄位值
    該筆資料的「ebook_post_date」值
  3. 也就是說,在while迴圈中,再給予一個數字索引即可完成所需的二維陣列 //用$i做第一個索引,這裡先設初始值 $i=0; //設定二維陣列變數的初始值 $list_ebook=""; //用迴圈一筆一筆抓出資料庫的數據 while($ebook = $xoopsDB->fetchArray($result)){ //將抓出的數據陣列,放到一維陣列中 $list_ebook[$i]=$ebook; //索引值+1 $i++; } //將此陣列套用到樣板標籤 list_ebook $xoopsTpl->assign('list_ebook' , $list_ebook);
三、 smarty迴圈:套用二維陣列變數的樣板標籤
  1. 做好二維陣列並套用到樣板後,可以利用<{foreach}>的方式來一筆一筆讀出陣列值:
    <{foreach from=$list_ebook item=ebook}>
      <tr>
        <td><{$ebook.ebook_sn}></td>
        <td><{$ebook.ebook_title}></td>
        <td><{$ebook.ebook_post_date}></td>
        <td><{$ebook.ebook_publish_date}></td>
      </tr>
    <{/foreach}>
    從$list_ebook擷取一筆資料,並塞入ebook樣板標籤中
    建立一列表格
    秀出期刊編號
    秀出期刊標題
    秀出投稿截止日
    秀出發行日
    一列結束
    迴圈結束
  2. from就是來自PHP的二維陣列變數
  3. item就是設定樣板標籤名稱,以便將該變數取出陣列值後,塞進此樣板標籤
  4. 樣板標籤若是陣列,其表示方式為:<{$樣板標籤.索引名稱}>
四、 BootStrap表格
  1. 在表格標籤加入 class="table table-striped table-bordered table-hover"
  2. table-striped 會出現斑馬紋,較容易辨識
  3. table-bordered 會加入表格框線
  4. table-hover 移過去該列會變色,較醒目
五、 在樣板檔中加入刪除的功能連結
  1. 利用 get 的傳遞方式可過連結來傳遞各種參數,格式為: <a href="檔案.php?參數1=值1&參數2=值2&參數3=值3">連結名稱</a>
  2. 流程控制是利用$op,所以需傳遞一個op變數,以便告訴程式接下來要執行什麼動作。
  3. 此外,還要傳遞流水號,如此,才能知道要刪除哪一筆資料(編號請用樣板標籤): <a href="main.php?op=delete_ebook&ebook_sn=編號">刪除</a>
六、 在php檔的流程控制中加入刪除
  1. 一旦有設定一組op的動作(如op=delete_ebook),接收端(main.php)就必須在流程控制的switch中加入一組 case "delete_ebook": 的對應動作。 //若$op=del_ebook時 case "del_ebook": //執行del_ebook()函數以刪除資料 del_ebook($ebook_sn); //刪除後轉向回自己這頁 header("location:{$_SERVER['PHP_SELF']}"); //停止程式 exit; //跳出流程(基本上執行不到...) break;
  2. 由於del_ebook()需要傳入期刊編號$ebook_sn,此編號用get方式傳來,但未來易可能從post方式傳來,故在流程控制之前,可先產生$ebook_sn的初始值: $ebook_sn=empty($_REQUEST['ebook_sn'])?"":intval($_REQUEST['ebook_sn']);
  3. 這是三元一次式的寫法:(條件)?真:假;
  4. intval()用來強制數字化,用$_REQUEST則可接收來自get、post、cookie的變數。
七、 刪除資料庫資料
  1. 在資料庫中要刪除資料的SQL語法: delete from 資料表where 條件
  2. 執行刪除或更新等動作時,需用 $xoopsDB->queryF($sql) 來強制執行 SQL 語法。
八、 加入確認後刪除
  1. 先修改原先的刪除連結,改為執行javascript函數 <a href="javascript:del_ebook_func(編號)" class="btn btn-mini btn-danger">刪除</a>
  2. 在樣板中,加入以下javascript函數語法(需在執行之前)
    <script>
    function del_ebook_func(sn){
     var sure = window.confirm('確定要刪除此資料?');
     if (!sure) return;
     location.href="main.php?op=del_ebook&ebook_sn=" + sn;
    }
    </script>
    script起始標籤
    定義del_ebook_func(ebook_sn)函數
    使用確認框,將使用者的選擇存入sure變數
    假如按「否」,則跳出函數,不執行刪除
    跳轉頁面至main.php,並帶參數,+是連接符,連接sn參數

    script結束標籤
九、 加入修改功能
  1. 和加入刪除的動作差不多,但op值可改為edit_ebook,一樣要傳遞流水號。
  2. 新增一組edit_ebook流程,直接呼叫原有的表單函數ebook_form($ebook_sn),並傳入流水號,以便修改之。換言之,有傳入流水號即修改,沒傳入流水號即新增。
  3. 在ebook_form()函數加入一組$ebook_sn參數。
  4. 修改時,需讀出原有資料,並將之設為表單元件預設值。
  5. 記得將$xoopsDB物件設為global,以便在函數中使用。 // 假如有流水號(更新模式) if($ebook_sn){ // 先加入資料表前置字串 $tbl=$xoopsDB->prefix('ebook'); // 讀取指定流水號的所有資料 $sql="select * from $tbl where $ebook_sn='$ebook_sn'"; // 送出執行,執行失敗則停止,並秀出原因 $result=$xoopsDB->query($sql) or die(mysql_error()); // 利用list()將得到的一筆結果,四個欄位值,分別塞入四個指定變數中。 list($ebook_sn,$ebook_title,$ebook_post_date,$ebook_publish_date) = $xoopsDB->fetchRow($result); // 設定$op值為 update_ebook $op="update_ebook"; // 將投稿截止日的日期轉為時間戳記 $ebook_post_date=strtotime($ebook_post_date); // 將發行日的日期轉為時間戳記 $ebook_publish_date=strtotime($ebook_publish_date); // 若沒有傳入流水號(新增模式) }else{ // 標題和編號初始值均為空值 $ebook_title=$ebook_sn=""; // 投稿截止日設為現在時間 $ebook_post_date=time(); // 發行日設為現在時間 $ebook_publish_date=time(); // 設定$op值為insert_ebook $op="insert_ebook"; }
  6. op的值記得改為變數,變根據不同情形,使用不同op。另加入ebook_sn的隱藏欄位,以便將流水號帶給下一個動作。 $form->addElement(new XoopsFormHidden('ebook_sn', $ebook_sn)); $form->addElement(new XoopsFormHidden('op', $op));
十、 編輯時無須秀出列表
  1. 修改樣板檔,在列出所有期刊列表的語法前後,利用<{if $list_ebook}><{/if}>將之包起來,如此,只有在有傳入$list_ebook二維陣列時,才會出現列表。
  2. 編輯時,並不會產生$list_ebook陣列,故列表剛好可以隱藏,無須出現。
十一、 更新資料庫資料
  1. 在流程新增一組update_ebook的流程,並建立update_ebook函數
  2. 在資料庫中要更新資料的SQL語法: update 資料表 set 欄位1='值1' , 欄位2='值2' , … where 條件
十二、 BootStrap按鈕
  1. 在<a>或<button>標籤中,加入 class="btn" 可使用bootstrap的按鈕風格
  2. btn-mini 可以讓按鈕縮小,另有btn-small或btn-large
  3. btn-primary 藍色按鈕,用在主功能按鈕,例如「送出」、「儲存」、「查詢」
  4. btn-warbing 黃色按鈕,有警告意味,例如「修改」
  5. btn-danger 紅色按鈕,較重要或危險之動作,例如「刪除」
  6. 另有btn-success 綠色按鈕及btn-info淺藍色按鈕可套用。