add_submenu_page - サブメニューを登録する

説明

サブメニューを登録する。

パラメータ

• $parent_slug
  親メニューのスラッグ。
• $page_title
  サブメニューページのタイトル。
• $menu_title
  プルダウンに表示されるメニュー名。
• $capability
  サブメニューの権限（レベル数または権限名）。
• $menu_slug
  サブメニューのスラッグ。
• $function
  サブメニューページのコールバック関数。

返り値

サブメニューが登録できた場合はフック名を返す。ログインしているユーザーが指定された権限を所有していない場合はfalseを返す。

注意

パラメータ$parent_slugは親メニューのスラッグで、add_menu_page関数で登録できるプラグインやテーマの専用メニューの場合には__FILE__が利用されることが多い。 パラメータ$capabilityは、サブメニューを使用できるレベルまたは権限を指定できる（「LevelとCapability」を参照）。 パラメータ$menu_slugにはサイト内でユニークなサブメニューのスラッグを指定する（このスラッグは、サブメニューページのURLのパラメータとなる）。

使用例

• プライベートのmytheme_propertiesメニューにmytheme_settingサブメニューを登録する。
  <?php add_submenu_page( 'mytheme_properties', '基本設定', '基本設定', 'edit_themes', 'mytheme_setting', 'mytheme_setting' ); ?>
• プライベートのmytheme_propertiesメニューにmytheme_settingサブメニューを登録する（コールバック関数がメソッドの場合）。
  <?php add_submenu_page( 'mytheme_properties', '基本設定', '基本設定', 'edit_themes', 'mytheme_setting', array( &$this, 'mytheme_setting' ) ); ?>
• カスタム投稿タイプ'tools'のメニューにadvanced_settingサブメニューを登録する（コールバック関数がメソッドの場合）。
  <?php add_submenu_page( 'edit.php?post_type=tools', 'ツールの拡張設定', '拡張設定', 'edit_themes', 'advanced_setting', array( &$this, 'advanced_setting' ) ); ?>

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-admin/includes/plugin.php

関連

• add_comments_page - コメントメニューにサブメニューを登録する
• add_dashboard_page - ダッシュボードメニューにサブメニューを登録する
• add_links_page - リンクメニューにサブメニューを登録する
• add_management_page - ツールメニューにサブメニューを登録する
• add_media_page - メディアメニューにサブメニューを登録する
• add_menu_page - メニューを登録する
• add_options_page - 設定メニューにサブメニューを登録する
• add_pages_page - 固定ページメニューにサブメニューを登録する
• add_plugins_page - プラグインメニューにサブメニューを登録する
• add_posts_page - 投稿メニューにサブメニューを登録する
• add_theme_page - 外観メニューにサブメニューを登録する
• add_users_page - ユーザーメニューにサブメニューを登録する

参考

• 意外とかんたんなWordPressプラグインの作り方 | PLUS

お勧めコンテンツ