説明
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。複数指定する場合は,(カンマ)で区切る(省略時は'') search int
返り値
リンク情報の配列を返す。リンク情報のプロパティは次の通り。プロパティ名 | データ型 | 意味 |
---|---|---|
link_id | int | ID |
link_url | string | ウェブアドレス |
link_name | string | 名前 |
link_image | string | 画像のアドレス |
link_target | string | リンクターゲット(''、'_top'、'_blank') |
link_description | string | 説明 |
link_visible | string | 表示状態(表示の場合は'Y') |
link_owner | string | オーナーID |
link_rating | int | 評価(0~10) |
link_updated | string | 更新日時 |
link_rel | string | rel |
link_notes | string | メモ |
link_rss | string | RSSのアドレス |
注意
リンク情報のカテゴリーは、投稿記事のカテゴリーとは別の管理となっている。使用例
- リンク情報を取得する。<?php $links = get_bookmarks( ); ?>
- リンク情報をランダムに5件取得する。<?php $links = get_bookmarks( 'orderby=rand&limit=5' ); ?>
最終更新 : 2011年06月10日 13:53
関連
お勧め
Posts filter multiselect:プラグイン作ってみました(2022年4月8日 更新)
先週の金曜日、知り合いの方から「投稿一覧ページで絞り込みを行う際、複数選択できないか」といった問い合わせがあり、その時には「標準では無理ですね」と返答しました。このこと自体は事実なのですが、要するに「複数選択可能なドロップダウンメニュー」が実現できれば対応するのはそれほど難しくないような気がしました。この週末、そんなノリでちょっとコーディングしてできたのがこのプラグインです。全投稿を取得するのはnopaging=1でいい(2011年8月31日 更新)
query_posts関数(またはWP_Queryクラス)を使う場合、取得する件数の指定を省略すると管理者ページの「表示設定」-「1ページに表示する最大件数」の指定値分だけの投稿情報を取得する。それでは条件にマッチするすべての投稿情報を取得するには?Contact Form 7に確認フェーズを(2012年12月16日 更新)
Contact Form 7はWordPressによるサイト製作でお世話になることが多いプラグインの1つ。ただ、クライアント様によっては、入力、確認、送信の3フェーズにしたいという要望があり、そんな時は別の方法を採用していたのですが、JavaScript(jQuery)を使ってページ遷移しなくてもいいなら確認フェーズは用意できるかなと思い、作り込んでみた。古めのリビジョンを削除した時のメモ(2022年5月16日 更新)
大きく育ったデータベースを整理するため、古めのリビジョンとそれに紐づいたカスタムフィールドデータを削除。と思ったら「The total number of locks exceeds the lock table size」というエラーが発生して削除できなかった。
プラグインで注意が必要な関数(2013年11月27日 更新)
先日「Login rebuilder」という自作プラグインをアップデートした際、ユーザーさんからエラーになると連絡をいただいた。標準環境では問題なく、どうやら何らかのプラグインが影響しているらしい。