get_bookmarks()


WordPressのget_bookmarks()関数は、ブックマーク（リンク）を取得するために使用されます。この関数は、リンクマネージャーに保存されたリンクを取得する際に役立ちます。

構文

get_bookmarks( array|string $args = '' );
  • $args (array|string) — リンクを取得するためのパラメータを指定します。デフォルトは空の文字列です。

例1: すべてのブックマークを取得

この例では、すべてのブックマークを取得します。

<?php $bookmarks = get_bookmarks(); foreach ( $bookmarks as $bookmark ) { echo $bookmark->link_name; } ?>

例2: 特定のカテゴリのブックマークを取得

この例では、カテゴリIDが2のブックマークを取得します。

<?php $bookmarks = get_bookmarks( array( 'category' => 2 ) ); foreach ( $bookmarks as $bookmark ) { echo $bookmark->link_name; } ?>

例3: ブックマークを名前順に並べ替える

この例では、ブックマークを名前順に並べ替えて取得します。

<?php $bookmarks = get_bookmarks( array( 'orderby' => 'name' ) ); foreach ( $bookmarks as $bookmark ) { echo $bookmark->link_name; } ?>

例4: ブックマークをID順に並べ替える

この例では、ブックマークをID順に並べ替えて取得します。

<?php $bookmarks = get_bookmarks( array( 'orderby' => 'id' ) ); foreach ( $bookmarks as $bookmark ) { echo $bookmark->link_name; } ?>

例5: ブックマークの取得数を制限する

この例では、取得するブックマークの数を5つに制限します。

<?php $bookmarks = get_bookmarks( array( 'limit' => 5 ) ); foreach ( $bookmarks as $bookmark ) { echo $bookmark->link_name; } ?>

例6: 特定のブックマークを除外する

この例では、IDが5のブックマークを除外して取得します。

<?php $bookmarks = get_bookmarks( array( 'exclude' => 5 ) ); foreach ( $bookmarks as $bookmark ) { echo $bookmark->link_name; } ?>

例7: ブックマークの説明を取得

この例では、ブックマークの説明を取得します。

<?php $bookmarks = get_bookmarks(); foreach ( $bookmarks as $bookmark ) { echo $bookmark->link_description; } ?>

注意点

  • リンクマネージャーが有効になっている必要があります。無効の場合、この関数は動作しません。
  • 引数に不正な値を指定すると、予期しない結果が返されることがあります。

関連機能：