Interface Text Customization

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 Parallels H-Sphere. In this case, you build new language bundles into a portable package easily installed on other Parallels H- Sphere clusters.

Compiling bundles

This 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.
2. All affected files must have cpanel:cpanel ownership.
3. Create custom bundle directory, e.g., ~cpanel/shiva/custom/bundles if it is not created yet.
4. Set custom bundle location in ~cpanel/shiva/psoft/hsphere/lang/hsphere_lang.properties (if it's not set):

   CUSTOM_TEMPLATE_BUNDLE=custom.bundles.hsphere_lang

5. 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.
6. For example, you are going to change the label Shell Access to SSH Access. It is set in the ~cpanel/shiva/psoft/hsphere/lang/hsphere_lang.properties file. Create the file ~cpanel/shiva/custom/bundles/hsphere_lang.properties if it isn't there already.
7. 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 Freemarker variables in curly brackets, such as {0}. For example:

   search.view_invoice = View Client's Invoice

   but:

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

8. Run language bundle compiler to implement customization:

   java psoft.hsphere.LangBundlesCompiler