説明
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
関連
お勧め
meta_compare_key使ってみた(2019年3月19日 更新)
ブロックエディターの登場により、標準のカスタムフィールドを使う機会はかなり減った気がする。そんな中、5.1.0で追加されたのが、カスタムフィールド名(メタキー)に含まれる文字列を指定する'meta_compare_key'キーだ。
WP_List_Tableクラスの「一括操作」フォームを使ってみた(2018年5月27日 更新)
今回は「WP_List_Tableクラスを使ってみた」の続き。投稿一覧やプラグインページなどにある「一括操作」(Bulkアクション)フォーム対応に関するメモである。
テーマから投稿画像のサイズを指定する(2012年3月15日 更新)
投稿記事に挿入する画像サイズは、サムネイル(150×150)、中サイズ(300×300)、大サイズ(1024×1024)がデフォルトだが、テーマによっては別のサイズを指定したい場合はある。基本的には、「設定」-「メディア」の「メディア設定」ページで指定できるが、テーマ内のfunctions.phpで設定しておくとちょっと便利かもしれない。ログインページを変える(2014年9月12日 更新)
WordPressの標準的な不正ログイン対策としては、ログインIDは'admin'を避けるパスワードはユニークで長くする、場合によってはアクセスできるIPアドレスを制限する、といった具合だろう。これらの他に何かできないものだろうかと、ちょっと考えてみた。新規投稿時の本文プレースホルダーテキストを変える(2021年9月9日 更新)
ブロックエディターに影響を与えるフィルターは多数存在する。今回紹介するフィルターはその1つで、新規投稿時の本文ブロックのプレースホルダーテキストを変更するものだ。