get_bookmarks()

get_bookmarks()の用途

get_bookmarks() は、WordPress に登録された複数のブックマーク（リンク）を取得する関数です。返されるのは配列形式で、link_url や link_name などの情報を含む WP_Bookmark オブジェクトの配列です。

get_bookmarks()の基本構文

$bookmarks = get_bookmarks( $args );

get_bookmarks()は何をする関数か？

• wp_list_bookmarks() が「表示」を目的とするのに対し、
  get_bookmarks() は「取得」を目的とした関数です。
• リンクマネージャー機能（blogroll）に登録されたリンクを、プログラム的に操作・加工したいときに使います。

get_bookmarks()の主な用途

• 自作テンプレート内でリンクをカスタム表示したい
• ブックマークをループ処理で自由に出力したい
• <select> メニューやリストなどに変換したい

get_bookmarks()の主な引数一覧（$args）

get_bookmarks()の戻り値

• WP_Bookmark オブジェクトの配列
  （link_name, link_url, link_description などのプロパティを持つ）

get_bookmarks()の使用例①：すべてのリンクを取得して表示

$bookmarks = get_bookmarks();

foreach ( $bookmarks as $bookmark ) {
    echo '<a href="' . esc_url( $bookmark->link_url ) . '" target="_blank">';
    echo esc_html( $bookmark->link_name );
    echo '</a><br>';
}

get_bookmarks()の使用例②：特定カテゴリのリンクのみ取得

$bookmarks = get_bookmarks( array(
    'category_name' => 'blogroll',
    'orderby'       => 'name',
    'order'         => 'ASC'
) );

foreach ( $bookmarks as $bookmark ) {
    echo '<li><a href="' . esc_url( $bookmark->link_url ) . '">' . esc_html( $bookmark->link_name ) . '</a></li>';
}

get_bookmarks()の使用例③：非表示リンクも含めて取得（hide_invisible => false）

$bookmarks = get_bookmarks( array(
    'hide_invisible' => false
) );

各 WP_Bookmark の主なプロパティ

get_bookmarks()の注意点

• WordPress 3.5 以降は「リンク」機能はデフォルトで無効です。
  • 有効化するには： add_filter( 'pre_option_link_manager_enabled', '__return_true' );
  • またはプラグイン「Link Manager」をインストール
• カスタムメニュー機能の登場以降、この関数は主にレガシーコードや独自用途で使われます。

get_bookmarks() と wp_list_bookmarks() の違い

get_bookmarks()のまとめ