上一篇文章中我們說到了往 WordPress 後臺 「外觀」 下面新增一個子選單項的函式 add_theme_page(), 今天這篇教程繼續介紹另一個在 WordPress 後臺新增選單頁面的函式：add_menu_page()，這個函式是往後臺新增頂級選單先，也就是和 「外觀」 、 「外掛」 等一樣的頂級選單。

函式介紹如下：

  1. <?php   
  2. add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $position );   
  3. //page_title 頁面 title 標籤資訊   
  4. //$menu_title 選單標題   
  5. //capability  許可權   
  6. //menu_slug  別名   
  7. //function  執行函式   
  8. //icon_url  選單圖示 url 地址   
  9. //position  此選單項在選單中的位置，警告：如果兩個選單項的位置屬性相同，其中一個可能要被覆蓋   
  10. ?>  

對於 function 引數，這個引數一般是函式名，如果在類中，要呼叫類的方法，使用 array(類名，函式名) 這樣的形式呼叫。如果這個引數為空的話，menu_slug 引數可以是一個檔案路徑。

上面函式的 position 引數，預設的選單項位置屬性如下：

2 Dashboard
 4 Separator
 5 Posts
 10 Media
 15 Links
 20 Pages
 25 Comments
 59 Separator
 60 Appearance
 65 Plugins
 70 Users
 75 Tools
 80 Settings
 99 Separator

好了，還是以例項來講解，這樣才能李菊福嘛
還是接著上一篇文章中測試的檔案，(在預設的 Twenty Ten 主題中新建一個 myfuntions.php , 然後在 functions.php 檔案中 include) 用編輯器開啟我們的 myfunctions.php，檔案中原來的程式碼刪掉吧。

新增新程式碼：

  1. <?php   
  2. function test_function(){   
  3.     add_menu_page( 'title 標題', '選單標題', 'edit_themes', 'ashu_slug','display_function','',6);   
  4. }   
  5.   
  6. function display_function(){   
  7.     echo '<h1> 這是設定頁面</h1>';   
  8. }   
  9. add_action('admin_menu', 'test_function');   
  10. ?>  

可以看到，選單位置是 6，比較一下可發現，它將會在 「文章」 的後面，看：

已經出現了一個頂級選單頁面了。。。