wp_get_original_image_path

説明

string | false wp_get_original_image_path( int $attachment_id [ , bool $unfiltered = false ] )
オリジナルの画像ファイルのパス名を取得する。

パラメータ

  • $attachment_id
    メディア(添付ファイル)の投稿IDを指定。
  • $unfiltered
    [5.4.0] get_attached_file関数の第2パラメータを指定(省略時はfalse)。

返り値

パラメータ$attachment_idが有効な場合はアップロードされたオリジナルの画像ファイルのパス名を返す。無効な場合はfalseを返す。

注意

5.3.0ではJPEGファイルの向き情報を検知し、必要に応じて向きを調整する機能が追加された。向きが調整された場合、オリジナルファイルはそのまま残し、向きを調整して作られたファイルがメディアの投稿情報に紐づけられる。そんなオリジナルの画像ファイルのパス名を取得する目的で追加されたのが本関数である。

[5.4.0]パラメータ$unfilteredは、画像ファイルのパス名を取得する際に呼び出すget_attached_file関数の第2パラメータとなる。


使用例

  • メディアの投稿IDが41のオリジナルの画像ファイルのパス名を取得する
    <?php $path = wp_get_original_image_path( 41 ); ?>

フィルター

[5.3.0]パス名を返す前に'wp_get_original_image_path'フィルターを呼び出す。パラメータ$original_imageにはパス名が、$attachment_idには本関数が受け取ったメディアの投稿IDが格納されている。
return apply_filters( 'wp_get_original_image_path', $original_image, $attachment_id );

アクション

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

ソースファイル

/wp-includes/post.php

最終更新 : 2020年04月02日 16:53



お勧め

5.3の新機能:日付とタイムゾーン(2019年10月2日 更新)

WordPress 5.3 Beta 1」に記載されていた「Time/Date component fixes」という見出し。開発者向として新しい関数の追加や多くのバグが修正されたとなっており、チェックせざるを得ない。

PHPとMySQLのバージョンを確認(2013年9月11日 更新)

先日、WordPressで構築されたサイトについて最新版へのバージョンアップを依頼される。使用されていたWordPressはバージョン2.xということで、最新版へバージョンアップできるのか、PHPとMySQLのバージョンを確認することになった。

ACF(Advanced Custom Fields)向けにデータをインポートした時のメモ(2023年7月11日 更新)

ACFを採用するサイトにデータをインポートする際、ほとんどのことはwww.advancedcustomfields.comに記載されていたのだが、いくつかわからないことがあった。ここでは、その時に調べたことをメモしておく。

不要なプラグインを読み込まない(2023年6月2日 更新)

稼働中のサーバーにてバックグラウンドで何か処理しようとコマンドラインのプログラムを作る際、効率化や誤動作のリスクを考えると不要なプラグインはロードしないようにしたい。そんなわけで設定内容(データベース)は変更せず、特定のプラグインをロードしないようにできないか考えてみた。

Align widgets horizontally:プラグイン作ってみました(2024年2月28日 更新)

ほぼ毎日何度も見ているダッシュボードページ。自分好みに各ウィジェットの場所を配置しているものの、何かすっきりしない。そこでふと思ったのが、ウィジェットを横並びにできれば隣り合うウィジェットの並びがガタガタしなくなるのでは!?