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

お勧め

Emojin：プラグイン作ってみました（2015年3月21日 更新）

ちょっと前のTLでiOSの絵文字を含んだ投稿を保存すると、絵文字以降の文章がすべて消えた状態で保存されるといったツイートを見かけた。少し検索してみると、MySQLのデータベースの文字セットが「utf8」の場合、iOSの絵文字のような4バイトの文字を正常に保存できず、それ以降の文章も保存されないというものらしい。対処方法としてデータベースの文字セットを「utf8mb4」に変更するのが有効らしいのだが、他に回避策がないか考えてみた。

Twenty Seventeenのフォントサイズを変更してみた（2021年12月15日 更新）

先日投稿した「続テーマを変更せずにWebフォントを使ってみた」では、テーマ「Twenty Seventeen」でもWebフォントを使えるようにした。その際、「Twenty Seventeen」のフォントサイズが少し小さく感じたので、今回はフォントサイズを調整してみた。

HTML entities button：プラグイン作ってみました（2021年4月28日 更新）

以前投稿した「HTML編集モードに定型文ボタンを追加する」をアレンジして、HTML編集モードに特殊文字（HTMLエンティティ）を挿入できるボタン、顔文字を挿入できるボタン、過去の投稿ページのリンクを挿入できるボタンを追加するプラグインを作ってみました。HTML編集モードの作業効率を向上させるプラグインです。2.1.0では「Dashiconsの挿入」を追加しました。HTML編集モードをメインに使用されている方は、お試しあれ。

5.7の機能拡張：エクスポートファイルに更新日時が追加ほか（2021年2月23日 更新）

WordPressはサイト移行を支援する機能として投稿情報のエクスポート機能を備えている。5.7ではこのエクスポート機能が改良され、更新日時情報が追加されるようだ。

query_posts（WP_Queryクラス）でカスタムフィールドを使う（2011年9月15日 更新）

先週3回にわたってtax_queryパラメータを使ったカテゴリーや投稿タグ、投稿フォーマットの絞り込みを整理したが、その途中で目に付いたのが'meta_query'パラメータ。この'meta_query'パラメータは、カスタムフィールドの絞り込み条件を指定するためのもので、3.2で登場した新しいパラメータのようだ。