add_menu_page

add_menu_page - メニューを登録する

説明

mixed add_menu_page( string $page_title, string $menu_title, mixed string $capability, string $menu_slug [ , mixed $function = '' [ , string $icon_url = '' [ , int $position = NULL ] ] ] )
メニューを登録する。

パラメータ

  • $page_title
    メニューページのタイトル。
  • $menu_title
    メニュー名。
  • $capability
    メニューの権限（レベル数または権限名）。
  • $menu_slug
    メニューのスラッグ。
  • $function
    メニューページのコールバック関数。
  • $icon_url
    メニュー横に表示されるアイコンファイルのURL（省略時は''）。
  • $position
    メニューの追加位置を示す番号を指定（省略時はNULL）。

返り値

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

注意

パラメータ$capabilityは、メニューを使用できるレベルまたは権限を指定できる（「LevelとCapability」を参照）。 パラメータ$menu_slugにはサイト内でユニークなメニューのスラッグを指定する（プラグインの場合は__FILE__を指定することが多い）。 パラメータ$icon_urlに指定するアイコン画像は16×16ピクセルのイメージで、省略した場合は/wp-admin/images/generic.png'（歯車のイメージ）が適用される。

パラメータ$positionは追加するメニューを「ダッシュボード」の上にする場合は1を、「ダッシュボード」の下にする場合は2をといった感じで番号を指定する。$positionを省略した場合はNULLが適用されメニュー情報の末尾に追加される。

使用例

  • メニューを登録する。
    <?php add_menu_page( '基本設定', '基本設定', 'edit_themes', __FILE__, 'myplugin_setting' ); ?>
  • メニューを登録する（コールバック関数がメソッドの場合）。
    <?php add_menu_page( '基本設定', '基本設定', 'edit_themes', __FILE__, array( &$this, 'myplugin_setting' ) ); ?>
  • アイコンを指定してメニューを登録する。
    <?php add_menu_page( '基本設定', '基本設定', 'edit_themes', __FILE__, 'myplugin_setting', WP_PLUGIN_URL.'/myplugin/images/icon.gif' ); ?>

フィルター

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

アクション

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

ソースファイル

/wp-admin/includes/plugin.php

最終更新 : 2018年05月27日 10:53

関連

参考

Code Reference: add_menu_page

お勧め

ログアウト後はいつもサイトトップ（2018年5月27日 更新）

ログアウト後に表示（リダイレクト）されるページは、標準ではログインページ（wp-login.php）である。4.2.0ではログアウト処理後のページリダイレクト前に呼び出されるフィルターが追加された。

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

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

oEmbed対応サイトを整理した（2017年11月18日 更新）

投稿記事にTwitterやYouTubeのURL（アドレス）を記述したとき、表示されるページにはリンクとしてではなく、埋め込んだURLの内容が表示される。この仕組み（機能）はoEmbedというもので、対応サイトは随時バージョンアップしている。

投稿内容に応じてwpautopを制御する（2013年8月13日 更新）

投稿内容を表示する the_content関数では、 wpautop関数がフィルターの1つとして呼び出され、改行をbrタグに変換したり、pタグで調整したりする。この機能自体は便利なのだが、きちんとデザインされたHTMLソースを流し込んだ場合はこの機能は好ましくない。そんなわけで、記事内容に応じてwpautop関数を制御できないか考えてみた。

Login rebuilder：プラグイン作ってみました（2019年9月7日 更新）

昨年投稿した「ログインページを変える」をプラグイン化。ログインページを独自の名前のページ変更し、標準のログインページwp-login.phpを使用できないようにするプラグインです。部外者によるwp-login.phpのアクセスにお悩みの方にお勧めします。また2.0.0では「XML-RPCリクエストの管理機能」を追加。2.2.0では管理者のログイン時にメールで通知する機能を追加しました。