説明
mixed add_media_page( string $page_title, string $menu_title, mixed string $capability, string $menu_slug [ , mixed $function = '' [, int $position = null ] ] )
メディアメニューにサブメニューを登録する。
パラメータ
- $page_titleサブメニューページのタイトル。
- $menu_titleプルダウンに表示されるメニュー名。
- $capabilityサブメニューの権限（
レベル数または権限名）。 - $menu_slugサブメニューのスラッグ。
- $functionサブメニューページのコールバック関数（省略時は''）。
- $position[5.3.0]サブメニューの位置を数値で指定（省略時はnull）。
返り値
サブメニューが登録できた場合はフック名を返す。ログインしているユーザーが指定された権限を所有していない場合はfalseを返す。注意
この関数は、内部で親メニューのスラッグに'upload.php'を指定して add_submenu_page関数を呼び出している。
パラメータ$capabilityは、サブメニューを使用できるレベルまたは権限を指定できる（「LevelとCapability」を参照）。
パラメータ$menu_slugにはサイト内でユニークなサブメニューのスラッグを指定する（このスラッグは、サブメニューページのURLのパラメータとなる）。
http://ドメイン/wp-admin/upload.php?page=[$menu_slugの値]
[5.3.0]パラメータ$positionが追加された。0が指定された場合はサブメニューの最上位に、nullかサブメニュー数以上の場合は末尾に追加される。メニュー数未満の場合、array_slice関数を使ってサブメニューの配列が分割され、分割された位置に挿入される（1の場合なら2番目となる）。
使用例
- メディアメニューにmytheme_mediaサブメニューを登録する。<?php add_media_page( 'テーマメディア', 'テーマメディア', 'edit_themes', 'mytheme_media', 'mytheme_media' ); ?>
- メディアメニューにmytheme_mediaサブメニューを登録する（コールバック関数がメソッドの場合）。<?php add_media_page( 'テーマメディア', 'テーマメディア', 'edit_themes', 'mytheme_media', array( &$this, 'mytheme_media' ) ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-admin/includes/plugin.php最終更新 : 2022年06月27日 09:41
関連
お勧め
カレンダーウィジェットをAjaxで切り替える（2011年8月22日 更新）
ウィジェットベースでテーマを構築していてカレンダーを表示してみた。標準では、前月や次月のリンク先はそれぞれの月のアーカイブページとなっているのだが、記事を探すだけであればカレンダー部分だけを更新するほうが便利なのではと考え、そのアイデアを実装してみた。3.8の「アクティビティ」ウィジェットに投稿以外の情報も表示する（2014年1月17日 更新）
ちょうど1月前の「ダッシュボードの「概要」にカスタム投稿タイプ件数を表示する」にて、WordPress 3.8新ダッシュボードの「概要」ウィジェットにカスタム投稿タイプの投稿数を表示する方法を紹介したが、今回のその続編で「アクティビティ」ウィジェットを拡張する方法を紹介する。
5.5の機能強化：コメントフォームのちょっとした改良（2020年8月12日 更新）
来月にリリースされるWordPress 5.5に向けてBeta 1、2、3と公開が続いている。「WordPress 5.5 Beta 3（以降Beta 3）」のソースコードを見ていくと、コメントフォームを表示する comment_form関数が機能拡張されていた。
5.3への準備：投稿写真を使っているサイトは準備しておこう（2019年10月10日 更新）
この記事は先日公開した「5.3の新機能：JPEG画像の向きを調整」の続きのようなものになる。高解像度の投稿写真を扱っているサイトは、5.3のリリースに合わせて対応を検討しておくべきことをまとめてみた。
画像ブロックに効果を追加した時にハマった（2023年3月30日 更新）
画像ブロックに対して見た目が変わる効果を追加しようと思い機能拡張してみた。その際、いくつかの効果は問題なかったのだが、1つの効果だけその画像を選択したときのみ効果が消える不具合が発生。対処内容はシンプルなものだが、忘れないようにメモっとく。