Localizing themes on the client application

About this task

To localize the client application theme files, perform the following tasks:

Procedure

  1. Navigate to the <INSTALL_DIR>/repository/rcp/rcpclient/ directory.
  2. Extract files from the com.yantra.yfc.rcp_<version>.zip file to the <extracted_files> directory of your choice.

    All Rich Client Platform-specific theme files will now be located in the <extracted_files>/com.yantra.yfc.rcp.common_<version> directory.

    The theme files are in the following format:

    com.yantra.yfc.rcp.common_<theme_name>.ythm

    Here, <theme_name> refers to the name of a particular theme. By default, Rich Client Platform provides three different theme files named sapphire, jade, and earth.

  3. Copy the com.yantra.yfc.rcp.common_<theme_name>.ythm file to the resources directory under the extensions folder that you created.
  4. Navigate to the <INSTALL_DIR>/repository/rcp/rcpclient/ directory.
  5. Extract the <PCA_APPLICATION_ID_VERSION>.zip file to the <extracted_files> directory of your choice. Navigate to the following directory:
    <extracted_files>/plugins/<Plug-in_id>_<version>

    In the <Plug-in_id>_<version> directory, there is a <PCA_APPLICATION_ID_VERSION>.jar file. The theme file is in the root directory of this JAR file and is called <Plug-in_id>_<theme_name>.ythm.

  6. Copy the <Plug-in_id>_<theme_name>.ythm file to the resources directory under the extensions folder that you created.

    For example, if you are localizing a theme file of the Sterling Call Center and Sterling Store PCA, extract the <INSTALL_DIR>/repository/rcp/rcpclient/com20.zip file.

  7. Navigate to the <extracted_files>/plugins/com.yantra.pca.ycd.rcp_<version> directory.

    Here, <extracted_files> refers to the directory in which you have extracted the com20.zip file

    In the com.yantra.pca.ycd.rcp_<version> directory, there is a com20.jar file. The theme file is in the root directory of this JAR file and is called com.yantra.pca.ycd_<theme>.ythm.

  8. Copy the com.yantra.pca.ycd_<theme>.ythm file to the resources directory under the extensions folder that you created.
  9. Rename the <Plug-in_ id>_<theme_name>.ythm files as <Plug-in_ id>_<theme_name>_<locale_name>.ythm and the com.yantra.yfc.rcp.common_<theme_name>.ythm files as com.yantra.yfc.rcp.common_<theme_name>_<locale_name>.ythm.

    The <locale_name>=lang_cc, where lang refers to the language code and cc refers to the country or region code. For example, com.yantra.pca.ycd_ sapphire_en_US.ythm.

  10. Modify the theme entries in the theme file based on the user's locale. For more information about theme entries in the theme file, see Localizing themes for fonts and Localizing themes for images .
  11. Create a new icons folder and store all the images or icons that you want to localize in this folder. Now, copy the icons folder to the <RCP_EXTN_FOLDER>/resources directory.
  12. If you are using Oracle WebLogic or IBM® WebSphere®, rebuild the EAR.

Results

Note: For information on localizing theme files for PCAs, see the implementation topics specific to your PCA.