PHPCMS V9 模板變數分類速查
在進行 PHPCMS V9 模板開發時，熟悉核心全域變數與常用標籤能大幅提升開發效率。本文整理實務上最常用的變數與標籤，供開發者快速查閱。
站點基礎配置變數
| 變數/標籤 | 說明 |
|---|
{CHARSET} | 網站字符集（如 UTF-8） |
$SEO['title'] | 當前頁面標題 |
$SEO['site_title'] | 網站整體標題 |
$SEO['keyword'] | 頁面關鍵字 |
{$SEO['description']} | 頁面描述 |
{CSS_PATH} | CSS 檔案路徑 |
{JS_PATH} | JavaScript 檔案路徑 |
{IMG_PATH} | 圖片資源路徑 |
{APP_PATH} | 應用程式路徑 |
站點與欄目識別變數
| 變數 | 說明 |
|---|
{get_siteid()} | 取得當前站點 ID |
{$siteid} | 當前站點 ID（變數形式） |
{siteurl($siteid)} | 取得站點完整 URL |
{$catid} | 當前欄目 ID |
{$pages} | 分頁 HTML 代碼 |
內容頁常用函數標籤
| 標籤 | 功能 |
|---|
{date('Y-m-d H:i:s',$r[inputtime])} | 格式化顯示發布/更新時間 |
{str_cut($v[description],116,'..')} | 截取描述文字，超出以 .. 結尾 |
{thumb($v[thumb],70,60)} | 生成縮略圖（寬 70、高 60） |
{$CATEGORYS[$cid][catname]} | 取得指定欄目名稱 |
{$CATEGORYS[$cid][url]} | 取得指定欄目連結 |
模板引入與區塊調用
{template "content","footer"} <!-- 引入模板檔 -->
{pc:block pos="index_block_1"} <!-- 區塊調用 -->
action: lists列表、position推薦位、category子欄目、relation相關文章、hits排行榜
posid: 推薦位 ID（如 1=首頁焦點圖、2=首頁頭條...）
thumb: 0=所有文章、1=僅含縮略圖
order: 排序方式（listorder DESC/ASC、id DESC、updatetime DESC）
{/pc}
常用 PC 標籤實例
<!-- 推薦位調用：首頁焦點圖 -->
{pc:content action="position" posid="1" order="listorder DESC" thumb="1" num="5"}
<!-- 列表調用：當前欄目最新 1 條含圖文章 -->
{pc:content action="lists" catid="$r[catid]" num="1" thumb="1" order="id DESC" return="info"}
<!-- 點擊排行：月排行 -->
{pc:content action="hits" catid="$catid" num="8" order="monthviews DESC" cache="3600"}
<!-- 友情連結 -->
{pc:link action="type_list" siteid="$siteid" linktype="1" order="listorder DESC" num="8" return="pic_link"}
欄目導航與循環
{catpos($catid)} <!-- 欄目定位麵包屑 -->
{loop subcat(0,0,0,$siteid) $r} <!-- 遞迴循環所有子欄目 -->
{title_style($r[style])} {$r[catname]}
{/loop}
開發小撇步
- 善用
return="info" 將查詢結果賦值給變數，配合 {loop $info $v} 循環輸出，邏輯更清晰
- 所有
{pc:...} 標籤結尾務必加 {/pc} 閉合
- 調試時可直接
{var_dump($variable)} 查看變數結構
