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

お勧め

スマートフォン向けの振り分けを自前で行う（2012年1月23日 更新）

PC向けのサイトをスマートフォン対応する場合、WPtouchやktai styleに代表されるスマートフォン対応のテンプレート切り替えプラグインを使用するのが一般的。そういったプラグインはテンプレート切り替え以外の機能も備えており、そういった機能は必ずしも必要ではない。そんなわけで、ここでは超シンプルなスマートフォン向けのテンプレート切り替えを実現する方法を紹介する。

ショートコードを含んだページを表示する前に何か処理する（2014年5月28日 更新）

固定ページまたは投稿ページに独自のフォームを埋め込む。入力→登録の2段階のフォームなら著名なプラグイン「Contact Form 7」を利用すればいいのだが、クライアントの依頼は入力→確認→登録の3段階で組み込む要素が特化していたので、独自の実装方法を考えることになった。

適切なテンプレートファイルを用意してテンプレート内の振り分け処理を無くす（2019年5月24日 更新）

/wp-includes/template-loader.phpではリクエストされたページに応じて現在のテーマにあるテンプレートファイルの中から適切なものを選びに振り分けている。ここでは、さまざまなテンプレートファイルの種類と、テンプレートファイルが省略された場合の内部の動作についてまとめてみる。

管理者ページに文言を表示する（2012年4月19日 更新）

お客様向けに管理者ページをカスタマイズする機会が増えてきている。カスタマイズするページや表示場所、表示内容によっていくつかの手段があるが、今回はページの冒頭部分に任意の文言を表示する方法を紹介する。

5.3の機能強化：ユーザーパスワードの表示と非表示（2019年9月30日 更新）

「WordPress 5.3 Beta 1」に記載されていた「Toggle password view」という項目。「Other Changes for Developers」の見出しの中ということもあり、ちょっと調べてみた。