Parallels H-Sphere Documentation Customization Guide


Interface Text Customization


Related Docs:   Understanding Templates Introduction to Bundles Adding New Languages To H-Sphere

Last modified: 28 Dec 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.

This document dwells on interface text customization methods. It implies you are familiar with the concept of language bundles.

These are the following alternative ways to customize texts:

  • With packages

    Packages are helpful when you want to add a new language to H-Sphere. In this case, you build new language bundles into a portable package easily installed on other H-Sphere's.

  • Compiling bundles

    This new scheme of customizing bundles enables you to apply modifications by merging custom bundles with default bundles without building and installing packages. Read more about compiling bundles.

    1. Log into CP server as cpanel user.

      All affected files must have cpanel:cpanel ownership.

    2. Create custom bundle directory, e.g., ~cpanel/shiva/custom/bundles if it is not created yet.

    3. Set custom bundle location in (if it's not set):


    4. Find the string you want to modify among default or custom bundles. Create the corresponding custom bundle file if it doesn't exist to place modified string there.

      For example, you are going to change the label Shell Access to SSH Access. It is set in the ~cpanel/shiva/psoft/hsphere/lang/ file. Create the file ~cpanel/shiva/custom/bundles/ if it isn't there already.

    5. Copy the line with the identifier and the value you want to change into the custom bundle and change its value the way you want. You should use two single quotes (apostrophes) instead of one in labels containing curly brackets, such as {0}. For example:

      search.view_invoice = View Client's Invoice


      billing.del_no = No, I don''t want to delete {0}

    6. Run language bundle compiler to implement customization:

      java psoft.hsphere.LangBundlesCompiler

Related Docs:   Understanding Templates Introduction to Bundles Adding New Languages To H-Sphere

© Copyright 2018. Parallels Holdings. All rights reserved.