為您的佈景主題增添「Tag Cloud」
這個功能也是在 WordPress 2.3 才開始有的。這個功能是將所有文章的標籤通通集合在一起顯示出來,然後依據您在其它文章中使用某標籤的次數來顯示在這個集合中之標籤文字的大小,使用越多次的標籤,其標籤文字就會越大,反之則越小。
就這樣——在集合中,有些標籤的文字大,有些比較小,其整體的顯示效果就好像雲(Cloud)一樣,所以這也是 Tag Cloud(標籤雲) 名稱的由來。點擊在標籤雲中的標籤鏈結,則會鏈結到該標籤彙整的頁面上(如果有的話,例如 archive.php 或自訂的 Tag Archive 模板),而這個頁面所列出的文章,都將是同屬於相同標籤的文章。
雖說已經內建有 Widget 在側邊欄(Sidebar),不過當您不想放在側邊欄時,可以將以下敘述中的函式,置放在您佈景主題想要將標籤雲呈現出來的位置上。
使用方法
如果函式中未加任何參數時,則會使用本來預設的參數與其值。
參數
smallest
使用最少次數標籤的文字大小,預設是 8pt。
largest
使用最多次數標籤的文字大小,預設是 22pt。
unit
文字大小的單位,例如 pt、px、em、% 長度單位,預設是 pt。
number
標籤雲中,所顯示的標籤數,預設是 45 個( 0 表示顯示全部的標籤)。
format
標籤雲顯示的格式。
- flat – 標籤與標籤之間用空白字元來分隔,這是預設的值。
- list – 標籤將會以 class='wp-tag-cloud' 的 <ul> 來顯示。
- array – 標籤將會在陣列之中並且函式回傳一個標籤雲陣列以便使用於 php 中(這個參數值只能用在 WordPress 2.5 及之後)。
orderby
依名稱或次數來排序。
- name – 依據名稱來排序,這是預設的值。
- count – 依據使用次數來排序。
order
排列的順序。(其值必須為大寫)
- ASC – Ascending(遞增,舊到新的排序),這是預設的值。
- DESC – Descending(遞減,新到舊的排序)。
- RAND – 隨機排序(這個參數值只能用在 WordPress 2.5 及之後)。
exclude
排除顯示的標籤,例如:'exclude=5,27' 表示 term_id 為 5 與 27 的標籤不會被顯示,預設是不排除任何標籤。
include
指定顯示的標籤,例如:'include=5,27' 表示只顯示 term_id 為 5 與 27 的標籤,預設是顯示所有的標籤。
範例
<?php wp_tag_cloud('unit=px&smallest=15&largest=30'); ?>
※註:在 WordPress 中,函數之中若有多個參數的話,參數與參數之間用 & 來相連。