説明
bool | array wp_read_image_metadata( string $file )
画像ファイルのメタ情報を取得する。
パラメータ
- $pathファイルのパス名を指定。
返り値
IPTCまたはEXIF情報を取得できた場合は連想配列を、それ以外はfalseを返す。
注意
PHPのiptcparse関数およびexif_read_data関数を使用するため、それらが使用できないPHP環境の場合は有効に機能しない。
IPTCとEXIF情報の両方を取得できた場合、同義の項目はIPTC情報が優先される。
メタ情報 | IPTC | EXIF |
---|---|---|
$meta['title'] | $iptc['2#105'] または $iptc['2#005'] または $iptc['2#120'] | $exif['ImageDescription'] |
$meta['caption'] | $iptc['2#120'] | $exif['COMPUTED']['UserComment'] または $exif['ImageDescription'] または $exif['Comments'] |
$meta['credit'] | $iptc['2#110'] または $iptc['2#080'] | $exif['Artist'] または $exif['Author'] |
$meta['copyright'] | - | $exif['Copyright'] |
$exif['FNumber'] | - | $exif['FNumber'] |
$meta['camera'] | - | $exif['Model'] |
$meta['created_timestamp'] | $iptc['2#055'] と $iptc['2#060'] | $exif['DateTimeDigitized'] |
$meta['focal_length'] | - | $exif['FocalLength'] |
$meta['iso'] | - | $exif['ISOSpeedRatings'] |
$meta['shutter_speed'] | - | $exif['ExposureTime'] |
$meta['orientation'] | - | $exif['Orientation'] |
$meta['copyright'] | $iptc['2#116'] | - |
$meta['keywords'] | $iptc['2#025'] | - |
使用例
- 画像ファイルのメタ情報を取得する。
フィルター
[2.5.0]EXIF情報を取得する前に'wp_read_image_metadata_types'フィルターを呼び出す。パラメータ$image_typesはEXIFに対応するイメージタイプの配列が格納されている。$exif_image_types = apply_filters( 'wp_read_image_metadata_types', $image_types );
return apply_filters( 'wp_read_image_metadata', $meta, $file, $image_type, $iptc, $exif );
アクション
直接実行するアクションはありません。ソースファイル
/wp-admin/includes/image.php最終更新 : 2019年06月14日 11:22
関連
お勧め
Login rebuilder:プラグイン作ってみました(2024年11月7日 更新)
昨年投稿した「ログインページを変える」をプラグイン化。ログインページを独自の名前のページ変更し、標準のログインページwp-login.phpを使用できないようにするプラグインです。部外者によるwp-login.phpのアクセスにお悩みの方にお勧めします。また2.0.0では「XML-RPCリクエストの管理機能」を追加。2.2.0では管理者のログイン時にメールで通知する機能を追加しました。管理画面の'アイキャッチ画像'を'写真'に変える(2013年1月23日 更新)
クライアント向けに専用のテーマを提供する際、稀に管理画面内の用語の変更を依頼されることがある。今回は、'アイキャッチ画像'だとわかりにくいので'写真'に変えてほしいということだった。カスタムフィールド関連関数のおさらい(2012年6月22日 更新)
カスタムフィールドは、投稿記事の拡張情報としてよく利用されている。投稿ページで登録した情報をアーカイブや投稿ページで表示しているが、投稿ページを表示する際にカスタムフィールドの値を更新して、サイドバーのようなページ内要素に利用したりしている。5.3への準備:投稿写真を使っているサイトは準備しておこう(2019年10月10日 更新)
この記事は先日公開した「5.3の新機能:JPEG画像の向きを調整」の続きのようなものになる。高解像度の投稿写真を扱っているサイトは、5.3のリリースに合わせて対応を検討しておくべきことをまとめてみた。
ブロックエディターで現在の「ロケール」を取得した時のメモ(2024年8月10日 更新)
ブロックエディター向けのプラグインで日本語固有の機能を実装する際、現在のロケール(言語)を取得したい。ブロックエディターの編集時、投稿を編集しているユーザーの言語が優先され、それをどうやって取得するかを「ChatGPT」に聞いてみたのだが。。。