前面的 WordPress 主題後臺製作教程一、二、三分別介紹了在 WordPresss 後臺新增外觀子選單頁面、頂級選單頁面和子選單頁面。其中有一些注意事項這裡來總結一下。

一、動作鉤子

我們在新增後臺設定頁面的時候一般使用瞭如下程式碼：

  1. add_action('admin_menu', 'test_function');  

一般都是使用 admin_menu 鉤子來新增頁面的，官網檔案中也有提示：

NOTE: If you're running into the »You do not have sufficient permissions to access this page.« message in a `wp_die()` screen, then you've hooked too early. The hook, you should use is `admin_menu`.

大意是說：如果你碰到了提示你說: 你沒有足夠的許可權訪問這個頁面 (You do not have sufficient permissions to access this page)，很有可能你使用的鉤子太早觸發了，你應該使用 『admin_menu』 這個鉤子。

二、許可權

我們新增設定頁面的函式中都有一個引數：$capability，這個引數為使用者訪問這個選單頁面需要的許可權。在函式 add 的引數介紹中有建議：

 User levels are deprecated and should not be used here!

在 WordPress 中也將許可權分成了很多級別，也就是 user levels，這裡建議你使用 capability，WordPress 官方網站轉麼有一個介紹頁面. 如下：

所以建議使用這個頁面提到的內容，不過我看很多外掛和主題的作者並沒有這樣做，比如像國內博主 「萬戈」 的一篇文章中，這個引數是：basename(__FILE__)，還有人這個引數寫的是：administrator，但是這準確來說不是許可權，而是角色，還有在國外收費主題中看到這個引數使用了數字，也就是 user levels 。他們都這樣用，所以我也只是敢建議了。。。

三、相關函式

第一篇教程中我們在後臺的 「外觀」 選單項裡面新增了一個子選單項，使用的函式是：add_theme_page(), 在教程 (三) 中又介紹了一個新增子選單項的函式 add_submenu_page()，我們可以用 add_submenu_page() 來代替 add_theme_page()，add_theme_page 只是 WordPress 提供的一個更方便一點的函式，跟這個函式一樣的函式還有：

  1. For Dashboard: add_submenu_page( 'index.php', ... ); Also see add_dashboard_page()
  2. For Posts: add_submenu_page( 'edit.php', ... ); Also see Also see add_posts_page()
  3. For Media: add_submenu_page( 'upload.php', ... ); Also see add_media_page()
  4. For Links: add_submenu_page( 'link-manager.php', ... ); Also see add_links_page()
  5. For Pages: add_submenu_page( 'edit.php?post_type=page', ... ); Also see add_pages_page()
  6. For Comments: add_submenu_page( 'edit-comments.php', ... ); Also see add_comments_page()
  7. For Custom Post Types: add_submenu_page( 'edit.php?post_type=your_post_type', ... );
  8. For Appearance: add_submenu_page( 'themes.php', ... ); Also see add_theme_page()
  9. For Plugins: add_submenu_page( 'plugins.php', ... ); Also see add_plugins_page()
  10. For Users: add_submenu_page( 'users.php', ... ); Also see add_users_page()
  11. For Tools: add_submenu_page( 'tools.php', ... ); Also see add_management_page()
  12. For Settings: add_submenu_page( 'options-general.php', ... ); Also see add_options_page()

上面 12 個除去第 7 個 custom post type，就是正常預設情況下，WordPress 的 11 個頂級選單項了。比如第一個 For Dashboard: add_submenu_page( 'index.php', ... ); Also see add_dashboard_page() 。

往儀表盤新增一個子選單項，可以使用 add_submenu_page(『index.php』,...) 這個函式，也可以直接使用 add_dashboard_page 函式。