地區（region）／語系（locale）判斷規則全圖

flowchart TD
    subgraph R["resolve_current_region()　iTemplateRenderer.php:181-207"]
        R0{"static cache
已有值？"} -->|是| RH["直接回傳"]
        R0 -->|否| R1{"$_GET['region']
在白名單？"}
        R1 -->|是| RW["write_region_cookie()
種 30 天 cookie"] --> RC["回傳"]
        R1 -->|否 / 不存在| R2{"$_COOKIE
inwin_region
在白名單？"}
        R2 -->|是| RC
        R2 -->|否| R3["fallback 'main'"] --> RC
    end

    subgraph L["resolve_current_locale()　iTemplateRenderer.php:310-324"]
        L0{"function static
cache 已有值？"} -->|是| LH["直接回傳"]
        L0 -->|否| L1["apply_filters
('wpml_current_language')"]
        L1 -->|null| L2["'en'"] --> LC["回傳"]
        L1 -->|有值| L3{"在 locale_mapping
對照表？"}
        L3 -->|是| L4["內部 4 字母碼
zh-hant → hant"] --> LC
        L3 -->|否| L5["⚠️ 原值穿透
pt-pt → 'pt-pt'"] --> LC
    end

    style RW fill:#fff3cd,stroke:#9a6700
    style L5 fill:#fdf0f0,stroke:#8b1d1d
    style R3 fill:#eef,stroke:#556
    style L2 fill:#eef,stroke:#556

圖 1 — 兩條解析鏈。唯一會產生副作用（種 cookie）的是 region 的第一步。

flowchart LR
    subgraph A["(A) 商品基本欄位　ProductFieldResolver"]
        direction TB
        A1["地區軸
_product_{field}_{region}"] -->|非空即回| AR(["回傳"])
        A2["語系軸
_product_{field}_{locale}"] -->|非空即回| AR
        A3["基準
原生欄位 post_title 等"] --> AR
        A1 -.->|空| A2 -.->|空| A3
        AX["❌ 沒有交叉座標
region+locale 不存在"]
    end

    subgraph B["(B) iTemplate 樣板　iTemplateVariantKeys"]
        direction TB
        B0["基準
itemplate_*_main_en"] --> BM["array_merge
後套者覆蓋"]
        B1["語系軸 main_{locale}"] --> BM
        B2["地區軸 {region}_en"] --> BM
        B3["交叉 {region}_{locale}
key space 保留
目前無 UI 寫入"] --> BM
        BM --> BR(["合併結果"])
    end

    style AX fill:#fdf0f0,stroke:#8b1d1d
    style B3 fill:#f2f3f5,stroke:#999,stroke-dasharray: 4 3

圖 2 — 兩套座標系統。左邊「先返回者贏」，右邊「後套者覆蓋」，但兩者的淨效果都是地區蓋語系。

flowchart TD
    Q["前台請求"] --> BP{"should_bypass()？
cron / WP-CLI / 後台非 AJAX
/ REST / Elementor 預覽
/ VisualEditor"}
    BP -->|是| SKIP["整組跳過"]
    BP -->|否| SC{"場景"}

    SC -->|單一商品頁| H1["template_redirect (pri 1)
get_post_meta → 判定"]
    SC -->|archive / tax / search| H2["pre_get_posts (pri 10)
需 is_main_query()"]
    SC -->|related / upsell
cross-sell / compare| H3["四個 WC filter
已有 id 清單"]

    H1 --> J
    H3 --> J

    H2 --> CAND["get_hidden_product_ids()
meta_query 三條 LIKE
＝候選過濾"]
    CAND --> FETCH["fetch_hidden_meta_for_ids()
先問 get_post_metadata filter
回 null 才查 DB"]
    FETCH --> J{"is_hidden_by_meta()
唯一判定"}

    J -->|命中 region 或 locale
或舊格式降維| HIDE["隱藏"]
    J -->|否| SHOW["顯示"]

    HIDE -.->|單頁| R404["set_404()"]
    HIDE -.->|清單| RNOT["併入 post__not_in"]

    style BP fill:#fff3cd,stroke:#9a6700
    style J fill:#eaf6ed,stroke:#1a7f37
    style CAND fill:#f2f3f5,stroke:#999

圖 3 — 三條讀取路徑結構性共用同一個判定函式；SQL 只負責縮小候選集，不做判定。

flowchart LR
    subgraph BE["at-inwin-plugin（後端）"]
        HOOKS["hook 層
pre_get_posts / template_redirect
get_terms_args / WC filters"]
    end

    subgraph FE["atelement-widgets（前端 · Lilith）"]
        RAW1["query_child_terms_en_raw()
raw SQL"]
        RAW2["get_en_term_raw()
raw SQL"]
        RAW3["get_ipc_products_by_subcat()
raw SQL"]
        TM["get_term_meta()
✅ 仍走 WP API"]
    end

    HOOKS -.->|❌ 攔不到| RAW1
    HOOKS -.->|❌ 攔不到| RAW2
    HOOKS -.->|❌ 攔不到| RAW3
    HOOKS ==>|✅ 唯一接觸點| TM

    RAW1 --> MENU["站台 Header megamenu
全站每頁"]
    RAW2 --> MENU
    RAW3 --> MENU
    TM --> MENU

    style RAW1 fill:#fdf0f0,stroke:#8b1d1d
    style RAW2 fill:#fdf0f0,stroke:#8b1d1d
    style RAW3 fill:#fdf0f0,stroke:#8b1d1d
    style TM fill:#eaf6ed,stroke:#1a7f37

圖 4 — 前端的四個資料接觸點，只有 get_term_meta() 那一條攔得到。