# 菜單 #### **框架標準菜單定義** 平臺管理端菜單項 `app\dict\menu\admin.php ` 站點管理端菜單項 ` app\dict\menu\site.php ` niucloud-admin框架首次安裝系統時，會自動加載上面的兩個菜單字典到數據表中sys_menu表中。一定要注意。niucloud-admin框架的設計機制，切記！開發者不允許直接在sys_menu數據表中進行菜單項的操作，而必須在菜單字典中修改編輯。 **修改菜單注意事項** 1. 每次修改編輯了菜單字典，必須要刷新菜單緩存（開發工具\更新緩存\刷新菜單），才能更新到數據表sys_menu中 2. 插件開發時，有針對于菜單的處理，安裝插件后一定要首先在站點套餐中勾選菜單項，界面才會生效 常常，我們開發了菜單功能，發現界面怎么都沒有按照預定的想法變化，就是忽略了上面的步驟。 #### **插件中菜單定義** 插件中也可以自定義菜單項，niucloud-admin框架對于插件的約束是寬容的，插件可以對整個系統的菜單項進行操作。甚至可以操作標準菜單定義。插件中菜單項的定義位置與標準菜單項的定義方式幾乎相同。<br> 例如在hello_world插件中，對于平臺管理端、站點管理端的菜單項的定義位置在 平臺管理端菜單項 `addon\hello_world\app\dict\menu\admin.php ` 站點管理端菜單項 ` addon\hello_world\app\dict\menu\site.php ` 插件安裝時，這兩個地方定義的菜單項的結構，框架會自動裝載到菜單數據表sys_menu中 **特殊處理：** 在niucloud框架的站點端中，當本站點只有一個應用時應用的一級菜單不作顯示， 二級菜單作為一級菜單展示。 <br> **注意！插件安裝，卸載時，系統會自動裝載，刪除菜單，不需要開發者在插件的安裝、卸載腳本中對于菜單做相關處理**  ``` <?php return [ [ 'menu_name' => '插件站點菜單', 'menu_key' => 'niucloud_site_hello', 'menu_type' => 1, 'icon' => 'iconfont-iconyingyongshichang', 'api_url' => '', 'router_path' => 'hello_world', 'view_path' => 'hello_world/site', 'methods' => '', 'sort' => 90, 'status' => 1, 'is_show' => 1, ], /* [ 'menu_name' => '會員列表', 'menu_key' => 'member_list', 'parent_key' => 'member', 'menu_type' => 1, 'icon' => 'iconfont-iconhuiyuanliebiao', 'api_url' => 'member/member', 'router_path' => 'hello_world_member_list', 'view_path' => 'hello_world/member', 'methods' => 'get', 'sort' => 100, 'status' => 1, 'is_show' => 1, 'children' => [ ] ], "delete" => "member" //針對修改系統菜單處理方式，可以刪除系統菜單，設置對應key值，也可刪除不需要的菜單處理 */ ]; ``` menu_name 菜單的標題，出現在菜單項上的文字 menu_key 菜單的關鍵字，這個必須唯一，添加父子菜單，刪除等操作鍵 menu_type 菜單類型，0表示目錄 1表示菜單 2表示功能按鈕 icon 菜單的圖標 api_url 菜單對應的后臺api接口地址，作用是控制api接口權限與菜單權限控制一致，并非實際調用URL router_path 路由地址，表示實際的菜單調用網址URL，菜單調用路由的開發，請參考相關開發說明 view_path view文件地址，表示實際前端view文件地址，一般的，路由地址與view文件地址不一致 methods 請求方法，與api_url 對應，包括GET, POST, PUT, DELETE sort 排序號，排序號越大，越靠前 status 狀態，1表示啟用，0表示禁用 （暫時沒有作用） is_show 菜單是否可見 1表示可見 0表示隱藏 系統菜單的特殊處理 `delete => "member" 針對修改系統菜單處理方式，可以刪除系統菜單，設置對應key值，也可刪除不需要的菜單處理， 這個只是插件菜單的處理方式。用于刪除系統菜單（sys_menu表中軟刪除）。 ` 通過上面的方式，插件中可以針對框架的某個菜單項進行軟刪除，替換菜單功能為自己的功能。 例如，我們開發一個軟件，發現框架本身的會員列表不符合要求，我們不應該直接修改框架的會員列表功能，而應該軟刪除框架自帶的會員列表菜單，然后全新開發一套會員列表功能。新建會員列表菜單路由到自己開發的會員列表功能。 這樣的好處是，框架進行升級時，可以完全兼容升級。