wp_enqueue_media

（3.5.0以降）
wp_enqueue_media - メディアJS APIに必要なスクリプトなどをエンキューする

説明

void wp_enqueue_media( [ array $args = array() ] )
メディアJS APIに必要なスクリプト、スタイル、設定、テンプレートをエンキューする。

パラメータ

  • $args
    メディアスクリプト向けのパラメータを連想配列で指定（省略時はarray()）。

返り値

返り値はありません。

注意

メディアページを拡張する際、自身が用意したJavaScriptファイルをエンキューする前に呼び出す。なお重複してエンキューしないよう'wp_enqueue_media'アクションが実行済みの場合は何もしないようになっている。

'media_view_settings'および'media_view_strings'フィルターを使用することで、独自の情報を自身が用意したJavaScriptで利用できる。

使用例

  • メディアJS APIに必要なスクリプトなどをエンキューする。
    wp_enqueue_media();

フィルター

[2.5.0]互換性を維持するため'media_upload_tabs'フィルターを呼び出す。パラメータ$tabsには以前使用されていたタブ情報の連想配列が格納されている。 
$tabs = apply_filters( 'media_upload_tabs', $tabs );
[4.7.4]'media_library_show_audio_playlist'フィルターを呼び出す。パラメータ$showには初期値としてtrue（[4.8.0]nullからtrueに変更）が格納されている。 
$show_audio_playlist = apply_filters( 'media_library_show_audio_playlist', $show );
[4.7.4]'media_library_show_video_playlist'フィルターを呼び出す。パラメータ$showには初期値としてtrue（[4.8.0]nullからtrueに変更）が格納されている。 
$show_video_playlist = apply_filters( 'media_library_show_video_playlist', $show );
[4.7.4]'media_library_months_with_files'フィルターを呼び出す。パラメータ$monthsには初期値としてnullが格納されている。 
$months = apply_filters( 'media_library_months_with_files', $months );
[5.8.0]'media_library_infinite_scrolling'フィルターを呼び出す。パラメータ$infiniteには初期値としてfalseが格納されている。 
$infinite_scrolling = apply_filters( 'media_library_infinite_scrolling', $infinite );
[3.5.0]'media_view_settings'フィルターを呼び出す。パラメータ$settingsにはwp.media.view.settings（JavaScript）でアクセスできる各種情報の連想配列が、$postには対象の投稿情報（WP_Postオブジェクト）が格納されている。 
$settings = apply_filters( 'media_view_settings', $settings, $post );
[3.5.0]'media_view_strings'フィルターを呼び出す。パラメータ$stringsにはwp.media.view.l10n（JavaScript）でアクセスできる翻訳テキストの連想配列が、$postには対象の投稿情報（WP_Postオブジェクト）が格納されている。 
$settings = apply_filters( 'media_view_strings', $strings, $post );

アクション

[3.5.0]本関数を終了する前に'wp_enqueue_media'を呼び出す。 
do_action( 'wp_enqueue_media' );

ソースファイル

/wp-includes/media.php

最終更新 : 2023年05月22日 04:44

参考

Code Reference: wp_enqueue_media

お勧め

個人データのエクスポートメール向けに追加された新フィルター（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つ前の「ニュース」で紹介されていた変更点から確認してみた。