add_plugins_page

add_plugins_page - プラグインメニューにサブメニューを登録する

説明

mixed add_plugins_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を返す。

注意

この関数は、内部で親メニューのスラッグに'plugins.php'を指定して add_submenu_page関数を呼び出している。

パラメータ$capabilityは、サブメニューを使用できるレベルまたは権限を指定できる（「LevelとCapability」を参照）。

パラメータ$menu_slugにはサイト内でユニークなサブメニューのスラッグを指定する（このスラッグは、サブメニューページのURLのパラメータとなる）。

http://ドメイン/wp-admin/plugins.php?page=[$menu_slugの値]

[5.3.0]パラメータ$positionが追加された。0が指定された場合はサブメニューの最上位に、nullかサブメニュー数以上の場合は末尾に追加される。メニュー数未満の場合、array_slice関数を使ってサブメニューの配列が分割され、分割された位置に挿入される（1の場合なら2番目となる）。

使用例

  • プラグインメニューにmyplugin_settingサブメニューを登録する。
    <?php add_plugins_page( 'マイプラグイン設定', 'マイプラグイン設定', 'edit_themes', 'myplugin_setting', 'myplugin_setting' ); ?>
  • プラグインメニューにmyplugin_settingサブメニューを登録する（コールバック関数がメソッドの場合）。
    <?php add_plugins_page( 'マイプラグイン設定', 'マイプラグイン設定', 'edit_themes', 'myplugin_setting', array( &$this, 'myplugin_setting' ) ); ?>

フィルター

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

アクション

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

ソースファイル

/wp-admin/includes/plugin.php

最終更新 : 2022年06月27日 09:22

関連

参考

Code Reference: add_plugins_page

お勧め

WP_List_Tableクラスの「一括操作」フォームを使ってみた（2018年5月27日 更新）

今回は「WP_List_Tableクラスを使ってみた」の続き。投稿一覧やプラグインページなどにある「一括操作」（Bulkアクション）フォーム対応に関するメモである。

wp_titleからwp_get_document_titleへ（2018年5月27日 更新）

先週、WordPress 4.4 beta1（以降4.4 beta1）が公開されました。この4.4 beta1では新テーマ「Twenty Sixteen」が追加されたほか、wp-includesディレクトリ以下のファイルが大幅に変更された感じです。

WordPressのコーディングスタンダードとPSR-2がかみ合わない（2018年5月27日 更新）

先日パソコンのストレージを換装して開発環境を再構築。エディタのEclipseは「Neon（4.6）」から「Oxygen（4.7）」へ切り替わった。コードを書き始めるとそこはかとなく違和感があり、調べていくとPHPの「Code Style（Formatter）」が「PSR-2」に設定されていることが原因だった。

カテゴリー専用の投稿一覧と新規投稿メニューを追加する（2012年1月23日 更新）

サイト更新の1クリックを省くため、特定カテゴリーの投稿に対して同じようにメニューを追加してみた。カスタム投稿タイプの専用投稿メニューみたいな感じである。

さくらのVPSでKUSANAGI#3（2018年5月27日 更新）

今回は「前回」の続き。http（80番）をクローズ、そのほかに行った調整作業について整理する。