Parallels H-Sphere Documentation Customization Guide

 

Menu XML Customization

 
 

Related Docs:   Menu Customization Menu Structure Menu XML Customization

Last modified: 18 Oct 2007

 

WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

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:

MENU_CONFIG=/hsphere/local/home/cpanel/shiva/psoft/hsphere/menu.xml

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

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

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.


Related Docs:   Menu Customization Menu Structure Menu XML Customization



© Copyright 2017. Parallels Holdings. All rights reserved.