分類列表看得到影片，選了年份或地區卻變成零筆，先別重新匯入片庫。要核對的是三份值：影片實際保存的欄位、選單送出的條件，以及結果頁保留的條件。同一個地區看起來意思相同，送出文字不一致時，查詢未必會替你自動換成同義詞。
先挑一筆已知能出現的影片
在自己有權管理的片庫中，選一筆已啟用、可公開看到的影片，記下影片 ID、所屬分類、年份與地區。先打開不帶額外篩選的列表，確認結果區確實有這一筆；頁首的熱門或推薦海報不能代替結果區。
影片欄位中，type_id 是分類 ID，vod_year 是年份文字，vod_area 是地區文字。片名裡含有「2026」不等於年份欄位已保存 2026；簡介寫「香港故事」，也不等於地區欄位是香港。先到該筆內容的編輯頁查看欄位，避免拿畫面上的其他文字當查詢依據。
MacCMS Club 的影片篩選頁文件說明，標準模板位置是 html/vod/show.html，獨立模板設定可能另選檔案。篩選頁的當前分類物件與一筆影片不是同一物件；要看影片欄位，應在影片列表迴圈核對當前項目，不能把分類欄位誤當影片年份。
一次只加一個條件
保持分類不變，先選年份，回到無年份條件，再單獨選地區。每次記下網址、被選中的選項，以及那筆已知影片是否仍在結果區。若單獨年份可找到、單獨地區也可找到，兩者一起卻沒有，才核對這筆影片是否真的同時符合兩個值。
篩選條件通常會縮小可見範圍，不是在不同條件之間輪流挑一個成立。你要找的影片是 2025 年台灣作品，卻選了 2026 年香港時，沒有結果可能是合理的。先驗證一組你確定應命中的條件，再判斷介面或查詢是否有問題。
從第 2 頁開始篩選時，也要看有沒有回到該條件的第一頁。原本片庫很多頁，新條件只剩少量結果，仍停在較後頁就可能看見空列表。核對目前頁碼與結果總數，不要因為這一頁空白就改動影片資料。
選項名稱與送出值要一起看
在電腦瀏覽器開啟開發者工具，選取地區選單，查看 option 的文字與 value；送出後，再看網址或 Network 裡的請求條件。例如畫面顯示「台灣」，value 卻是「台湾」，兩者字形不同，應回查這個網站實際保存及接受哪一種值。
MacCMS Club 的影片標籤文件要求 area 使用後台保存的地區文字，year 使用年份值；class 則是影片的擴展分類文字。這三種條件不可互相替代，也不要把其他模型的欄位名稱直接搬到影片篩選中。
「全部」也需要核對。它應依網站既有實作移除該條件，而不是必然把「全部」兩個字送進地區比對。從空值切到某地區、再切回全部時，觀察條件是否真的清除；若網址仍保留上一個地區，維護者應先查表單組合與條件保留。
用可見資料與選單差異找線索
在一份使用虛構影片資料的片庫示例中，無地區限制的列表卡片可見「2025 · 台灣 · 紀錄」。保持同一分類，地區選「香港」後顯示 8 部作品；選單的「台湾」送出後，則顯示 0 部。這讓我們有理由核對繁簡文字及條件來源，但僅憑卡片文字與空列表，仍不能斷定資料庫內是哪種寫法。
同一份示例的卡片也有 2026 年作品，年份選單卻只列 2021 至 2000。資料能出現在列表，不代表選單已跟著更新；選單可能來自模板、分類設定或其他配置。這時應請維護者查產生選項的位置，而不是先把影片年份改成選單裡已存在的舊年份。
核自己網站時，保留這三欄對照：編輯頁保存值、表單送出值、結果頁採用值。前兩項不同，先修選項或統一資料規則；前兩項相同但結果條件不同，再查網址生成及查詢。若三者一致，才繼續看是否還有分類、資料狀態或存取限制排除了它。
不要把排序當成新增篩選條件
最新、熱門與評分通常改變排列方式，不會替一筆影片補上年份或地區。把排序改為最新後仍找不到影片，不能據此判定年份失效；先保留相同篩選範圍，再比較排序。結果只載入第一頁時，一筆較舊影片也可能不在第一屏，要一併看分頁。
分類範圍則是另一項條件。若「全部」分類與某個子分類的結果不同，核對影片所屬分類及模板的查詢範圍，不把分類顯示名稱裡的數字當實際 ID。相關問題可接著閱讀分類結果與分類 ID 的核對方式。
找到差異後，只修那個入口
先保留原模板、選單設定，以及那筆內容的原始欄位值，在可回復的副本調整一處。若原因是選單值錯誤，就先改該選項；若要統一歷史資料的地區名稱，先列出受影響筆數與引用範圍，別直接全庫替換繁簡字。
修正後，用同一筆影片重走「無條件、單一年份、單一地區、組合條件、返回全部」，並核對網址與畫面選中值一致。再試一組確實沒有匹配資料的條件，確認零結果提示仍正常，不能為了讓畫面有圖就把篩選全部忽略。
提供給維護者的資料包含影片 ID、分類、欄位保存值、完整篩選網址及可重現步驟即可。畫面有結果，還要確認每筆結果符合條件；不要拿推薦區海報或調整後一次有圖，代替整個篩選流程。
評論0