Tutorial: Adding a language to a store with REST API

In this tutorial, you add a new language to HCL Commerce for use in your organization's asset stores and an extended sites store.

By default, HCL Commerce is translated into the following 13 languages:
Translated languages
Language & Country or Region Identifier
English (United States) en_US
French (France) fr_FR
German (Germany) de_DE
Italian (Italy) it_IT
Spanish (Spain) es_ES
Portuguese (Brazil) pt_BR
Chinese-simplified (China) zh_CN
Chinese-traditional (Taiwan) zh_TW
Korean (Korea, South) ko_KR
Japanese (Japan) ja_JP
Russian (Russia) ru_RU
Romanian (Romania) ro_RO
Polish (Poland) pl_PL
The language support includes the software, documentation, and user interfaces such as the Management Center, HCL Commerce Accelerator, the Administration Console, and samples. You can add support for other languages. You can translate many of the features of your site, such as product descriptions, messages, and text on the pages.
If you want to add a new language to a store, you must complete the following high-level tasks:
  1. Add the data for identifying the language to your programming environment database with REST API.
  2. Configure your programming environment stores (asset and customer-facing stores) within Management Center to support the display of text in the new language.
  3. Update your store properties files to include any required text within the new language.
  4. Deploy your properties files to your Runtime environment and use REST API to add the language to your Runtime environment.

Learning objectives

After completing this tutorial, you should be able to do the following tasks:
  • Adding language support to stores
  • Working with properties and resource bundle files
  • Using Administrative REST API
  • Using the Management Center Store Management tool to select the supported languages for a store.

Skill level

This tutorial is intended for HCL Commerce developers who are responsible for customizing the store and store globalization. To complete this tutorial, ensure that you are familiar with the following terms and concepts:
  • ISO Language standards
  • REST API
  • JSP and JSPF files
  • JSON