wp_list_bookmarks

（2.1.0以降）
wp_list_bookmarks - ブックマークを表示する

説明

string wp_list_bookmarks( [ mixed $args = '' ] )
ブックマーク（管理画面の「リンク」）をパラメータ$argsのecho値が1ならば表示する。echo値が0ならばその文字列を取得する。

パラメータ

  • $args
    表示条件を指定する文字列（または連想配列）。文字列の場合はname=valueの形式で指定し、複数の条件はname1=value1&name2=value2のように'&'の後に続ける。キーワードは次の通り。
    キーワード省略時の値意味
    orderby'name'リンクのソート対象を指定（'name'、'length'、'rand'など）
    order'ASC'リンクのソート順を示す'ASC'（昇順）か'DESC'（降順）
    limit-1表示件数（-1の場合はすべてを表示）
    category''カテゴリーを限定する場合に、それらのカテゴリーIDを指定
    exclude_category''特定のカテゴリーを除外する場合に、それらのカテゴリーIDを指定
    category_name''カテゴリーを限定する場合に、それらのカテゴリー名を指定
    hide_invisible1非表示指定のリンクを隠す場合は1、表示する場合は0
    show_updated0更新日時を表示する場合は1、表示しない場合は0
    echo1表示する場合は1、文字列として取得する場合は0
    categorize1カテゴリー別に表示する場合は1、すべてまとめて表示する場合は0
    title_li__('Bookmarks')見出し名
    title_before'<h2>'見出し名の前に連結する文字列
    title_after'</h2>'見出し名の後に連結する文字列
    category_orderby'name'カテゴリーのソート対象を指定（'name'、'count'、'slug'など）
    category_order'ASC'カテゴリーのソート順を示す'ASC'（昇順）か'DESC'（降順）
    class'linkcat'カテゴリー名のタグに指定するクラス名
    category_before'<li id="%id" class="%class">'カテゴリー名の前に連結する文字列
    category_after'</li>'カテゴリー名の後に連結する文字列

返り値

パラメータ$argsにecho値が0の場合は、リンクの文字列を返す。echo値が1（デフォルト）の場合は何も返さない。

注意

特にありません。

使用例

  • すべてのブックマークを表示する。
    <?php wp_list_bookmarks( ); ?>
  • blogカテゴリーのブックマークのみを表示する。
    <?php wp_list_bookmarks( 'category_name=blog' ); ?>

最終更新 : 2018年05月27日 10:48

関連

参考

Code Reference: wp_list_bookmarks

お勧め

query_posts（WP_Queryクラス）でカテゴリーを絞り込む（2011年9月14日 更新）

久しぶりに query_posts関数を見直してみると、見知らぬパラメータがいくつか追加されていた。気になったのでカテゴリー関係の指定を'tax_query'パラメータを交えて整理してみた。

the_date関数で投稿日を確実に表示する（2011年12月20日 更新）

投稿記事の投稿日時を表示する際、 the_date関数を使用することが多いだろう。このthe_date関数はphpのdate関数と同じパラメータを指定することで、好みの日時フォーマットで投稿日時を表示できるのだが、ある条件の場合に投稿日時を表示しない。最初にこの現象に遭遇したときは、ちょっと悩まされた。

スクリプトファイルのバージョンパラメータを変更する（2018年5月27日 更新）

Java Scriptやスタイルシートの指定を直接head要素内に記述せず、wp_enqueue_scriptsフィルターなどを使って指定する場合、WordPressのバージョン番号が付与されている。このバージョン番号は、妥当なんだろうか。

ログアウト後はいつもサイトトップ（2018年5月27日 更新）

ログアウト後に表示（リダイレクト）されるページは、標準ではログインページ（wp-login.php）である。4.2.0ではログアウト処理後のページリダイレクト前に呼び出されるフィルターが追加された。

カレンダーウィジェットをAjaxで切り替える（2011年8月22日 更新）

ウィジェットベースでテーマを構築していてカレンダーを表示してみた。標準では、前月や次月のリンク先はそれぞれの月のアーカイブページとなっているのだが、記事を探すだけであればカレンダー部分だけを更新するほうが便利なのではと考え、そのアイデアを実装してみた。