在模板製作中,經常遇到一些網站標籤在多個頁面調用的問題,通常情況下我們可以通過模板的{dede:include file='文件名稱' ismake='是否為dede板塊模板(yes /no)'/}標籤匯入一個檔案解決。
在DedeCMS的5.3版本預設模板中的head.htm就如透過這樣的標記引入到其他模板文件,然後編譯成頁面頭部資訊的,但這樣以文件形式引入的方式並不適用於少量內容的全域顯示。 (推薦學習:dedecms教學)
例如你可能有一個欄目,這個欄位需要在全域進行顯示,而這個欄目的呼叫資訊會經常改變,但只涉及到一段程式碼,如果使用{dede:include/}是很難實現的,這時候就需要自訂巨集標記來解決這個靈活呼叫的問題。其實織夢的廣告外掛也是宏標記的另一種表現。
在學習自訂巨集標記之前,我們先查閱織夢幫助中心模板標籤部分,關於自訂巨集標記的使用介紹:
以下為引用的內容:
標籤名稱:mytag
功能說明:用於取得自訂巨集標記的內容
適用範圍:全域使用
基本語法: {dede:mytag typeid='0' name=''/}
#參數說明:
name = '' 標記名稱,該項是必須的屬性,以下2、3是可選屬性;
ismake = 'yes|no' 預設是no 表示設定的純HTML程式碼,yes 表示含板塊標記的程式碼;
typeid = '' 表示所屬欄目的ID,預設為0 ,表示所有欄位通用的顯示內容,在清單和文件範本中,typeid預設是這個清單或文件本身的欄位ID。
使用自訂巨集標記主要有3個步驟:產生標籤,加入模板,內容生成,以下我們從這幾個過程來講解如何使用這個標記。
產生標籤
新版本V5.3中增加了自訂巨集標記可以自動產生並加入織夢標籤,這個類似模板碎片功能。第一種就是直接新增標籤,可以點選[範本]-[自訂巨集標記]進入自訂巨集標記管理頁面,新增一個標籤。
這裡需要介紹幾個參數:
所屬欄位:如果不選擇則在所有的欄位中進行顯示,如果選擇了某個欄目,則只在自訂巨集標記只在目前選定的欄位中進行顯示
#標記名稱:用於區分不同標記的名稱,建議使用英文和數字的集合
正常顯示內容:標籤在解析時候被替換的內容,可以為純文字、HTML、甚至是織夢的標籤
如果選擇了時效也可以控制標籤的顯示時間,這樣便於統一對這些內容進行管理,非常方便。
完成新增後我們便得到對應的標籤,例如我們自訂標籤名稱為diyinfo,則我們的標籤名稱就為{dede:mytag name='diyinfo'},如果標籤內為HTML或純文字內容可以設定ismake屬性為no,如果加入了織夢的標籤,則將ismake屬性設為yes。
第二種方法就是在系統[範本]-[智慧標記精靈]中產生一個標籤,然後儲存為自訂巨集標記,儲存的預設檔名為auto_x(x代表數字,從1開始),這樣取得他的標籤代碼為{dede:mytag name='auto_1' ismake='yes'/}。
當然自訂巨集標記不但但可以透過織夢標籤的形式進行調用,還可以透過js的方式進行調用,在自訂標籤管理頁面,每個標籤後面有一個對應的js產生精靈,使用者可以產生js程式碼插入到網站模板中。
加入範本
自訂巨集標記可以任意加入到範本中的首頁、頻道頁、清單頁、內容頁中,相對的範本檔案路徑在織夢幫助中心的《主要模板文件及功能說明》已經列出,修改時候可以參考加入。
內容產生
如果自訂巨集標記使用的是織夢標籤加入範本中,需要定期對網站所有內容進行一次更新,但如果您在模板中使用了js程式碼,只需要產生一次就可以一直進行使用。
以下為引用的內容:
說明:織夢標籤和js是自訂標記的兩種呼叫形式,前者比較適合網站定期進行全站更新,並且生成內容直接嵌套到生成頁面中,後者比較適合網站少量更新,但更加方便管理。這裡廣告外掛其實是自訂巨集標記的擴展,呼叫形式有些相同。
至此,我們完成了自訂巨集標記的學習,當然自訂巨集標記還有很多面向的應用,期待更多的織夢使用者進行發覺。
以上是DedeCMS自訂巨集標記使用的詳細內容。更多資訊請關注PHP中文網其他相關文章!