Wordpress Document

Author tags

Category tags

Comment tags

Date and Time tags

General tags

Geo tags

Link tags

Links Manager tags

Permalink tags

Post tags

Trackback tags

WP/PHP General

wp_list_bookmarks

概要

このドキュメントは下書き段階です
管理画面のブログロールに登録されたブックマーク一覧を表示します。
get_links_list()やget_links()と同じですが、テンプレートタグの中で表示方法を変更出来ます。
Wordpress2.1以上で使用出来ます。

用法

<?php wp_list_bookmarks('arguments'); ?>

引数

'arguments' (string)

query_string形式('key1=value1&key2=value2')で指定します。

categorize (boolean)

1(TRUE)
カテゴリーごとに分類します。(デフォルト)
0(FALSE)
分類せずに表示します。

category (string)

リンクを表示するリンクIDを、コンマ区切りで指定します。(デフォルト:''(全て表示))
例:"4,11,3"

category_name (string)

表示するカテゴリー名を指定します(デフォルト:''(全て表示))

category_orderby (string)

カテゴリーの表示順
'name'
名前順(デフォルト)
'id'
IDナンバー順

category_order (string)

'ASC'
category_orderbyを昇順で並べ替え(デフォルト)
'DESC'
category_orderbyを降順で並べ替え

title_li (string)

ページリストの表題に使用します。
デフォルト:'__('Bookmarks')' 'Bookmarks'と表示されます
categorizeがセットされているときに有効です。
nullもしくは空文字列 '' が指定されたときは表題を表示せず、<ul>、</ul>タグも表示しません。

title_before (string)

カテゴリー説明の前に表示します。デフォルト:'<h2>'

title_after (string)

カテゴリー説明の後に表示します。デフォルト:'</h2>'

show_private (string)

1 (TRUE)
カテゴリーがプライベート設定になっていても表示します。
0 (FALSE)
カテゴリーのプライベート設定に従います。(デフォルト)

include (string)

表示するブックマークのIDナンバーをコンマ区切りで指定します。

exclude (string)

表示しないブックマークのIDナンバーをコンマ区切りで指定します。

orderby (string)

リンクを並べ替える指定。
''(空白)が指定されたときは'id'と見なします。
'id'
'url'
'name'
(デフォルト)
'target'
'category'
'description'
'owner'
リンクマネージャーでそのリンクを登録した人
'rating'
'updated'
'rel'
関連リンク(XFN)
'notes'
'rss'
'length'
リンク名の文字数。昇順
'rand'
ランダム表示

order (string)

limit (integer)

表示するリンクの最大個数(デフォルト:-1 (全て))

before (string)

ラベルの前に表示するテキスト(デフォルト:'<li>')

after (string)

ラベルの後に表示するテキスト(デフォルト:'</li>')

category_before (string)

カテゴリーの前に表示するテキスト(デフォルト:'<li>')

category_after (string)

カテゴリーの後に表示するテキスト(デフォルト:'</li>')

between (string)

リンクのラベルまたは画像(アイコン)とその説明書きの間に入れる文字(デフォルト:'^n'(改行))

show_images (boolean)

リンクにアイコンを表示するかどうかの指定
TRUE
(デフォルト)
FALSE
-

show_description (boolean)

リンク詳細を表示するかどうかを指定します。show_imagesにFALSEが指定されているか、imageが定義されていない場合に利用出来ます。
TRUE
詳細を表示します。
FALSE
詳細を表示しません。(デフォルト)

show_rating (boolean)

TRUE
投票数を表示します。
FALSE
投票数を表示しません(デフォルト)

show_updated (boolean)

TRUE
最終更新日を表示します。
FALSE
(デフォルト)

hide_invisible (boolean)

管理画面のVisible設定がNO(隠す)になっていても、ブックマークを表示します。
TRUE
管理者設定に従います(デフォルト)
FALSE
強制表示します

echo (boolean)

TRUE
リンクを表示します。(デフォルト)
FALSE
PHPで使用出来るように返します。

用例

-