WordPress管理画面のメニューに項目を追加する方法解説

2014/06/16 2015/06/15

WordPressの管理画面のメニューに項目を追加する方法

管理画面のメニューは menu-header.phpだけども．．．

　
WordPressの管理画面のメニューは、「/wp-admin/menu-header.php」ファイルで処理されていますので、直球勝負ならこのファイルを変更することで対応できます。
　
このファイルの下の方にある

do_action( 'adminmenu' );
?>

1 2	do_action( 'adminmenu' ); ?>

の下あたりに、下記のような感じで HTMLを追加すれば、メニューを追加することができます。
—————

<div class="wp-menu-toggle"><br /></div>
<li class="wp-has-submenu menu-top menu-top-last" id="menu-settings">
  <div class='wp-menu-image'><a href='options-general.php'><br /></a></div>
  <div class="wp-menu-toggle"><br /></div>
  <a href='index2.php' class="wp-has-submenu menu-top menu-top-last" tabindex="1">親メニュー</a>
  <div class='wp-submenu'>
    <div class='wp-submenu-head'></div>
    <ul>
      <li class="wp-first-item"><a href='index2.php' class="wp-first-item" tabindex="1">子メニュー</a></li>
      <li class="wp-first-item"><a href='index3.php' class="wp-first-item" tabindex="1">子メニュー</a></li>
    </ul>
  </div>
</li>

<a href='index2.php' class="wp-has-submenu menu-top menu-top-last" tabindex="1">親メニュー</a>

<ul>

<li class="wp-first-item"><a href='index2.php' class="wp-first-item" tabindex="1">子メニュー</a></li>

<li class="wp-first-item"><a href='index3.php' class="wp-first-item" tabindex="1">子メニュー</a></li>

</ul>

</div>

</li>

—————
　
ですが、このファイルは、WordPressのバージョンアップを行うと、差し替えられてしまうファイルですので、基本的には修正を行わないファイルです。
（上記の HTMLを追記しても、バージョンアップの度に消えてしまいますので、その都度対応が必要になってきます。）
　
　

「add_action ( ‘admin_menu’, ‘function名’ );」でメニューを追加する

　
ではどうするか？
　
WordPressには、管理画面のメニューに項目を追加する機能も用意されていますのでそれを使って項目を追加します。
　
具体的には「functions.php」に
————-
add_action ( ‘admin_menu’, ‘function名’ );
————-
の関数を用いて、メニューを追加していきます。
　
※functions.phpがある場所
/{WordPressがインストールされている場所}/wp-content/themes/{テーマ名}/functions.php
　　詳細は「WordPressの functions.phpがある場所」を参照
　
　

本格ビジネスサイトを作りながら学ぶ WordPressの教科書 Ver.4.x対応版

「add_action ( ‘admin_menu’, ‘function名’ );」のサンプルコード

　
—————————-

add_action ( 'admin_menu', 'artist_add_pages' );

function artist_add_pages () {
  add_menu_page('テストタイトル', 'テストメニュー', 8, 'index2.php', 'test_page');
  add_submenu_page('index2.php', 'テストタイトルサブ', 'テストメニューサブ', 8, 'index3.php', 'test_page');}

function test_page() {
    echo '<h2>メニュー追加テストページ</h2>';
}

add_action ( 'admin_menu', 'artist_add_pages' );

function artist_add_pages () {

add_menu_page('テストタイトル', 'テストメニュー', 8, 'index2.php', 'test_page');

add_submenu_page('index2.php', 'テストタイトルサブ', 'テストメニューサブ', 8, 'index3.php', 'test_page');}

function test_page() {

echo '<h2>メニュー追加テストページ</h2>';

}

—————————-
　
上記のコードを「functions.php」にコピペすることで、下記の様にメニューが追加されます。
　

　
また、リンク先の URLは「http://*******/wp-admin/admin.php?page=index2.php」となり、リンク先のページのタイトルは「<title>テストタイトル ‹ テスト — WordPress</title>」となっています。
　
　
add_menu_page関数、add_submenu_page関数の解説は、以下の通りです。
　
add_menu_page関数は、トップレベルのメニュー追加（メニューの一番下に追加）の際に利用します。
add_submenu_page関数は、上記で追加した親メニューの子メニューとして追加する際に利用します。
　
引数の順番と意味は、下記の通りとなっています。

add_menu_page('HTML のページタイトル', 'メニュータイトル', 'ユーザレベル', 'リンク先', 'リンクの引数');

add_submenu_page('親メニューのリンク先', 'HTML のページタイトル', 'メニュータイトル', 'ユーザレベル', 'リンク先', 'リンクの引数');

add_menu_page('HTML のページタイトル', 'メニュータイトル', 'ユーザレベル', 'リンク先', 'リンクの引数');

add_submenu_page('親メニューのリンク先', 'HTML のページタイトル', 'メニュータイトル', 'ユーザレベル', 'リンク先', 'リンクの引数');

　
HTML のページタイトル：リンク先のページの titleタグに編集される値
メニュータイトル：管理画面のメニューに表示されるテキスト
ユーザレベル：ユーザの管理権限によって表示する、しないの条件設定
　　　　「ユーザーの種類と権限」については、オフィシャルサイトを参照してください。
　　　　http://wpdocs.sourceforge.jp/%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%AE%E7%A8%AE%E9%A1%9E%E3%81%A8%E6%A8%A9%E9%99%90
リンク先：リンク先のファイル名
リンクの引数：リンク先のファイル名に引数を指定する場合に指定
親メニューのリンク先：リンク先のファイル名に引数を指定する場合に指定
　
※add_menu_page関数は /wp-admin/includes/plugins.php 893 行目で定義されています。
※add_submenu_page関数は /wp-admin/includes/plugins.php 998 行目で定義されています。
　
　
上記サンプルの 4行目の add_menu_pageの 5番目の引数を nullにして下記の様に設定することで、リンク先の URLを「http://*******/wp-admin/index2.php」にすることもできます。
　

  add_menu_page('テストタイトル', 'テストメニュー', 8, 'index2.php', '');

1	add_menu_page('テストタイトル', 'テストメニュー', 8, 'index2.php', '');

項目ごとにメニューを追加する方法

　
WordPressの管理画面メニューには、add_menu_page関数、add_submenu_page関数以外にも多くの関数が用意されています。
それぞれの項目で、サブメニューを設定したい場合は、上記で説明した「add_submenu_page」を使うことで設定することができます。
　
—————————-

function artist_add_pages () {

  // トップレベルメニュー追加（メニューの一番下に追加される）
  add_menu_page('テストページタイトル', 'テストメニュー', 8, 'sample.php', 'test_page');

  // 「テストメニュー」にサブメニューを追加
  add_submenu_page('sample.php', 'テストページタイトル', 'サブメニュー', 8, 'sub_test.php', 'test_page');

  // トップレベルメニュー追加（コメントの下に追加される）
  add_object_page('テストページタイトル', 'テストメニュー2', 8, 'sample2.php', 'test_page');

  // トップレベルメニュー追加（設定の下に追加される）
  add_utility_page('テストページタイトル', 'テストメニュー3', 8, 'sample3.php', 'test_page');

  // 「ダッシュボード」の項目にサブメニュー追加
  add_dashboard_page('テストページタイトル', 'ダッシュボードメニュー', 8, 'test', 'test_page');

  // 「投稿」の項目にサブメニューを追加
  add_posts_page('テストページタイトル', '投稿メニュー', 8, 'test', 'test_page');

  // 「ページ」の項目にサブメニューを追加
  add_pages_page('テストページタイトル', 'ページメニュー', 8, 'testpage', 'test_page');

  // 「メディア」の項目にサブメニューを追加
  add_media_page('テストページタイトル', 'メディアメニュー', 8, 'test', 'test_page');

  // 「コメント」の項目にサブメニューを追加
  add_comments_page('テストページタイトル', 'コメントメニュー', 8, 'test', 'test_page');

  // 「プラグイン」の項目にサブメニューを追加
  add_plugins_page('テストページタイトル', 'プラグインメニュー', 8, 'test', 'test_page');

  // 「ユーザー」の項目にサブメニューを追加
  add_users_page('テストページタイトル', 'ユーザーメニュー', 8, 'test', 'test_page');

  // 「設定」の項目にサブメニューを追加
  add_options_page('テストページタイトル', '設定メニュー', 8, 'test', 'test_page');

  // 「ツール」の項目にサブメニューを追加
  add_management_page('テストページタイトル', 'ツールメニュー', 8, 'test', 'test_page');

  // 「外観」の項目にサブメニューを追加
  add_theme_page('テストページタイトル', '外観メニュー', 8, 'test', 'test_page');

}

function artist_add_pages () {

// トップレベルメニュー追加（メニューの一番下に追加される）

add_menu_page('テストページタイトル', 'テストメニュー', 8, 'sample.php', 'test_page');

// 「テストメニュー」にサブメニューを追加

add_submenu_page('sample.php', 'テストページタイトル', 'サブメニュー', 8, 'sub_test.php', 'test_page');

// トップレベルメニュー追加（コメントの下に追加される）

add_object_page('テストページタイトル', 'テストメニュー2', 8, 'sample2.php', 'test_page');

// トップレベルメニュー追加（設定の下に追加される）

add_utility_page('テストページタイトル', 'テストメニュー3', 8, 'sample3.php', 'test_page');

// 「ダッシュボード」の項目にサブメニュー追加

add_dashboard_page('テストページタイトル', 'ダッシュボードメニュー', 8, 'test', 'test_page');

// 「投稿」の項目にサブメニューを追加

add_posts_page('テストページタイトル', '投稿メニュー', 8, 'test', 'test_page');

// 「ページ」の項目にサブメニューを追加

add_pages_page('テストページタイトル', 'ページメニュー', 8, 'testpage', 'test_page');

// 「メディア」の項目にサブメニューを追加

add_media_page('テストページタイトル', 'メディアメニュー', 8, 'test', 'test_page');

// 「コメント」の項目にサブメニューを追加

add_comments_page('テストページタイトル', 'コメントメニュー', 8, 'test', 'test_page');

// 「プラグイン」の項目にサブメニューを追加

add_plugins_page('テストページタイトル', 'プラグインメニュー', 8, 'test', 'test_page');

// 「ユーザー」の項目にサブメニューを追加

add_users_page('テストページタイトル', 'ユーザーメニュー', 8, 'test', 'test_page');

// 「設定」の項目にサブメニューを追加

add_options_page('テストページタイトル', '設定メニュー', 8, 'test', 'test_page');

// 「ツール」の項目にサブメニューを追加

add_management_page('テストページタイトル', 'ツールメニュー', 8, 'test', 'test_page');

// 「外観」の項目にサブメニューを追加

add_theme_page('テストページタイトル', '外観メニュー', 8, 'test', 'test_page');

}

—————————-

- WordPress

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: Custom Post Type UIでカスタムタクソノミーを設定・バージョン1.4対応解説

カスタムタクソノミーをプラグインCustom Post Type UIを使って設定する方法の解説。バージョンアップにより設定する項目も増え続け、より柔軟な設定が可能に。

: WP jQuery LightBoxでWordPressの画像を簡単に見やすくする方法解説

画像のリンクに対して LightBox効果を簡単に追加するプラグイン。インストールして数項目にチェックを入れるだけで設定完了。属性を追加することで機能も追加できる。

: タクソノミーの一覧をショートコードで編集・ソート機能付き・wp_list_categories

カスタムタクソノミーのターム一覧をショートコードで編集する方法の解説です。Category Order and Taxonomy Terms Orderを利用してソート機能を追加したバージョンです。

: WordPressのユーザ名を後から変更する方法。adminの使用は危険。

運用中のユーザ名を変更する方法を解説。かつてのデフォルト設定だった「admin」は誰もが使うIDのため非常に危険です。今からでも変更しましょう。

: WordPressのSEOタイトル、キーワード、ディスクリプション編集解説

ヤフーやグーグルの検索結果を見ながらSEO視点でタイトル、ディスクリプションを書く際の基準を解説！スマホ対策も解説！

: WordPressのカテゴリ単位・フォルダ単位でBasic認証を設定する方法

カテゴリ単位でBasic認証を設定する方法の解説。WordPressのカテゴリはフォルダの実態がないですが、実は簡単な方法でプラグインも使わずにBasic認証を設置できます。

: WordPressのメディア設定でアップロードするファイルの保存場所を変更する方法

メディアのアップロードするファイルの保存先を変更する方法の解説。現在はオプションとなっていますので、/wp-admin/options.phpから設定します。

: Custom Field Templateで簡単にカスタムフィールドをフル活用

カスタムフィールドを簡単に設定するプラグイン。簡単にカスタムフィールドが管理で来て作業効率が数倍にアップします！

: P3（Plugin Performance Profiler）で負荷が高いプラグインを調査し表示スピードアップ！

まずは正確に現状把握を！P3（Plugin Performance Profiler）を使ってプラグインの処理時間を確認！簡単操作で対応すべきプラグインが一目瞭然になります！