sanitize_bookmark_field

（2.3.0以降）
sanitize_bookmark_field - リンク情報の要素値をサニタイズする

説明

mixed sanitize_bookmark_field( string $field, mixed $value, int $bookmark_id, string $context )
リンク情報の要素値をサニタイズする。

パラメータ

  • $field
    リンク情報の要素（プロパティ）名を指定。指定できる名前は次の通り。
    要素（プロパティ）名意味
    link_idID
    link_urlウェブアドレス
    link_name名前
    link_image画像のアドレス
    link_targetリンクターゲット（''、'_top'、'_blank'）
    link_description説明
    link_visible表示状態（表示の場合は'Y'）
    link_ownerオーナーID
    link_rating評価（0～10）
    link_updated更新日時
    link_relrel
    link_notesメモ
    link_rssRSSのアドレス
    link_categoryリンクカテゴリーIDの配列
  • $value
    リンク情報の要素（プロパティ）値を指定。
  • $bookmark_id
    リンクIDを指定。
  • $context
    要素値の使用方法（フィルター名）を指定。
    使用方法（フィルター名）意味
    rawフィルター処理は行わない（生データ）
    edit編集向けのフィルター処理を行う
    attribute属性値向けフィルター処理を行う
    jsJavaScript向けフィルター処理を行う
    dbデータベース向けフィルター処理を行う
    display表示向けフィルター処理を行う

返り値

サニタイズしたリンク情報の要素値を返す。

注意

get_bookmark_field関数から呼び出される。

使用例

  • 'link_name'の値を表示用にサニタイズする。
    <?php $link = sanitize_bookmark_field( 'link_name', $link, $id, 'display' ); ?>

最終更新 : 2019年04月24日 16:12

関連

参考

Code Reference: sanitize_bookmark_field

お勧め

テーブルブロックを定形に整える（2021年12月27日 更新）

ブロックエディターについて調べていると、「段落ブロックをもう少しカスタマイズした」で使ったRichTextShortcutとは別にショートカットキーを使うためのKeyboardShortcutsが見つかった。今回はこのKeyboardShortcutsを使ってテーブルブロックを定形に整える仕組みを考えてみた。

各種リンクを取得する関数一覧（2014年6月12日 更新）

サイト設計において、ページ間の相互リンクは重要である。WordPressでは各種ページのリンク（パーマリンク）を取得する関数を用意しており、それらを一通り把握しておくべきだろう。

スクリプトファイルのバージョンパラメータを変更する（2018年5月27日 更新）

Java Scriptやスタイルシートの指定を直接head要素内に記述せず、wp_enqueue_scriptsフィルターなどを使って指定する場合、WordPressのバージョン番号が付与されている。このバージョン番号は、妥当なんだろうか。

4.2の「アクティビティ」ウィジェットに投稿以外の情報も表示する（2018年5月27日 更新）

ダッシュボードの「アクティビティ」ウィジェットは「投稿（post）」の状況を表示し、固定ページ（page）やカスタム投稿タイプの投稿記事の状況については標準では表示されない。このことに対して以前『3.8の「アクティビティ」ウィジェットに投稿以外の情報も表示する』を紹介したのだが、4.2では新しいフィルターが追加され、カスタマイズが少し容易になった。

投稿一覧に「投稿フォーマット」フィルターが追加される（2019年4月12日 更新）

WordPress 5.2 Beta2（以降5.2Beta2）のソースコードを眺めていると、投稿一覧ページのフィルター機能に「投稿フォーマット」（select要素）が追加されていた。