メディアファイルをWordPressの投稿に挿入することは、デフォルトで表示される専用ボタンのおかげで、それほど複雑ではありません。ただし、メディアファイルを使用してプラグインを開発した場合、このボタンはユーザーが機(jī)能に必要なコードを挿入するのに役立ちません。

幸いなことに、自分のメディアボタンを追加することが可能です。そうすれば、あなたが望むことを何でもできるようにすることができます。 このチュートリアルでは、適切な場所にメディアボタンを追加する方法、ユーザーがクリックしたときにメディアウィンドウを開く方法、そして最後に、選択したアイテムを取得する方法を確認(rèn)して、それらを同時(shí)に挿入する方法を確認(rèn)します。ビジュアルエディターとHTMLエディターの両方

キーテイクアウト

WordPressコンテンツエディターにメディアボタンを追加するには、プラグインまたはテーマファイルに新しい関數(shù)を作成し、Media_Buttonsアクションに機(jī)能を引っ掛け、正しい方法でボタンを表示する機(jī)能を変更することが含まれます。

メディアウィンドウを開くには、ユーザーがボタンをクリックすると、デフォルトでWordPressに含まれているjQueryを使用してJavaScriptが使用されます。これには、WordPress関數(shù)にそれを含むJSファイルの作成やウィンドウの構(gòu)築が含まれます。

ユーザーの選択は、Media WindowsのWordPressによって作成された「選択」イベントを使用して取得できます。複數(shù)選択を許可するかどうかに応じて、選択を保存する変數(shù)の使用は異なります。

メディアボタンは、ユーザーがボタンにぶつかるたびに再構(gòu)築しないようにすることで最適化できます。これは、ウィンドウが既に作成されているかどうかを確認(rèn)することで実現(xiàn)できます。

• メディアボタンを追加
• メディアボタンを追加することは、最初で最も簡単な部分です。 WordPressで多くのことをカスタマイズするのと同様に、アクションを使用してボタンを適切な場所に配置します。
プラグインまたはテーマの専用ファイルに新しい関數(shù)を作成することから始めます（たとえば、functions.php）。このチュートリアルでは、add_my_media_button（）という名前の関數(shù)を使用します。その名前が示唆するように、WordPressがメディアボタンを表示しているときに呼び出されるアクションであるMedia_buttonsアクションに機(jī)能をフックします。
想像できるように、正しい方法でボタンを表示するために関數(shù)を変更する必要があります。ボタンをデフォルトのスタイルと同じスタイルにしたいです。
• メディアボタンは本物のボタンではありません。ボタンのスタイルとのリンクであり、WordPressはこのスタイルのクラスを提供します。

ボタンをIDにします。そうすれば、後でjavascriptでそれを取得することができます。

カスタムメディアボタンの準(zhǔn)備ができました。適切なスタイルとほぼ適切な場所があります。実際、デフォルトでは、新しいボタンはデフォルトのボタンの前に配置されます。後に配置したい場合は、関數(shù)の優(yōu)先順位を変更するために、3番目の引數(shù)をadd_action（）に渡すことで可能です。

実際には、デフォルトのメディアボタンを表示する関數(shù)の優(yōu)先度は10です。関數(shù)の値が低いことを示します。後に配置したい場合は、より大きな価値を示すことができます。

<span>add_action('media_buttons', 'add_my_media_button');</span>

そしてそれだけです！今、私たちはボタンをもっと便利にする必要があります。

メディアウィンドウを開きます

メディアウィンドウを開くには、javaScriptをjqueryで使用します。これは、デフォルトでWordPressに含まれています。まず、JSファイルを作成します。私はそれをmedia_button.jsという名前に選びましたが、もちろん、あなたはあなた自身の名前を自由に選ぶことができます。

javaScriptファイルを含めます

WordPressに精通している場合は、CMSが必要なJSファイルを含める適切な方法を提供することを知っておく必要があります。そのために、WordPress関數(shù)wp_enqueue_script（）を使用する関數(shù)を作成します。

ご覧のとおり、jQueryを依存関係として示しています。最後の引數(shù)のおかげで、私はフッターにスクリプトを含めることを選択しましたが、あなたが望むなら、あなたはそれをヘッダーに置くことができます。

WordPressに、必要な場合にのみWordPressに含めるように依頼するための関數(shù)を作成しました。そのためには、別のアクションを使用します：WP_ENQUEUE_MEDIA。これは、WordPressがメディアボタンで必要なすべてのスクリプトを呼び出すときにトリガーされます。

<span>function add_my_media_button() {
</span>    echo <span>'<a href="#"  >Add my media</a>';
</span><span>}</span>

ウィンドウを作成します

jQuery関數(shù)$（）を使用できるようにするには、jQuery（）関數(shù)のmedia_button.jsファイルのコンテンツをカプセル化します。次に、ユーザーがボタンをクリックするとメディアウィンドウを開く新しい機(jī)能を作成します。

<span>add_action('media_buttons', 'add_my_media_button', 15);</span>

メディアウィンドウは、WP.Mediaオブジェクトのインスタンスです。そのコンストラクターは、ウィンドウのいくつかの屬性を含む別のオブジェクトである1つのパラメーターを認(rèn)めます。したがって、上記のopen_media_window_（）関數(shù)には以下が含まれる場合があります

タイトル屬性は、ウィンドウのタイトルとして表示されます。注意してください

ライブラリ屬性は、WordPressによって使用され、ウィンドウに表示されるメディアファイルをフィルタリングします。この例では、畫像のみを選択できます。さらに、ユーザーは、複數(shù)の屬性の誤った値のおかげで複數(shù)のファイルを選択することはできません。

これらの屬性のいずれも、WordPressで実際に必要とされていません。ただし、タイトルを示していない場合、ウィンドウは無題になります。デフォルトでは、複數(shù)の屬性がfalseに設(shè)定され、表示されているメディアファイルはフィルタリングされていません。

<span>function include_media_button_js_file() {
</span>    <span>wp_enqueue_script('media_button', 'path/to/media_button.js', array('jquery'), '1.0', true);
</span><span>}</span>

メディアウィンドウを使用

ユーザーの選択を取得

<span>add_action('wp_enqueue_media', 'include_media_button_js_file');</span>

次のコードは、上記で作成したopen_media_window（）関數(shù)內(nèi)に入ります。

現(xiàn)時(shí)點(diǎn)では、窓は構(gòu)築されていますが、開かれていません。ウィンドウを開くには、Open（）メソッドを使用できますが、前にユーザーの選択を取得することをお勧めします。

それを行うには、Media WindowsのWordPressによって作成された特別なイベントを使用します：選択します。このイベントに関數(shù)を添付する必要がありますon（）メソッドの使用が必要です。

ユーザーの選択は、変數(shù)選択に保存されます。複數(shù)選択を許可するかどうかに応じて、この変數(shù)の使用は異なります。

<span>add_action('media_buttons', 'add_my_media_button');</span>

ユーザーが1つのファイルのみを選択できる場合、最初の（）メソッドでそれを取得できます。次に、取得したオブジェクトをJSONに変換して、必要な情報(bào)を取得できます。上記のウィンドウを交換します

このJSONオブジェクトには、選択したファイルについて必要なものすべてが含まれています。たとえば、ファイルのURLがURL屬性を介してアクセスできる間に、ID屬性を使用してファイルのIDにアクセスできます。

使用できる屬性を知りたい場合は、たとえば、ブラウザのコンソールにすべてをリストできます。

<span>function add_my_media_button() {
</span>    echo <span>'<a href="#"  >Add my media</a>';
</span><span>}</span>

ユーザーが複數(shù)のファイルを選択できる場合、選択を配列に変換できます。次に、最初のケースとまったく同じように、tojson（）メソッドで各ファイルのデータを取得できます。上記のウィンドウを交換します

ファイル配列がソートされます。0エントリには、ユーザーが選択した最初のファイル、1エントリには2番目のファイルなどが含まれます。

編集者にテキストを挿入

<span>add_action('media_buttons', 'add_my_media_button', 15);</span>

ユーザーの選択を取得したので、エディターにテキストを挿入します。そのために、WordPress関數(shù)wp.media.editor.insert（）を使用します。これは、1つのパラメーターを認(rèn)めます。カーソルの現(xiàn)在の位置に挿入するテキスト。

この関數(shù)を使用する利點(diǎn)は、WordPressがビジュアルエディターとHTMLエディターの両方にテキストを自動的に挿入することです。

<span>function include_media_button_js_file() {
</span>    <span>wp_enqueue_script('media_button', 'path/to/media_button.js', array('jquery'), '1.0', true);
</span><span>}</span>

最適化

ウィンドウを使用する準(zhǔn)備ができました。ただし、問題は続きます。ユーザーがボタンにぶつかるたびに再構(gòu)築されるため、この動作を変更します。

最初に、ウィンドウが既に作成されているかどうかを確認(rèn)し、そうでない場合は作成します。次に、ウィンドウを開き、Open_Media_Window（）関數(shù)がinstrument return falseで終了します。リンクのデフォルトの動作を防ぐため。

上記の問題を防ぐ方法が複數(shù)あることに注意してください。ただし、スキームは常に同じであり、お?dú)荬巳毪辘畏椒à蚝唴gに適応させることができます。 結(jié)論

<span>add_action('wp_enqueue_media', 'include_media_button_js_file');</span>

メディアボタンを追加する方法と、エディターでのユーザーの選択に関連するテキストを挿入する方法を使用する方法がわかりました。上記で作成したデータ変數(shù)の屬性をリストした場合、WordPressが選択したメディアファイルに関するすべての情報(bào)を提供していることに気付いたかもしれません。コンテンツエディターにメディアボタンを追加することについて、よく尋ねられる質(zhì)問（FAQ）

なぜ私の「メディアの追加」ボタンがWordPressで動作しないのですか？

「メディアの追加」ボタンがWordPressで動作しない理由がいくつかある可能性があります。最も一般的な理由は、プラグインの競合です。一部のプラグインは、「メディアの追加」ボタンの機(jī)能を妨げる場合があります。これを解決するために、すべてのプラグインを無効にしてから、1つずつ再アクティブ化して問題のあるプラグインを特定できます。もう1つの理由は、時(shí)代遅れのWordPressまたはテーマバージョンです。最新のバージョンがインストールされていることを確認(rèn)してください。問題が続く場合、それはJavaScriptまたはjQueryの問題による可能性があります。この場合、プロの開発者からの助けを求める必要があるかもしれません。

WordPressのコンテンツエディターにメディアボタンを追加するにはどうすればよいですか？ WordPressは簡単なプロセスです。これを行うには、テーマのfunctions.phpファイルで「add_action」関數(shù)を使用して行うことができます。この関數(shù)を使用すると、コンテンツエディターに新しいボタンを追加できます。その後、「wp_enqueue_media」関數(shù)を使用して、メディアアップローダーに必要なスクリプトとスタイルをロードできます。最後に、ボタンがクリックされたら、「WP.Media」オブジェクトを使用してメディアアップローダーを開くことができます。コンテンツエディターのメディアボタンをカスタマイズします。さまざまなWordPress関數(shù)とフックを使用して、ボタンのテキスト、スタイル、機(jī)能を変更できます。たとえば、「media_buttons_context」フィルターを使用して、エディターのボタンの位置を変更できます。 「WP.Media」オブジェクトを使用して、メディアアップローダーの外観と動作をカスタマイズすることもできます。コンテンツエディターに「メディアの追加」ボタンが表示されないため、ユーザーの役割の制限が原因である可能性があります。 WordPressを使用すると、ユーザーの役割がWebサイトで何ができるかを制御できます。ユーザーの役割に「upload_files」機(jī)能がない場合、「メディアの追加」ボタンを表示できません。ユーザーロールエディターなどのプラグインを使用してユーザーロールの機(jī)能を変更することでこれを変更できます。コーディングに慣れていない場合、いくつかのソリューションを試して、「メディアの追加」ボタンを修正して、問題が発生していないことがあります。まず、ブラウザのキャッシュとCookieをクリアしてみてください。それがうまくいかない場合は、すべてのプラグインを無効にし、問題のあるプラグインを特定するために1つずつ再アクティブ化します。デフォルトのWordPressテーマに切り替えて、問題がテーマ関連であるかどうかを確認(rèn)することもできます。これらのソリューションが機(jī)能しない場合は、プロの開発者から助けを求めたり、WordPressサポートに連絡(luò)したりすることを検討してください。

WordPressの「メディアの追加」ボタンの代替品は何ですか？

はい、コンテンツエディターの「メディアの追加」ボタンを誰が使用できるかを制限できます。 WordPressを使用すると、ユーザーの役割がWebサイトで何ができるかを制御できます。 「メディアの追加」ボタンを特定のユーザーロールに制限する場合は、ユーザーロールエディターなどのプラグインを使用してユーザーロールの機(jī)能を変更することでそうすることができます。 「メディアの追加」ボタンは？

以上がWordPressコンテンツエディターにメディアボタンを追加しますの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。