萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> CMS 教學

Discuz! X 後台門戶模塊模板管理圖文教程:添加、編輯、全局修改與 DIY 數據綁定

功能定位

「模塊模板」是 Discuz! X 門戶 DIY 系統的視圖層模板庫。管理員在後台預定義各類數據類型 (文章、圖片、帖子、商品等) 的顯示樣式,前台 DIY 拖拽模塊時即可選擇套用,實現「一次定義、多處復用、全局維護」。

操作入口

後台 → 門戶 → 模塊模板

添加模塊模板完整流程

步驟 1:選擇數據類型

進入列表頁點擊「添加」,首先選擇數據類型。系統根據類型自動提供對應的數據變量 (字段):

選擇數據類型界面

步驟 2:命名模板

輸入模板名稱 (如「首頁焦點圖左文字右」),建議命名規範:頁面位置_數據類型_佈局特徵,便於後期維護識別。

模板命名提示

步驟 3:編輯顯示格式代碼 (核心)

  • 編輯器左側列出所有可用變量標籤,點擊即插入光標處。
  • 編寫 HTML + 模板語法 (支援 {lang}、{eval}、{loop}、{if} 等 Discuz 模板語法)。
  • 常用結構:
<div class="module-item">
  <a href="{$item[url]}" title="{$item[subject]}" target="_blank">
    <img src="{$item[pic]}" alt="{$item[subject]}" />
    <h3>{$item[subject]}</h3>
    <p class="summary">{$item[summary]}</p>
    <span class="meta">{$item[dateline]} | 閱讀:{$item[viewnum]}</span>
  </a>
</div>

編輯模板代碼界面

步驟 4:提交保存

點擊「提交」,模板進入列表,可供前台 DIY 選用。

全局修改威力:批量更新所有引用該模板的模塊

  1. 模板列表頁勾選目標模板 (可多選)
  2. 點擊「修改」→ 調整 HTML/樣式/變量
  3. 提交 → 所有已套用此模板的 DIY 模塊即時生效,無需逐頁編輯。

這是模塊模板系統最大價值:**集中維護、一致性保證、運營效率提升**。

Tips 總結

  1. 模塊模板 = 後台定義視圖 + 前台 DIY 選用 + 數據自動綁定
  2. 數據類型決定可用變量,選對類型事半功倍
  3. 命名規範化:頁面_類型_佈局_版本 (如 index_article_focus_v2)
  4. 善用 {eval} 處理複雜邏輯 (如條件顯示、格式化日期、截取摘要)
  5. 配合 CSS 模組化 (BEM 命名) 避免樣式污染
  6. 定期清理未被引用的廢棄模板
copyright © 萬盛學電腦網 all rights reserved
數據類型典型變量適用場景
文章subject, summary, pic, url, author, dateline, viewnum, commentnum新聞資訊、幫助文檔
圖片pic, bigpic, thumb, alt, url圖片牆、產品展示
帖子subject, message, author, authorid, dateline, replies, views論壇精華導讀
商品name, price, marketprice, pic, url, sales電商推薦位
自定義自定義字段特殊業務需求