|
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
(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.
|
