■概要(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| 説明を表示しない:0 説明を表示する: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]
<?php wp_list_bookmarks(); ?>
[/php]
[2]shopリンクカテゴリーのみ表示
[php]
<?php wp_list_bookmarks( ‘category_name=shop’ ); ?>
[/php]
[3]タイトルをh2タグで囲むul > liのリストを展開
[php]
<?php wp_list_bookmarks(‘title_li=&category_before=&category_after=’); ?>
[/php]
[3]のhtml展開例
[html]
<h2>shop</h2>
<ul class="xoxo blogroll">
<li>hogehoge</li>
<li>hogehoge</li>
<li>hogehoge</li>
</ul>
[/html]
[4]見出しを表示しないシンプルなリスト表示方法
liタグのみ表示されるのでulタグで関数を囲む必要あり。
[php]
<?php wp_list_bookmarks(‘title_li=&categorize=0’); ?>
[/php]
[4]のhtml展開例
[html]
<li>hogehoge</li>
<li>hogehoge</li>
<li>hogehoge</li>
[/html]
[5]リンクカテゴリーID=2のリンクを
画像付き、説明なし、URL昇順、前後にspanタグを挟んで表示する
[php]
<?php wp_list_bookmarks(‘categorize=0&category=2&before=<span>&after=</span>&show_images=1&show_description=0&orderby=url’); ?>
[/php]
[html]
<li id="linkcat-2" class="linkcat">
<ul class="xoxo blogroll">
<span>
<a href="http://hogehoge/">hoge.com</a>
</span>
<br>
</ul>
</li>
[/html]
[6]タイトルの表示をblogroll.gifで表示させる
[php]
<?php wp_list_bookmarks(‘categorize=0&title_li=<img src="’.get_bloginfo("stylesheet_directory").’/images/blogroll.gif" alt="blogroll" />’); ?>
[/php]
[6]のhtml展開例
[html]
<li id="linkcat-" class="linkcat">
<h2>
<ul class="xoxo blogroll">
<li>
<a href="http://hoge/">hoge</a>
</li>
</ul>
</li>
[/html]
[7]リストタグの後に改行をいれて評価値を表示する
[php]
<ol>
<?php wp_list_bookmarks(‘between=<br />&show_images=0&orderby=id&show_rating=1&show_updated=1’); ?>
</ol>
[/php]
[html]
<li id="linkcat-2" class="linkcat">
<ul class="xoxo blogroll">
<li>
<a target="_blank" href="http://hoge">hoge</a>
<br>
7
</li>
</ul>
</li>
[/html]
[8]リンクカテゴリーID=2, ID=4 のみ表示
[php]
<?php wp_list_bookmarks(‘category=2,4’); ?>
[/php]
[8]のhtml展開例
[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>
[/html]
■参考URL,コード引用
[Wordpress Document] wp_list_bookmarks (Wings-Winds)
wp_list_bookmarks:WordPress私的マニュアル
コメント
コメント一覧 (2件)
[…] 参考:リンクをリストタグで表示するwp list bookmarks | WordPress攻略本 […]
[…] リンクをリストタグで表示するwp list bookmarks | WordPress攻略本 […]