H-Sphere Documentation Customization Guide


Menu XML Customization


Related Docs:   Menu Customization Menu Structure Menu XML Customization (HS 2.4 and up)

The Control Panel menu structure is represented in an XML file. Its default location is set in ~cpanel/shiva/psoft_config/hsphere.properties by the MENU_CONFIG parameter:


You should not make changes in the default menu.xml file, because these changes will be lost with the next H-Sphere upgrade. Instead, you create custom XML files that either override or merge changes with default configuration.

Below are the alternative ways to customize menu.xml.


1. With Packages

(HS 2.4 and up)

You create a custom menu.xml file within an H-Sphere package. After the package is installed, this custom XML configuration will be merged with default XML configuration.


2. Merging Custom XML Configuration

(HS 2.4 and up)

If you need minor modifications in menu configuration, you don't need to rebuild a package. Instead, you create a custom XML configuration file to be merged with the default XML configuration and a custom package XML if installed. In this case, you avoid changing the default MENU_CONFIG property in hsphere.properties and use the CUSTOM_MENU_CONFIG parameter to specify your custom menu.xml location.


3. Overriding Default XML Configuration

(deprecated in 2.4)

You copy the default menu.xml file to a custom directory, make changes to that custom file and set MENU_CONFIG to that custom location. This will override the default settings. However, you will not see improvements in the default menu.xml coming with the next updates.

Related Docs:   Menu Customization Menu Structure Menu XML Customization (HS 2.4 and up)

User comments
No comments for this page.
Add comment

Home   Products   Services   Partners   Support   News   Contact   Forum
© 2020 psoft.net.
All rights reserved.