attachment_url_to_postid

説明

int attachment_url_to_postid( string $url )
添付ファイルのURLから投稿IDを取得する。

パラメータ

  • $url
    添付ファイルのURLを指定。

返り値

添付ファイルの投稿IDを返す。該当する投稿が見つからなかった場合は明示的には何も返さない(nullを返す)。

注意

本関数はパラメータ$urlに指定された添付ファイルのURLからそのメディア投稿の投稿IDを取得するもので、 wp_get_attachment_url関数の真逆の機能である。メディア投稿のカスタムフィールド'_wp_attached_file'には添付ファイルのアップロードディレクトリからの相対パス名が保存されており、本関数の内部ではその相対パス名から投稿IDを取得している。

使用例

  • 添付ファイルのURLから投稿IDを取得する。
    <?php $post_id = attachment_url_to_postid( string $url ); ?>

フィルター

[4.2.0]投稿IDを返す直前に'attachment_url_to_postid'フィルターを呼び出す。パラメータ$post_idにはメディアの投稿IDが、$urlには本関数が受け取った内容が格納されている。
return (int) apply_filters( 'attachment_url_to_postid', $post_id, $url );

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/media.php

最終更新 : 2017年08月04日 17:10



お勧め

任意の名前でエラーログファイルを指定する(2019年2月15日 更新)

来週にはWordPress 5.1がリリース。RC1のソースコードを見ていると、 wp_debug_mode関数が変更されており、興味深かった。

Gutenbergでカスタムフィールドを使う(2018年8月10日 更新)

Gutenbergの新エディターではカスタムフィールドのウィジェットが表示されない。既存のカスタムフィールドのデータはなくなるわけでないので、新エディター上で編集・更新できないか調べてみた。

Slightly troublesome permalink:プラグイン作ってみました(2021年4月20日 更新)

カテゴリーを含んだパーマリンクを設定している場合、複数のカテゴリーを指定した投稿記事のパーマリンクのURLに目的のカテゴリーとは異なるカテゴリーが適用された経験はないだろうか。このプラグインは、パーマリンクに適用されるカテゴリーをコントロールし、希望通りのパーマリンクを設定します。

WP_Postオブジェクトで投稿情報を直感的に使う(2012年10月4日 更新)

WordPress 3.5で登場するであろう WP_Postクラス。WordPressの投稿情報は、投稿情報本体のほか、カテゴリーや投稿タグ、カスタムフィールドなど、いくつかに分散して記録され、それぞれの情報を取得する際は、いくつかの関数をしていた。新しいWP_Postクラスにより、その習慣とおさらばできるかもしれない。

テキストエディタの文字を変更する(2018年5月27日 更新)

テキストエディタ(投稿ページの「テキスト」タブのエディタ)に標準では備わっていない機能を追加する自作プラグイン「html entities button」がほぼ1年ぶりにアップデート。ここではバージョン2.0.0で追加したテキストエディタのフォント切り替え機能について紹介する。