get_bookmarks

（2.1.0以降）
get_bookmarks - リンク情報を取得する

説明

mixed get_bookmarks( [ mixed $args = '' ] )
リンク情報を取得する。

パラメータ

  • $args
    取得条件を文字列または配列で指定。指定できる条件は次の通り。
    条件名条件の値
    orderbyソート項目として'length'、'rand'、'link_id'、'name'などを指定（省略時は'name'）。'length'と'rand'以外を複数指定する場合は,（カンマ）で区切る。
    orderソート順として'ASC'または'DESC'を指定（省略時は'ASC'）。
    limit取得件数（省略時は-1）。
    categoryリンクカテゴリーID（省略時は''）
    category_nameリンクカテゴリー名（省略時は''）
    hide_invisible非表示情報を取得しない場合は1、取得する場合は0を指定（省略時は1）
    show_updated更新日情報を取得する場合は1、取得しない場合は0を指定（省略時は0）
    include限定して取得するリンクID。複数指定する場合は,（カンマ）で区切る（省略時は''）
    exclude除外するインクID。複数指定する場合は,（カンマ）で区切る（省略時は''）
    searchint

返り値

リンク情報の配列を返す。リンク情報のプロパティは次の通り。
プロパティ名データ型意味
link_idintID
link_urlstringウェブアドレス
link_namestring名前
link_imagestring画像のアドレス
link_targetstringリンクターゲット（''、'_top'、'_blank'）
link_descriptionstring説明
link_visiblestring表示状態（表示の場合は'Y'）
link_ownerstringオーナーID
link_ratingint評価（0～10）
link_updatedstring更新日時
link_relstringrel
link_notesstringメモ
link_rssstringRSSのアドレス

注意

リンク情報のカテゴリーは、投稿記事のカテゴリーとは別の管理となっている。

使用例

  • リンク情報を取得する。
    <?php $links = get_bookmarks( ); ?>
  • リンク情報をランダムに5件取得する。
    <?php $links = get_bookmarks( 'orderby=rand&limit=5' ); ?>

最終更新 : 2011年06月10日 13:53

関連

参考

Code Reference: get_bookmarks

お勧め

query_posts（WP_Queryクラス）で投稿タグを絞り込む（2011年9月14日 更新）

投稿タグの絞り込みは、カテゴリーに似ているけど微妙に違っている。今日は、昨日投稿した「query_posts（WP_Queryクラス）でカテゴリーを絞り込む」の続きとして、投稿タグの絞り込みついてまとめてみる。

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

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

oEmbedについて考えてみた（2018年5月27日 更新）

本サイト向けにテーマをリニューアルしようと思い一から作っている最中、ふと生成されているHTMLの中にあるoEmbedの記述が目についた。「この記述いつからだっけ」くらいに思いながらリンク先を開き、ちょっとモヤモヤしてしまった。

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

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

WP_Postオブジェクトで投稿情報を直感的に使う（2012年10月4日 更新）

WordPress 3.5で登場するであろう WP_Postクラス。WordPressの投稿情報は、投稿情報本体のほか、カテゴリーや投稿タグ、カスタムフィールドなど、いくつかに分散して記録され、それぞれの情報を取得する際は、いくつかの関数をしていた。新しいWP_Postクラスにより、その習慣とおさらばできるかもしれない。