標籤語法
[ecmsinfo]欄目ID/專題ID, 顯示條數, 標題截取數, 是否顯示欄目名, 操作類型, 模板ID, 只顯示有標題圖片[/ecmsinfo]
參數詳細說明
| 順序 | 參數 | 說明 | 範例 |
| 1 | 欄目ID/專題ID | 0=所有一級;selfinfo=當前欄目下級;多個用逗號分隔;SQL 查詢模式下填 SQL 語句 | 2, 1,3,5, selfinfo |
| 2 | 顯示條數 | 前幾條記錄 | 10 |
| 3 | 標題截取數 | 截取標題字元數 (0=不截取) | 30 |
| 4 | 是否顯示欄目名 | 0=否,1=是 | 1 |
| 5 | 操作類型 | 決定查詢邏輯,見下表 | 0 |
| 6 | 標籤模板ID | 後台建立的標籤模板 ID | 5 |
| 7 | 只顯示有標題圖片 | 0=不限制,1=只顯示有圖 | 0 |
操作類型完整對照表
| 類型 | 說明 | 類型 | 說明 |
| 0 | 各欄目最新 | 3 | 所有信息最新 (預設表) |
| 1 | 各欄目熱門 | 4 | 所有信息熱門 (預設表) |
| 2 | 各欄目推薦 | 5 | 所有信息推薦 (預設表) |
| 9 | 各欄目評論排行 | 10 | 所有信息評論排行 (預設表) |
| 12 | 各欄目頭條 | 13 | 所有信息頭條 (預設表) |
| 15 | 各欄目下載排行 | 16 | 所有信息下載排行 (預設表) |
| 25 | 各欄目評分排行 | 27 | 所有信息評分排行 (預設表) |
| 26 | 各欄目投票排行 | 28 | 所有信息投票排行 (預設表) |
| 6 | 專題最新信息 | 18 | 各表最新 (欄目ID=表名) |
| 7 | 專題熱門信息 | 19 | 各表熱門 (欄目ID=表名) |
| 8 | 專題推薦信息 | 20 | 各表推薦 (欄目ID=表名) |
| 11 | 專題評論排行 | 21 | 各表評論排行 (欄目ID=表名) |
| 14 | 專題頭條 | 22 | 各表頭條 (欄目ID=表名) |
| 17 | 專題下載排行 | 23 | 各表下載排行 (欄目ID=表名) |
| 29 | 專題評分排行 | 31 | 各表評分排行 (欄目ID=表名) |
| 30 | 專題投票排行 | 32 | 各表投票排行 (欄目ID=表名) |
| 24 | 按 SQL 查詢 (欄目ID=SQL語句) | - | 資料表前綴用 [!db.pre!] |
實戰範例解析
[ecmsinfo]2, 3, 14, 1, 0, 5, 1[/ecmsinfo]
- 欄目 ID = 2
- 顯示 3 條
- 標題截取 14 字元
- 顯示欄目名 = 是
- 操作類型 = 0 (各欄目最新)
- 模板 ID = 5
- 只顯示有標題圖片 = 是
SQL 查詢模式進階用法 (類型 24)
[ecmsinfo]
SELECT id, title, titlepic, newstime
FROM [!db.pre!]ecms_news
WHERE checked=1 AND isgood=1
ORDER BY newstime DESC LIMIT 10
, 10, 30, 0, 24, 8, 0
[/ecmsinfo]
- 欄目ID 位置填完整 SQL (自動替換
[!db.pre!])
- 操作類型 = 24
- 模板 ID = 8
模板變數參考
標籤模板 (列表外層)
[!--bclassname--] 父欄目名
[!--bclassurl--] 父欄目連結
[!--bclassid--] 父欄目 ID
[!--bclassimg--] 父欄目圖片
[!--bintro--] 父欄目簡介
[!--bnum--] 父欄目信息數
[!--bno--] 父欄目序號
list.var 模板 (單條記錄)
[!--classurl--] 欄目連結
[!--classname--] 欄目名稱
[!--classid--] 欄目 ID
[!--classimg--] 欄目圖片
[!--intro--] 簡介
[!--num--] 信息數
[!--no--] 序號
[!--title--] 標題
[!--titleurl--] 標題連結
[!--titlepic--] 標題圖片
[!--newstime--] 發布時間
[!--smalltext--] 簡介欄位
常見問題排查
| 現象 | 可能原因 | 解決 |
| 無輸出 | 模板 ID 不存在/未啟用 | 檢查後台模板管理 |
| 欄目不顯示 | 欄目權限/審核狀態 | 檢查欄目設定、信息審核 |
| 圖片不顯示 | 第 7 參數設為 1 但無圖 | 設為 0 或確保有標題圖片 |
| SQL 模式報錯 | 表名/欄位名錯誤 | 用 [!db.pre!]、檢查欄位拼寫 |
| 分頁失效 | 標籤不支援分頁 | 改用列表模板或動態頁面 |
效能優化建議
- 避免在高流量頁面使用複雜 SQL 查詢 (類型 24)
- 合理設定顯示條數,避免單次查詢過大結果集
- 開啟帝國 CMS 緩存機制,減少資料庫查詢
- 大數據量場景考慮靜態化生成