wordpress后臺(tái)添加頂級(jí)菜單 add_menu_page()

字號(hào):


    在 wordpress 插件、主題等制作過(guò)程中,經(jīng)常需要在后臺(tái)添加菜單,今兒分享一下在 wordpress 后臺(tái)側(cè)邊欄添加頂級(jí)菜單的方法,也算加深一下印象吧,用到的函數(shù)是:add_menu_page()。
    函數(shù)用法:
    add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $position );
    下面說(shuō)說(shuō)各參數(shù):
    $page_title:(字符串) (必須) 這個(gè)參數(shù)是子菜單的標(biāo)題,將會(huì)顯示在瀏覽器的標(biāo)題欄,默認(rèn)為空;
    $menu_title:(字符串) (必須) 顯示的菜單名稱(chēng),默認(rèn)為空;
    $capability:(字符串) (必須) 用戶(hù)權(quán)限,定義了具有哪些權(quán)限的用戶(hù)會(huì)看到這個(gè)子菜單(權(quán)限部分請(qǐng)看文章結(jié)尾處),默認(rèn)為空,參照capability;
    $menu_slug:(字符串) (必須) 顯示在URl上面的菜單名稱(chēng),默認(rèn)為空;
    $function:返回的方法名稱(chēng);
    $icon_url:(字符串) (可選) 顯示的菜單圖標(biāo),可以使用plugin_dir_url( __FILE__ ),圖標(biāo)寬高為16像素;
    $position:(整數(shù)) (可選) 顯示菜單的位置。常用位置,4或者59或者99。
    示例:
    <?php
    add_action('admin_menu', 'register_custom_menu_page');
    function register_custom_menu_page() {
    add_menu_page('自定義菜單標(biāo)題', '測(cè)試菜單', 'administrator', 'myplugin/myplugin-index.php','',plugins_url('myplugin/images/icon.png'), 6);
    }
    //然后將下面的代碼放到myplugin/myplugin-index.php文件中
    echo "Admin Page Test";
    //或者使用下面方法
    add_action('admin_menu', 'register_custom_menu_page');
    function register_custom_menu_page(){
    add_menu_page('菜單標(biāo)題', '菜單名稱(chēng)', 'administrator', 'custompage', 'custom_menu_page', plugins_url('myplugin/images/icon.png'), 6);
    }
    function custom_menu_page(){
    echo "Admin Page Test";
    }
    最后附上:各個(gè)用戶(hù)角色所具有的權(quán)限,可以參看這個(gè)對(duì)應(yīng)關(guān)系表:Capability vs. Role Table,橫坐標(biāo)是用戶(hù)角色,縱坐標(biāo)是用戶(hù)權(quán)限,中間藍(lán)色高亮部分為各個(gè)角色所擁有的權(quán)限。