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 コメントをキャンセル

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

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

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

: Contact Form 7の使い方・引数で情報を受け渡す方法

Contact Form 7で引数の情報をフォームに編集する方法を解説します。

: WordPressのインストール方法・セキュリティ重視 3つのポイント

WordPressのインストールをセキュリティ重視の視点から3つのポイントの解説と設定方法です。

: WordPressの不正ログインを Force email loginで回避

WordPressのセキュリティ強化に Force email loginを使う理由と設定方法の解説をしています。

: WordPress記事のまとめ一覧・インストール、プラグイン、カスタマイズの記事

WordPress記事のまとめ。WordPressの記事が多くなってきたので記事の説明を追加した一覧記事を作成しました。各設定から機能のカスタマイズ、運用ノウハウまで参考に！

: PoeditでWordPressの日本語対応方法。英語プラグインの日本語翻訳ファイル作成

プラグインの日本語化の手順のまとめ。.pot、.po、.moファイルの解説や便利ツールの Poeditの紹介を行いつつ、手順、ファイル設置場所、注意ポイントなども紹介。

: プラグインが原因で起動しないWordPressを復旧させる方法解説

プラグインが原因で WordPressが起動できなくなった、ログインできなくなった場合の対処方法の解説です。

: Smart Update PingerでWordPressのPing・更新情報サービスを拡張する

WordPressの Ping機能、更新情報サービスのプラグイン Smart Update Pingerの使い方と問題点。

: Edit Author Slugで WordPressの不正ログイン・不正アクセスを回避

WordPressのセキュリティ強化に Edit Author Slugを使う理由と設定方法の解説をしています。

: WordPressのフォームプラグイン「MW WP FORM」でメールが送信できない不具合の対応方法

WordPressでメールフォームと言えば MW WP Form！そのMW WP Formでフォームを作成したものの、エラーでメールが送信できない！その原因と対処方法を解説。エラーが発生する意外な盲点もある。