関数リファレンス/wp enqueue media

概要

すべてのスクリプト、スタイル、設定、およびテンプレートに必要なエンキューは、すべてのメディアのJavaScript APIを使用しています。

この関数は 'admin_enqueue_scripts' / en アクションフックもしくは後で、呼びださなければなりません。

使い方

<?php wp_enqueue_media( $args ); ?>

パラメータ

配列の引数。現在、唯一の引数は、'post'のみです。その値をスクリプトを設定するために使用されます。注：このパラメータを設定しない場合、アップロードファイルが投稿に添付されることはありません。

戻り値

この関数は値を返しません。

用例

デフォルトの使い方:

wp_enqueue_media();

特定のポストのためのメディアスクリプトをエンキュー:

<?php

$args = array( 'post' => 34 );

wp_enqueue_media( $args );

?>

注

以下の用途を持ちます。

• do_action() は、'wp_enqueue_media' でメディアをエンキューした後に呼び出します。
• did_action( 'wp_enqueue_media' ) この関数は一度だけ実行してください。
• apply_filters()について:
  • 'media_upload_tabs'古いthickboxメディアタブの配列を使用してプラグインが動作します。デフォルトのタブは、リセットされます。
  • 'disable_captions' キャプションが無効になるかどうかを確認する。
  • 'media_view_settings' 投稿を格納する配列を設定します。
  • 'media_view_strings'投稿をメディアビューアで使用される文字列の配列に格納します。
• wp.media（JavaScript）メディアアップローダを呼び出します。
  • Docmumentation : http://www.grafikart.fr/tutoriels/wordpress/wp-media-uploader-403 (French video)

更新履歴

導入: 3.5.0

ソースファイル

wp_enqueue_media() は wp-includes/media.phpにあります。

外部リソース

• [1]WordPress 3.5の新メディアアップローダーを自作プラグインやテーマに組み込む。

関連

• エンキュー関数:
  • スクリプト:wp_register_script(),wp_deregister_script(), wp_enqueue_script(), wp_dequeue_script() /en, wp_script_is() /en, wp_localize_script(), wp_enqueue_media()
  • スタイル: wp_register_style(),wp_deregister_style() /en,wp_enqueue_style(),wp_dequeue_style(), wp_style_is() /en

• エンキューアクション:
  • フロントエンド: wp_enqueue_scripts /en, wp_print_scripts /en, wp_print_styles /en
  • 管理画面: admin_enqueue_scripts /en, admin_print_scripts / en, admin_print_styles /en
  • ログイン: login_enqueue_scripts /en

関数リファレンス、テンプレートタグ目次もご覧ください。

最新英語版： WordPress Codex » Function_Reference/wp_enqueue_media （最新版との差分）