説明
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_invisible 1 非表示指定のリンクを隠す場合は1、表示する場合は0 show_updated 0 更新日時を表示する場合は1、表示しない場合は0 echo 1 表示する場合は1、文字列として取得する場合は0 categorize 1 カテゴリー別に表示する場合は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
関連
お勧め
Login rebuilder 2.3.0の新機能を紹介(2018年5月27日 更新)
プラグイン「Login rebuilder」はログイン時の履歴(ログ)や不正なログインページへのアクセス履歴を保存している。これらの履歴情報はダッシュボートで確認できるが、バージョン2.3.0においてそれぞれがダウンロードできるようになった。
古めのリビジョンを削除した時のメモ(2022年5月16日 更新)
大きく育ったデータベースを整理するため、古めのリビジョンとそれに紐づいたカスタムフィールドデータを削除。と思ったら「The total number of locks exceeds the lock table size」というエラーが発生して削除できなかった。
決まった値を返すだけの関数群(2018年5月27日 更新)
WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。
「Align widgets horizontally」プラグインのフィルター使用例(2024年5月15日 更新)
ダッシュボードのウィジェットを横並びに変える「Align widgets horizontally」プラグインには緒設定を変更できるフィルターが用意されている。ここではフィルターの使い方と設定できる項目について紹介する。
WP_Postオブジェクトで投稿情報を直感的に使う(2012年10月4日 更新)
WordPress 3.5で登場するであろう WP_Postクラス。WordPressの投稿情報は、投稿情報本体のほか、カテゴリーや投稿タグ、カスタムフィールドなど、いくつかに分散して記録され、それぞれの情報を取得する際は、いくつかの関数をしていた。新しいWP_Postクラスにより、その習慣とおさらばできるかもしれない。