■概要(Description)
管理画面で入力した「リンク」をリストタグとして画面に表示する。
■使い方（Usage）
書式：
<ul >
<?php wp list bookmarks(); ?>
<ul>
■引数(Parameters)
引数は&でつないでいく
| orderby | 並び順を指定 name,length,rand |
| order | 並び順の支持 ASC(昇順),DESC(降順) |
| limit | 表示件数(-1:すべて) |
| category | カテゴリを指定。カテゴリーIDで入力。複数指定はカンマ区切り |
| category_name | カテゴリー名で指定する場合に使用 |
| hide_invisible | 非表示指定のカテゴリーを表示 0 非表示指定のカテゴリーを表示しない 1 |
| show_updated | |
| show_description | 説明を表示しない:０ 説明を表示する：1 |
| echo | 文字列として取得:0 表示する：1 |
| categorize | すべて表示:0 カテゴリー別に表示 1 |
| title_li | 見出し名 |
| title_before | 見出し名前につなげる文字列を指定 |
| title_after | 見出し名後につなげる文字列を指定 |
| category_orderby | カテゴリーのソート順指定 name,count,slug |
| category_order | カテゴリーのソート順を指示 ASC(昇順),DESC(降順) |
| class | 展開するクラス名を指定 |
| category_before | カテゴリー名の前につなげる文字列を指定 |
| category_after | カテゴリー名の後につなげる文字列を指定 |
■記述例
[1]すべてのリンクを表示
<?php wp_list_bookmarks(); ?>
[2]shopリンクカテゴリーのみ表示
<?php wp_list_bookmarks( 'category_name=shop' ); ?>
[3]タイトルをh2タグで囲むul > liのリストを展開
<?php wp_list_bookmarks('title_li=&category_before=&category_after='); ?>
[3]のhtml展開例
<h2>shop</h2> <ul class="xoxo blogroll"> <li>hogehoge</li> <li>hogehoge</li> <li>hogehoge</li> </ul>
[4]見出しを表示しないシンプルなリスト表示方法
liタグのみ表示されるのでulタグで関数を囲む必要あり。
<?php wp_list_bookmarks('title_li=&categorize=0'); ?>
[4]のhtml展開例
<li>hogehoge</li> <li>hogehoge</li> <li>hogehoge</li>
[5]リンクカテゴリーID=２のリンクを
画像付き、説明なし、URL昇順、前後にspanタグを挟んで表示する
<?php wp_list_bookmarks('categorize=0&category=2&before=<span>&after=</span>&show_images=1&show_description=0&orderby=url'); ?>
<li id="linkcat-2" class="linkcat"> <ul class="xoxo blogroll"> <span> <a href="http://hogehoge/">hoge.com</a> </span> <br> </ul> </li>
[6]タイトルの表示をblogroll.gifで表示させる
<?php wp_list_bookmarks('categorize=0&title_li=<img src="'.get_bloginfo("stylesheet_directory").'/images/blogroll.gif" alt="blogroll" />'); ?>
[6]のhtml展開例
<li id="linkcat-" class="linkcat"> <h2> <ul class="xoxo blogroll"> <li> <a href="http://hoge/">hoge</a> </li> </ul> </li>
[7]リストタグの後に改行をいれて評価値を表示する
<ol>
<?php wp_list_bookmarks('between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1'); ?>
</ol>
<li id="linkcat-2" class="linkcat"> <ul class="xoxo blogroll"> <li> <a target="_blank" href="http://hoge">hoge</a> <br> 7 </li> </ul> </li>
[8]リンクカテゴリーID=2, ID=4 のみ表示
<?php wp_list_bookmarks('category=2,4'); ?>
[8]のhtml展開例
<li id="linkcat-4" class="linkcat"> <h2>4 title</h2> <ul class="xoxo blogroll"> <li> <li> </ul> </li> <li id="linkcat-2" class="linkcat"> <h2>2 title</h2> <ul class="xoxo blogroll"> <li> <li> </ul> </li>
■参考URL,コード引用
[Wordpress Document] wp_list_bookmarks (Wings-Winds)
wp_list_bookmarks：WordPress私的マニュアル
