説明
パラメータ
- $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のパラメータとなる)。
[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
関連
お勧め
標準で使用できる数少ないショートコード[caption]とは(2018年5月27日 更新)
画像をアップロードして「投稿に追加」ボタンをクリックすると、投稿記事内にリンク付きのimgタグか、ショートコードのが挿入される。ここではそれらの書式を整理する。WP_List_Tableクラスを使ってみた(2018年5月27日 更新)
WordPressの管理画面ではデータを一覧表示しているページがいくつもある。今回この仕組みを自分のプラグインでも使ってみたいと思い、調査しながらプラグインに組み込んでみた。
投稿ページでユニークなテンプレートを選択しよう(2018年5月27日 更新)
4.7の変更点に「投稿タイプテンプレート」がある。これは従来固定ページ('page')向けに任意のテンプレートを適用できる機能が拡張されたもので、投稿ページ('post')はもちろんカスタム投稿タイプのページにも適用可能になっている。
カスタムブロックを作っていると、ブロック自身の「サイズ」を指定するUIを持たせることがある。そんなときにちょっとモヤっとするのが、「マージン」や「パディング」の設定しているパネルのタイトルが「サイズ」なこと。この「サイズ」の原文は「Dimensions」であり、個人的にもう少しスッキリするワードに変更してみた。
管理画面でツールバー(Admin bar)を非表示にする(2013年3月5日 更新)
WordPress使ってちょっと変わったサイトを構築する際、管理画面のツールバーを表示させたくないケースがある。一般に公開するサイト側であれば、 show_admin_bar関数で非表示にできるのだが、管理画面ではこれを使ってもツールバーは消えてくれない。