WordPress友情鏈接函數wp_list_bookmarks調用

有些時候,我們並不想要某個友情鏈接在全站頁面都體現,而是想實現類似的效果:只在首頁顯示一部分的友鏈,然後其它的都體現在“友情鏈接頁面”,而普通的文章頁和列表頁之類則是不再顯示。


實現過程並不複雜,調用鏈接時稍微自定義一下就可以實現這樣的效果,我們可以運用wp_list_bookmarks函數來實現個性化的友情鏈接調用。


首先,要對友情鏈接進行分類處理,然後使用類似下面的代碼單獨調用該分類的鏈接:


代碼含義:顯示分類id爲2的所有鏈接,以鏈接的ID排序,並且不顯示鏈接分類目錄名。


需要按分類顯示全部鏈接的地方,則可以加入以下代碼調用:


wp_list_bookmarks 函數的默認參數是:


'orderby' => 'name'
'order' => 'ASC'
'limit' => -1
'category' => ''
'category_name' => ''
'hide_invisible' => 1
'show_updated' => 0
'echo' => 1
'categorize' => 1
'title_li' => __('Bookmarks')
'title_before' => ''
'title_after' => ''
'category_orderby' => 'name'
'category_order' => 'ASC'
'class' => 'linkcat'
'category_before' => ''
'category_after' => ''


下面我來一一介紹每個參數的用途:


categorize:布爾型,用於設置連接是否按照各自的分類顯示,默認值爲1,根據鏈接的分類顯示,爲0 時不按照分類,顯示全部鏈接。


category:字符串型,後面就直接 “=鏈接分類ID號”,那麼就顯示這個分類下的鏈接。如果沒有指定的話就顯示所有的鏈接。

category_name:字符串型,如果後面 “=某個鏈接分類的名稱” 那麼就會在該鏈接分類前顯示分類的名稱,如果這裏留空的話則會顯示所有鏈接分類的分類名稱(即默認的形式)。


category_before:字符串型,位於鏈接分類之前的文字或代碼。默認的設置是:


category_after:字符串型,位於鏈接分類之後的文字或代碼。默認的設置是:


class:字符串型,每一個鏈接的分類都會有一個 “class” 屬性(從上面的代碼就能看出),默認是:linkcat


category_orderby:字符串型,鏈接分類的排序方式,按照名稱(name)或者ID。


category_order:字符串型,鏈接分類的升序(ASC,默認)降序(DESC)顯示方式。


title_li:字符串型,鏈接標題的頭文字或代碼,默認是:Bookmarks,並且它控制連接是否按照列表的方式排列。


title_before 和 title_after:顧名思義,它們就是連接標題頭前後的文字或代碼,默認是 h2 標籤


show_private:布爾型,是否顯示私有鏈接。


include:字符串型,輸出指定 ID 的 Blogroll 的分類鏈接,各個 ID 之間用半角的 “,” 分開。默認顯示所有的 Blogroll 分類。


exclude:字符串型,將指定 ID 的 Blogroll 分類鏈接從整個鏈接列表中排除,各個 ID 之間用半角的 “,” 分開。默認是什麼都不排除。

orderby:字符串型,Blogroll 的排列方式(默認是根據名稱排序,除非將這個值留空),即根據我們在 WP 後臺鏈接設置界面下的那些參數來


進行排序:


limit:整型,設置輸出鏈接條數的最大值。默認值是”-1″,輸出全部。


between:字符串型,每個連接、圖片和描述之間的文字或代碼,默認是 “n” 換行。


show_images:布爾型,是否允許顯示 Blogroll 下鏈接的對應圖片。


show_description:布爾型,是否允許顯示每個鏈接的描述。


show_rating:布爾型,是否允許顯示鏈接的等級。


show_updated:布爾型,是否允許顯示最近更新後的時間戳。


hide_invisible:布爾型,是否顯示所有的鏈接,甚至是被管理員設爲不可見的鏈接,默認允許顯示。


理解這些參數的用途之後,就可以十分靈活的調用鏈接, 只需要再用CSS美化一下顯示結果。


發佈了18 篇原創文章 · 獲贊 5 · 訪問量 5萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章