get_bookmark_field()

get_bookmark_field()の用途

get_bookmark_field() は、WordPress に登録されたブックマーク（リンク）データの特定の「フィールド（項目）」を取得する関数です。

特定のブックマークIDから、URLや名前、説明文などの1項目だけを文字列として取得したいときに使います。HTML出力はせず、「値だけ」を取得する点が get_bookmark() との違いです。

get_bookmark_field()の基本構文

get_bookmark_field( $field, $bookmark, $context = 'display' );

get_bookmark_field()の引数

get_bookmark_field()の返り値

• 指定したフィールドの値（文字列）

get_bookmark_field()の使用例

ブックマークIDが5のリンク名（link_name）を取得

$link_name = get_bookmark_field( 'link_name', 5 );
echo esc_html( $link_name );

出力例：

おすすめサイト

URL を取得してリンクにする

$link_url  = get_bookmark_field( 'link_url', 5 );
$link_name = get_bookmark_field( 'link_name', 5 );

echo '<a href="' . esc_url( $link_url ) . '">' . esc_html( $link_name ) . '</a>';

get_bookmark_field()のよく使われる $field 一覧

$context の使い分け

通常は display で問題ありませんが、カスタム用途やデータ保存時は raw を使うことがあります。

get_bookmark() との違い

get_bookmark_field()の実用例：アイコン付きリンクリストを1件表示

$id = 5;
$url  = get_bookmark_field( 'link_url', $id );
$name = get_bookmark_field( 'link_name', $id );
$icon = get_bookmark_field( 'link_image', $id );

echo '<a href="' . esc_url( $url ) . '" target="_blank">';
if ( $icon ) {
    echo '<img src="' . esc_url( $icon ) . '" alt="' . esc_attr( $name ) . '"> ';
}
echo esc_html( $name ) . '</a>';

get_bookmark_field()の注意点

• ブックマーク（リンク）機能は WordPress 3.5 以降デフォルトで無効になっており、使用するには「Link Manager」プラグインの有効化やフィルター追加が必要です。
• IDが存在しない場合は null を返します。
• $field の入力ミスに注意（例：link_url はOK、url はNG）

get_bookmark_field()のまとめ