萬盛學電腦網

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

PHPCMS 推薦位調用自定義字段完整解決方案:模型配置、模板標籤與快取更新

問題現象

在 PHPCMS 模板中使用 {pc:content action="position" posid="30" ...} 調用推薦位內容時,自定義字段(如 kk_date)顯示空白,僅標準字段(title、url、thumb 等)正常輸出。

根因分析

PHPCMS 推薦位標籤為了效能,預設僅查詢標準欄位(v9_content 表核心欄位)。自定義字段儲存在模型對應的擴展表(如 v9_news_data),需在模型字段設定中啟用「推薦位調用」選項,系統才會在查詢時 JOIN 擴展表。

完整解決步驟

步驟 1:後台模型字段設定(關鍵)

  1. 登入 PHPCMS 後台 → 內容 → 內容相關設定 → 模型管理
  2. 找到目標模型(如「新聞模型」)→ 點擊 字段管理
  3. 找到需調用的自定義字段(如 kk_date)→ 點擊 修改
  4. 向下找到 「在推薦位標籤中調用」 選項 → 選擇 是
  5. 點擊 確定保存

步驟 2:更新相關內容(觸發快取重建)

  1. 前往 內容 → 相關模型(如新聞) → 管理內容
  2. 找到需顯示的文章 → 點擊 修改 → 不需更改內容,直接點擊 提交/保存
  3. 此步驟會重新生成該內容的推薦位快取資料,包含剛啟用的自定義字段

步驟 3:更新全站快取

  1. 後台頂部導航 → 更新快取 → 更新全部快取
  2. 或手動刪除 caches/caches_model/、caches/caches_data/ 下相關快取檔

步驟 4:模板標籤正確寫法

<!-- 正確範例 -->
{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}

深度原理:PHPCMS 推薦位查詢邏輯

<?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 參數不生效快取未清、或推薦位資料本身不足更新快取、檢查推薦位內容管理是否有足夠資料

進階技巧:手寫 SQL 替代標籤(完全可控)

<?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 片段。

copyright © 萬盛學電腦網 all rights reserved