Installation and Configuration

Installation

The Japanese Localization extension consists of independent modules, each one providing features and may be used separately. For the best experience of Japanese customers and merchants, we recommend using the entire suite. To install all Japanese Localization modules, install with a single line Composer package and may require developer assistance.

$ composer require magento/japan-common
$ bin/magento module:enable Japan-Common
$ bin/magento setup:upgrade
$ bin/magento cache:clean

For Elasticsearch support, we recommend installing the Japanese (kuromoji) Analysis Plugin.

Configuration

After installing the extension, configure the Japanese options features and options.

Configure addresses and names

1. On the Admin sidebar, click Stores. Then under Settings, choose Configuration. This section gives you access to configure your stores.

2. To configure address templates for Japanese addresses, click Customers, then General, then choose General again. For the Store Address Template, modify formats as needed.

3. To configure name fields to support Japanese name formats, click Customers, then choose Customer Configuration. Under the Name Kana Options, select an option:

   • Use Kana — defines if kana fields will be displayed for the customer.
   • Require Kana on frontend — defines if Kana is required for customer information.
   • Acceptable Kana character type on frontend — specifies the allowed Kana syllabary for customer information. Options include Only Katakana, Only Hiragana, and Both.

4. To require addresses at registration, click Customers, then choose Customer Configuration. Under Create New Account Options, select Show Address on Customer Registration Form to require or not require the address.

5. To display the country in the address, click Customers, then choose Customer Configuration. Under Name and Address Options, select Show Country to show or not show the country in address forms.

6. Click Save Config.

Configure currency settings

1. On the Admin sidebar, click Stores. Then under Settings, choose Configuration. This section gives you access to configure your stores.

2. Click General, then choose Currency Setup.

3. For Japanese Yen Formatting, select a format for displaying Yen in your store:

   • International (￥123)
   • Local (123 円)

4. To configure the rounding method, click Currency Options and set the method:

   • Up — round away from zero.
   • Ceiling — round towards positive infinity.
   • Down — round towards zero. (default)
   • Floor — round towards negative infinity.
   • Half Down — round towards "nearest neighbor" unless both neighbors are equidistant, in which case round down.
   • Half Even — round towards "nearest neighbor" unless both neighbors are equidistant, in which case round towards the even neighbor.

5. Click Save Config.