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



お勧め

ログアウト後はいつもサイトトップ(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では管理者のログイン時にメールで通知する機能を追加しました。