Destoon 首頁調用供求資訊地區名稱：area_pos() 函式完整用法

Destoon 供求資訊地區顯示：area_pos() 函式參數詳解與模板整合

Destoon B2B 系統中，供求資訊綁定地區 ID (areaid)，前端需顯示地區名稱（如「廣東/深圳/南山區」）。area_pos() 為官方提供的地區路徑生成函式，支援分隔符自訂、層級截取。

函式簽名與參數

/**
 * 獲取地區路徑字串
 * @param int $areaid 地區 ID
 * @param string $sep 分隔符，預設 ' > '
 * @param int $level 顯示層級：1=一級，2=二級，0=全部（預設）
 * @return string 如 "廣東/深圳/南山區"
 */
function area_pos(int $areaid, string $sep = ' > ', int $level = 0): string

模板整合範例

{loop $tags $k $t}
    

        
        [{area_pos($t[areaid], '/', 0)}]
        {$t[title]}
    
{/loop}


{loop $tags $k $t}
    [{area_pos($t[areaid], '/', 1)}]
{/loop}


{loop $tags $k $t}
    [{area_pos($t[areaid], '/', 2)}]
{/loop}

參數組合效果對照表

進階：自定義地區顏色/連結

{php $areas = explode('/', area_pos($t[areaid], '/', 0));}
{loop $areas $i $area}
    {$area}
    {if $i < count($areas)-1} / {/if}
{/loop}

常見問題

• 輸出為空： 檢查 $t[areaid] 是否正確寫入、地區快取是否更新（後台「工具」→「更新緩存」→「地區緩存」）
• 層級錯誤： 確認後台「地區管理」中層級關係正確（父子關係）
• 分隔符 HTML 編碼： 若分隔符含特殊字元，使用 htmlspecialchars() 或模板引擎自動轉義

相關函式速查

• get_area($areaid)：取得單個地區陣列 (areaid, areaname, parentid, level)
• get_child($parentid, $table)：取得子地區列表
• area_select()：生成地區下拉選單 HTML