在 PHPCMS 模板中使用 {pc:content action="position" posid="30" ...} 調用推薦位內容時,自定義字段(如 kk_date)顯示空白,僅標準字段(title、url、thumb 等)正常輸出。
PHPCMS 推薦位標籤為了效能,預設僅查詢標準欄位(v9_content 表核心欄位)。自定義字段儲存在模型對應的擴展表(如 v9_news_data),需在模型字段設定中啟用「推薦位調用」選項,系統才會在查詢時 JOIN 擴展表。
kk_date)→ 點擊 修改caches/caches_model/、caches/caches_data/ 下相關快取檔<!-- 正確範例 -->
{pc:content action="position" posid="30" catid="24" order="listorder DESC" num="4"}
{loop $data $n $r}
<div class="item">
<h3><a href="{$r[url]}" target="_blank">{$r[title]}</a></h3>
<span class="date">{$r[kk_date]}</span> <!-- 自定義字段 -->
<img src="{$r[thumb]}" alt="{$r[title]}">
</div>
{/loop}
{/pc}
<?php
// 簡化版:phpcms/modules/content/classes/position_tag.class.php
public function position($data) {
$posid = $data['posid'];
$catid = $data['catid'] ?? 0;
$num = $data['num'] ?? 10;
// 1. 取得推薦位配置的模型
$position = $this->db->get_one(['posid' => $posid]);
$modelid = $position['modelid'];
// 2. 取得該模型「允許推薦位調用」的字段
$fields = $this->get_model_fields($modelid, true); // true = 只取啟用推薦位調用的字段
// 3. 建構 SELECT 欄位:核心欄位 + 自定義欄位
$selectFields = array_merge(['id', 'catid', 'title', 'url', 'thumb', 'inputtime', ...], $fields);
// 4. 查詢:主表 v9_content + 擴展表 v9_{model}_data
$sql = "SELECT " . implode(',', $selectFields) . "
FROM `v9_content` c
LEFT JOIN `v9_{$model}_data` d ON c.id = d.id
WHERE c.posid = $posid AND c.status = 99
ORDER BY c.listorder DESC
LIMIT $num";
// ...
}
| 現象 | 原因 | 解決 |
|---|---|---|
| 字段已啟用推薦位調用,仍顯示空 | 內容未重新保存,快取未更新 | 步驟 2、3 必須執行:修改保存文章 + 更新全站快取 |
| 字段名稱大小寫不匹配 | 資料庫欄位小寫,模板用大寫 | 模板中統一用小寫:{$r[kk_date]},非 {$r[KK_DATE]} |
| 多模型推薦位混用 | posid 關聯單一 modelid,跨模型字段不會查詢 | 建立多個推薦位分別對應不同模型,或用 {pc:get} 手寫 SQL |
| 字段類型為編輯器/圖片組 | 儲存格式特殊(陣列/JSON),直接輸出為 Array | 模板中用 {$r[field][key]} 或 PHP 區塊處理 |
| 數量 num 參數不生效 | 快取未清、或推薦位資料本身不足 | 更新快取、檢查推薦位內容管理是否有足夠資料 |
<?php
// 模板中嵌入 PHP(需開啟模板 PHP 功能,不推薦長期使用)
$posid = 30;
$catid = 24;
$num = 4;
$r = $this->db->query("
SELECT c.*, d.kk_date, d.custom_field2
FROM `v9_content` c
LEFT JOIN `v9_news_data` d ON c.id = d.id
WHERE c.posid = $posid AND c.catid = $catid AND c.status = 99
ORDER BY c.listorder DESC
LIMIT $num
");
while ($row = $r->fetch_assoc()) {
echo '<div>' . $row['title'] . ' - ' . $row['kk_date'] . '</div>';
}
優點: 完全控制查詢、跨模型 JOIN、複雜條件。缺點: 繞過快取機制、模板混入 SQL、維護困難。建議僅作臨時方案或特殊報表。
PHPCMS 推薦位調用自定義字段的核心在於模型字段設定「在推薦位標籤中調用」= 是,配合內容重新保存與全站快取更新三步驟。理解底層 JOIN 查詢機制,能快速定位問題。長期專案建議將常用推薦位封裝為專用模板標籤類別,集中管理查詢邏輯、快取策略與字段白名單,避免模板散落 SQL 片段。