參考：

WordPress官方文檔：

https://codex.wordpress.org/Function_Reference/wp_list_bookmarks#List_.26_Dropdown_Functions

WP大學：

https://www.wpdaxue.com/wp_list_bookmarks.html

511遇見：

http://www.511yj.com/wordpress-wplist_bookmarks.html

以下來源于：

http://www.511yj.com/wordpress-wplist_bookmarks.html

想做個性化的友情鏈接，搜索引擎優化中，首頁和內頁的權重是不一樣，但友情鏈接在wordpress大部分模版中都是在側邊欄書香顯示。如果側邊欄很寬，或者友情鏈接很多，或者只在首頁顯示友情鏈接，那在內部頁面友情鏈接的這個經常變化的長度就不好和頁面其他的長度配合，進而影響到了整個網頁的美觀。重慶SEO研究一下在wordpress中將友情鏈接橫向現實在首頁底部，那樣所有問題就都解決了；在研究怎么把這個功能實現之前，首先要研究的當然是友情鏈接的輸出函數wp_list_bookmarks（）

調用方法

<h3>友情鏈接：h3>
<ul> wp_list_bookmarks($args); ?>ul>

默認參數

 $args = array(
    'orderby'          => 'name',
    'order'            => 'ASC',
    'limit'            => -1,
    'category'         => ' ',
    'exclude_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'   => '
' ); 
?>

orderby 字符串型，Blogroll 的排列方式（默認是根據名稱排序，除非將這個值留空）

order 字符串型，設置升降序的排列方式 ASC (默認) DESC

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

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

show_images 布爾型，是否允許顯示 Blogroll 下鏈接的對應圖片。1 (允許 – 默認) 0 (不允許)

show_description 布爾型，是否允許顯示每個鏈接的描述。1 (允許) 0 (不允許 – 默認)

show_rating 布爾型，是否允許顯示鏈接的等級。1 (允許) 0 (不允許 – 默認)

show_updated 布爾型，是否允許顯示最近更新后的時間戳。1 (允許) 0 (不允許 – 默認)

hide_invisible 布爾型，是否顯示所有的鏈接，甚至是被管理員設為不可見的鏈接，默認允許顯示。1 (允許 – 默認) 0 (不允許)

應用舉例

1、調用當前的友情鏈接

 wp_list_bookmarks(); ?>

2、隨機顯示10條鏈接：

?wp_list_bookmarks('orderby=rand&limit=10');??>

3、顯示所有鏈接，但不包括默認標題（去掉“書簽”這個標題）

 wp_list_bookmarks('title_li=&categorize=0'); ?>

4、顯示所有鏈接，標題為“Bookmarks”，各鏈接項包圍在li標簽中，標題則用h2標簽。

 wp_list_bookmarks('title_li=&category_before=&category_after='); ?>

5、顯示所有鏈接，但不包括默認標題。

 wp_list_bookmarks('title_li=&categorize=0'); ?>

6、顯示ID為2的鏈接分類下的所有鏈接，使用鏈接圖片，不顯示鏈接說明，按URL排列鏈接。

 wp_list_bookmarks('categorize=0&category=2&before=&after=&show_images=1&show_description=0&orderby=url'); ?>

7、以數字編號列表形式顯示所有鏈接，各鏈接下另起一行填寫鏈接說明，不適用鏈接圖片，按ID排列鏈接，顯示鏈接等級和最新更新的時間。

 wp_list_bookmarks('between=
&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?>
ol>

8、從主題目錄中選擇一個圖片代替普通文本作為鏈接列表標題。

 wp_list_bookmarks('categorize=0&title_before=&title_after=&title_li="stylesheet_directory").'/images/blogroll.gif" alt="blogroll" />'); ?>

小結

1、wp_list_bookmarks函數的用法和wp_list_categories極為類似 。

2、參數太多，使用靈活，但未必是你想要的，閱讀以下 wpdb和get_results讀取數據庫打造個性友情鏈接教程

3、官方原文 https://codex.wordpress.org/Function_Reference/wp_list_bookmarks

來源于，WP大學：

https://www.wpdaxue.com/wp_list_bookmarks.html

wp_list_bookmarks()使用示例

簡單的鏈接列表

顯示所有鏈接，標題為“Bookmarks”，各鏈接項包圍在

標簽中，標題則用

標簽。 wp_list_bookmarks('title_li=&category_before=&category_after='); ?>

沒有標題的簡單列表

按上一個例子的條件顯示所有鏈接，但不包括默認標題。

 wp_list_bookmarks('title_li=&categorize=0'); ?>

顯示某個分類下的所有鏈接

顯示ID為2的鏈接分類下的所有鏈接，使用鏈接圖片，不顯示鏈接說明，按URL排列鏈接。

 wp_list_bookmarks('categorize=0&category=2&before=&after=&show_images=1&show_description=0&orderby=url'); ?>

顯示鏈接等級和時間標記

以數字編號列表形式顯示所有鏈接，各鏈接下另起一行填寫鏈接說明，不適用鏈接圖片，按ID排列鏈接，顯示鏈接等級和最新更新的時間。

 wp_list_bookmarks('between=
&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?>
ol>

用圖片取代標題

從主題目錄中選擇一個圖片代替普通文本作為鏈接列表標題。

 wp_list_bookmarks('categorize=0&title_before=&title_after=&title_li="stylesheet_directory").'/images/blogroll.gif" alt="blogroll" />'); ?>

小結：

1.總的來說，要用好wp_list_bookmarks()函數，需要自己熟練掌握參數的用法，重要的是多多實踐。

2.如果你英文還行，建議閱讀英文版：Function Reference/wp list bookmarks