odoo菜单定义和修改学习总结

环境

odoo-14.0.post20221212.tar

定义菜单

方式1：

<?xml version="1.0"?> <odoo> <menuitem id="root_menu_id" name="TopMenu" web_icon="estate,static/img/icon.png"> <menuitem id="second_level_menu" name="SecondLevelMenu"> <menuitem id="third_level_menu1" action="third_level_menu1_action" sequence ="10"/> <menuitem id="third_level_menu2" action="third_level_menu2_action" sequence ="20"/> </menuitem> </menuitem> </odoo>

说明：

id 菜单外部ID

name

如果不指定name            ，则：

如果为菜单设置了action
  
 
  
 
  
 
  
 
  
 
  
，则获取action record定义中name字段的值作为菜单name属性的值 如果未设置菜单action










，则获取菜单外部ID为值作为菜单name属性的值

action

打开菜单时需要执行的action的外部ID

web_icon

指定菜单图标 
  
  
  
  
  
 ，格式：模块名称,图标路径
  
  
  
  
  
 ，形如estate,static/img/icon.png 意为estate模块下的static/img/icon.png图标            。其中图标路径
 


 


 


 


 


 
，一般是相对于模块根目录的相对路径

sequence

设置菜单展示顺序
  
 
  
 
  
 
  
 
  
 
  
。该属性值越大 
 
 
 
 
 
，越靠右
  
  
  
  
  
 、靠下方展示










。也就是说
   
   
   
   
   
  ，菜单从左往右
 

 

 

 

 

 
，从上到下 

 

 

 

 

 
，对应sequence属性值从小到大 
  
  
  
  
  
 。

<menuitem>元素也可以放在<data>元素中            ，形如

<?xml version="1.0"?> <odoo> <data> <menuitem id="root_menu_id" name="TopMenu" web_icon="estate,static/img/icon.png"> ... </menuitem> </data> </odoo>

groups

逗号分隔的res.groups模型的外部ID序列

 
 

 
 

 
 

 
 

 
 

 
，形如groups="group_account_user,group_account_manager,group_account_invoice"










，表示菜单只能被group_account_user                  ，group_account_manager
 
 
 
 
 
 
 
 
 
 
 
，group_account_invoice 三个用户组访问
  
  
  
  
  
 。用于指定可以访问菜单的用户组
 


 


 


 


 


 
。如果外部ID以-为前缀
















，则从菜单组中移除该ID代表的组            ，注意
  
 
  
 
  
 
  
 
  
 
  
，如果指定用户组不是在当前模块中定义的










，需要指定所在模块名称 
  
  
  
  
  
 ，形如estate.group_estate_property_root_menu 
 
 
 
 
 
。

示例：

<?xml version="1.0"?> <odoo> <data> <menuitem id="root_menu_id" name="TopMenu" web_icon="estate,static/img/icon.png" groups="group_estate_property_root_menu"> ... </menuitem> </data> </odoo>

方式2：通过parent来设置菜单层级

<?xml version="1.0"?> <odoo> <menuitem id="root_menu_id" name="TopMenu" web_icon="estate,static/img/icon.png"/> <menuitem id="second_level_menu" name="SecondLevelMenu" parent="root_menu_id"/> <menuitem id="third_level_menu1" action="third_level_menu1_action" sequence ="10" parent="second_level_menu"/> <menuitem id="third_level_menu2" action="third_level_menu2_action" sequence ="20" parent="second_level_menu"/> </odoo>

说明：

parent

指定父级菜单外部ID
  
  
  
  
  
 ，如果上级菜单不在当前模块中
 


 


 


 


 


 
，则需要指定上级菜单所在模块 
 
 
 
 
 
，形如parent="moduleName.parent_menu_id"

修改菜单

本节要介绍的是一种特殊的修改方式
   
   
   
   
   
  ，并不是直接修改原有菜单定义
   
   
   
   
   
  。这种修改方式之所以特殊
 

 

 

 

 

 
，是因为它不修改原有菜单的定义 

 

 

 

 

 
，而是通过重新定义菜单来修改            ，可以简单的类比为“继承            ”

 
 

 
 

 
 

 
 

 
 

 
，具体做法如下：

定义一个新的菜单<menuitem>










，将其id属性值设置为原有菜单所在模块名称及其id属性值的组合                  ，形如：moduleName.source_menu_id(参见下述示例)
 
 
 
 
 
 
 
 
 
 
 
，如果新的菜单和原有菜单在同一个模块
















，可以省略moduleName.
 

 

 

 

 

 
。

修改相关菜单属性值为目标值(如果需要的话)

示例：重新定义purchase.menu_purchase_root菜单名称

<menuitem id="purchase.menu_purchase_root" name="omsPurchase"/>

以新定义的菜单为父级菜单            ，添加子菜单(如果需要的话)
  
 
  
 
  
 
  
 
  
 
  
，添加方式可以参考上文所述










，需要注意的是 
  
  
  
  
  
 ，不管采用哪种方式
  
  
  
  
  
 ，原有菜单的子菜单依然存在
 


 


 


 


 


 
，并显示为新定义菜单的子菜单

隐藏原有菜单的子菜单(如果需要的话)

定义一个<record> 
 
 
 
 
 
，将其id设置为要隐藏的子菜单所在模块名称及id属性值的组合
   
   
   
   
   
  ，形如：moduleName.source_menu_id
 

 

 

 

 

 
，如果新的菜单和原有菜单在同一个模块 

 

 

 

 

 
，可以省略moduleName. 

 

 

 

 

 
。

将其model设置为"ir.ui.menu"

添加子元素 <field name="active" eval="False"></field>            ，其中eval=False则表示隐藏

 
 

 
 

 
 

 
 

 
 

 
，eval=True表示显示

<?xml version="1.0"?> <odoo> ... <record id="purchase.sub_menu_purchase" model="ir.ui.menu"> <field name="active" eval="False"></field> </record> </odoo>

参考连接

https://www.odoo.com/documentation/14.0/zh_CN/developer/reference/addons/data.html#shortcuts