PHPCMS:PC標(biāo)簽使用說明
在PHPCMS V9中我們正式開始需要PC標(biāo)簽做為數(shù)據(jù)的獲取的方式。
PC標(biāo)簽是以下面的方式進(jìn)行聲明
{pc:content action="lists" cache="3600" num="20" page="$page"}{/pc}
PC標(biāo)簽必須以{pc}開頭,并以{/pc}結(jié)尾的代碼片段。
當(dāng)然不以{/pc}結(jié)尾并不會(huì)引起程序致命性的錯(cuò)誤,導(dǎo)致程序無法繼續(xù)運(yùn)行。
以下為兩種已知可能會(huì)出現(xiàn)的問題:
- 當(dāng)網(wǎng)頁中出現(xiàn)兩個(gè)PC標(biāo)簽時(shí),可能會(huì)使得沒有閉合的PC標(biāo)簽之后的PC標(biāo)簽數(shù)據(jù)和其混亂。
- 在后臺(tái)可視化編輯時(shí),可能出現(xiàn)網(wǎng)頁結(jié)構(gòu)錯(cuò)亂的問題。
PC標(biāo)簽分析:
PC標(biāo)簽中{pc:}冒號(hào)之后跟隨的為模塊名。如上面的例子中調(diào)用的是內(nèi)容模型的PC標(biāo)簽。
action="list"
這個(gè)形式所代表的是參數(shù)。每一個(gè)PHPCMS V9模型都為其PC標(biāo)簽定義了調(diào)用的參數(shù)。其中有一些調(diào)用參數(shù)是系統(tǒng)保留的參數(shù),其對(duì)所有的PC標(biāo)簽都是有效的。
參數(shù)必須使用
參數(shù)名="參數(shù)值"
的方式填寫,多個(gè)參數(shù)之間使用空格分開(如下例),參數(shù)值可使用雙引號(hào)來包括,無論是什么形式的引號(hào)都必須是成對(duì)出現(xiàn)的。
{pc:content 參數(shù)名="參數(shù)值" 參數(shù)名="參數(shù)值" 參數(shù)名="參數(shù)值"}
請(qǐng)查看PC標(biāo)簽保留參數(shù)相關(guān)章節(jié),以了解具體保留參數(shù)及其用途。
PC標(biāo)簽分類:
PC標(biāo)簽包含兩個(gè)類別,分別為:
- 工具類
- 模塊類
工具類,大體上可以理解為PHPCMS V9所提供的一些工具箱。請(qǐng)查看PC標(biāo)簽工具箱相關(guān)章節(jié),以了解更多關(guān)于工具類的PC標(biāo)簽的更多信息。
而模塊類,是PHPCMS V9各個(gè)模型提供給大家調(diào)用模塊數(shù)據(jù)的數(shù)據(jù)接口。查看具體模塊的相關(guān)說明章節(jié),以了解更多關(guān)于模塊類的PC標(biāo)簽的更多信息。
如何顯示PC標(biāo)簽中的數(shù)據(jù):
默認(rèn)情況下PC標(biāo)簽中的數(shù)據(jù)都是數(shù)組方式返回的,你都可以通過 $data 來獲取到這個(gè)數(shù)組,如果你在PC標(biāo)簽中定義了return參數(shù),返回的數(shù)組將使用return的值進(jìn)行命令。
一般情況下你可以使用如下的方式來顯示值:
{loop $data $key $val}
<a href="{$val[url]}">{$val[title]}</a><br>
{/loop}
基中的$val[url]和$val[title]需要具體根據(jù)所使用的PC標(biāo)簽,返回的數(shù)據(jù)來判斷。
本文標(biāo)簽: PHPCMS PC標(biāo)簽