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



お勧め

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

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

wp_titleからwp_get_document_titleへ(2018年5月27日 更新)

先週、WordPress 4.4 beta1(以降4.4 beta1)が公開されました。この4.4 beta1では新テーマ「Twenty Sixteen」が追加されたほか、wp-includesディレクトリ以下のファイルが大幅に変更された感じです。

4.2で始まるiOSの絵文字ケア(2018年5月27日 更新)

WordPress 4.2のベータ1、ベータ2が立て続けにリリースされ、4.2の正式版リリースが近づいています。4.2のポイントの1つは絵文字のクロスブラウザ対応です。ここでの絵文字とは、UTF-8で4バイトのコードが割り当てられている(基本的にはiOSの)絵文字を指します。この絵文字を含んだ投稿が正しく保存できなかったり、iOS以外の環境で意図した通りに表示できないといった問題があり、4.2ではそのような問題を対処をコードが組み込まれています。

Gutenberg、「新規追加」に難あり(2018年10月25日 更新)

昨日公開した「Gutenberg、初見です」で自作プラグインの「複製」機能が正しく動作していないことについて軽く触れた。該当するプラグインを修正するにしても原因がはっきりしないと手の打ちようがない。そんなわけで、不具合の原因を調べてみた。

「テキスト」モードと「ビジュアル」モードを行き来すると投稿内容の一部が消える(2018年5月27日 更新)

仕事がらサイトの引っ越し作業のお手伝いをすることがあるのですが、今回は引っ越しにあわせてWordPressを「3.7.1」から最新版「4.1.1」にアップデートすることになりました。ここで紹介するのはこの案件で発生したトラブルの話です。