wp_mime_type_icon

説明

string | false wp_mime_type_icon( [ string | int $mime = 0 [ , string $preferred_ext = '.png' ] ] )
MIMEタイプまたはメディアのIDからアイコンURLを取得する。

パラメータ

  • $mime
    MIMEタイプまたはメディアの投稿IDを指定(省略時は0)。
  • $preferred_ext
    [6.5.0]AVIFファイルのパス名を指定(省略時は'.png')。

返り値

パラメータ$mimeに応じたMIMEタイプまたはメディアの投稿IDのアイコンURLを返す。

注意

パラメータ$mimeが数字の場合は、投稿タイプがメディアの投稿IDとしてその添付ファイルの拡張子からMIMEタイプを割り出す。

[6.5.0]パラメータ$preferred_extが追加され、wp-includes/images/mediaディレクトリには各MIMEタイプのSVGファイルが追加された。


使用例

  • メディアのアイコンURLを取得する
    $icon = wp_mime_type_icon( $attachment->ID );
  • MIMEタイプのアイコンURLを取得する
    $icon = wp_mime_type_icon( 'video/mp4', '.svg' );

フィルター

[2.0.0]'icon_dir'フィルターを呼び出す。パラメータ$pathにはwp-includes/images/mediaディレクトリの絶対パスが格納されている。
$icon_dir = apply_filters( 'icon_dir', $path );
[2.0.0]'icon_dir'フィルターの後に'icon_dir_uri'フィルターを呼び出す。パラメータ$uriにはwp-includes/images/mediaディレクトリのURLが格納されている。
$icon_dir_uri = apply_filters( 'icon_dir_uri', $uri );
[2.5.0]'icon_dir_uri'フィルターの後に'icon_dirs'フィルターを呼び出す。パラメータ$urisにはキーがアイコンが格納されたディレクトリの絶対パス、その値がURLとなる配列が格納されている。
$dirs = apply_filters( 'icon_dirs', $uris );
[2.1.0]アイコンURLを返す前に'wp_mime_type_icon'フィルターを呼び出す。パラメータ$iconにはアイコンURLが、$mimeにはMIMEタイプが、$post_idにはメディアの投稿IDが格納されている。
return apply_filters( 'wp_mime_type_icon', $icon, $mime, $post_id );

アクション

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

ソースファイル

/wp-includes/post.php

最終更新 : 2024年04月04日 15:04



お勧め

個人データのエクスポートメール向けに追加された新フィルター(2020年4月2日 更新)

先週「WordPress 5.4 RC3」が公開され、正式リリースまであと1週間。ブロックエディターの機能強化が目立つわけですが、地味な変更点もちらほらと。今回はその中の1つ、「個人データのエクスポート」機能に関連するフィルターを紹介する。

決まった値を返すだけの関数群(2018年5月27日 更新)

WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。

サイドバーの初期化はwidgets_initアクションで(2011年7月14日 更新)

ウィジェットを使ってみたくなり新テーマ「Twenty Eleven」を覗いてみると、codexに記載されていた内容と少し違っている。これって「Twenty Ten」ですでに変更されていたんだね。

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

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

favicon.icoがWordPressロゴになる!?(2020年2月25日 更新)

先週「WordPress 5.4 Beta2」が公開され、来月末には正式リリース。タイミングよく三連休だったので、1つ前の「ニュース」で紹介されていた変更点から確認してみた。