ローカリゼーションスキル
このスキルは、複数の言語と地域に対応する B2C Commerce ストアフロントをローカライズするためのガイドです。
概要
B2C Commerce は、以下のコンポーネントを通じてローカリゼーションをサポートしています。
| コンポーネント | アプローチ |
|---|---|
| テンプレート | 単一のテンプレートセット + リソースバンドル |
| フォーム | 共有定義 + ロケール固有のラベル |
| 静的コンテンツ | ロケール固有のフォルダ |
| 製品データ | ローカライズ可能な属性 |
ロケール形式
ロケールは ISO 標準に従います: {language}_{country}
| 形式 | 例 | 説明 |
|---|---|---|
en | 英語 | 言語のみ |
en_US | 英語/アメリカ | 言語 + 国 |
fr_CA | フランス語/カナダ | 言語 + 国 |
de_DE | ドイツ語/ドイツ | 言語 + 国 |
リソースバンドル
ディレクトリ構造
/cartridge
/templates
/resources
account.properties # デフォルト(英語)
checkout.properties
/fr
account.properties # フランス語
checkout.properties
/de
account.properties # ドイツ語
checkout.properties
/fr_CA
account.properties # カナダフランス語
プロパティファイル形式
account.properties(デフォルト):
##############################################
# アカウントページ
##############################################
account.title=My Account
account.greeting=Welcome back
account.logout=Sign Out
# ダッシュボード
dash lord.title=Dashboard
dash lord.orders=Order History
dash lord.addresses=Address Book
dash lord.wishlist=Wishlist
# プロフィール
profile.title=Profile
profile.firstName=First Name
profile.lastName=Last Name
profile.email=Email Address
profile.save=Save Changes
account_fr.properties(フランス語):
account.title=Mon compte
account.greeting=Bon retour
account.logout=Se déconnecter
dash lord.title=Tableau de bord
dash lord.orders=Historique des commandes
dash lord.addresses=Carnet d'adresses
dash lord.wishlist=Liste de souhaits
profile.title=Profil
profile.firstName=Prénom
profile.lastName=Nom
profile.email=Adresse e-mail
profile.save=Enregistrer les modifications
テンプレートでのリソースの使用
<!-- シンプルなメッセージ -->
<h1>${Resource.msg('account.title', 'account', null)}</h1>
<!-- フォールバック付き -->
<p>${Resource.msg('account.greeting', 'account', 'Welcome')}</p>
<!-- パラメータ付き -->
<p>${Resource.msgf('cart.items', 'cart', null, cartCount)}</p>
Resource.msg() のパラメータ:
- キー名
- バンドル名(拡張子なしのファイル名)
- デフォルト値(null = 見つからない場合はキーを使用)
パラメータ化されたメッセージ
プロパティ:
cart.itemCount=You have {0} items in your cart
greeting.personalized=Hello, {0} {1}!
order.confirmation=Order #{0} placed on {1}
テンプレート:
${Resource.msgf('cart.itemCount', 'cart', null, itemCount)}
${Resource.msgf('greeting.personalized', 'common', null, firstName, lastName)}
ロケールフォールバック
B2C Commerce はフォールバックチェーンを使用します: fr_CA → fr → default
例: fr_CA をリクエストする場合:
/resources/fr_CA/account.propertiesを検索- 見つからない場合、
/resources/fr/account.propertiesを検索 - 見つからない場合、
/resources/account.propertiesを検索
静的ファイル
ディレクトリ構造
/cartridge
/static
/default
/css
style.css
/images
logo.png
buttons/
submit.png
/js
main.js
/fr
/images
buttons/
submit.png # ボタンにフランス語テキスト
/de
/images
buttons/
submit.png # ボタンにドイツ語テキスト
静的ファイルの参照
<!-- 利用可能な場合はロケール固有のバージョンを使用 -->
<img src="${URLUtils.staticURL('/images/buttons/submit.png')}" alt="Submit"/>
<!-- CSS(通常はローカライズしない) -->
<link rel="stylesheet" href="${URLUtils.staticURL('/css/style.css')}"/>
フォームのローカリゼーション
フォーム定義
<?xml version="1.0" encoding="UTF-8"?>
<form xmlns="http://www.demandware.com/xml/form/2008-04-19">
<field formid="email" label="form.email.label" type="string"
mandatory="true"
missing-error="form.email.required"
parse-error="form.email.invalid"/>
</form>
リソースバンドル
forms.properties:
form.email.label=Email Address
form.email.required=Email is required
form.email.invalid=Please enter a valid email address
forms_fr.properties:
form.email.label=Adresse e-mail
form.email.required=L'email est requis
form.email.invalid=Veuillez entrer une adresse e-mail valide
URL のローカリゼーション
ロケール対応 URL
<!-- 現在のロケール URL -->
<a href="${URLUtils.url('Product-Show', 'pid', 'ABC123')}">商品を表示</a>
<!-- 特定のロケール URL -->
<a href="${URLUtils.url(new URLAction('Product-Show', 'MySite', 'fr'))}">
Voir le produit
</a>
言語スイッチャー
<isscript>
var Site = require('dw/system/Site');
var URLAction = require('dw/web/URLAction');
var URLUtils = require('dw/web/URLUtils');
var Locale = require('dw/util/Locale');
</isscript>
<ul class="language-switcher">
<isloop items="${Site.current.allowedLocales}" var="localeId">
<isscript>
var locale = new Locale(localeId);
var url = URLUtils.url(new URLAction('Home-Show', Site.current.ID, localeId));
</isscript>
<li class="${request.locale == localeId ? 'active' : ''}">
<a href="${url}">${locale.displayLanguage}</a>
</li>
</isloop>
</ul>
コントローラーのローカリゼーション
現在のロケールへのアクセス
var Locale = require('dw/util/Locale');
server.get('Show', function (req, res, next) {
var currentLocale = Locale.getLocale(req.locale.id);
res.render('mytemplate', {
locale: req.locale.id,
language: currentLocale.language,
country: currentLocale.country,
displayLanguage: currentLocale.displayLanguage,
displayCountry: currentLocale.displayCountry
});
next();
});
ロケール固有のロジック
server.get('Checkout', function (req, res, next) {
var locale = req.locale.id;
// ロケール固有の日付形式
var dateFormat = locale.startsWith('en_US') ? 'MM/dd/yyyy' : 'dd/MM/yyyy';
// ロケール固有のコンテンツ
var termsContentId = 'terms-' + locale.replace('_', '-').toLowerCase();
res.render('checkout', {
dateFormat: dateFormat,
termsContentId: termsContentId
});
next();
});
メールテンプレート
ロケールの設定
var Template = require('dw/util/Template');
var HashMap = require('dw/util/HashMap');
var Mail = require('dw/net/Mail');
function sendOrderConfirmation(order, locale) {
var template = new Template('mail/orderconfirmation', locale);
var model = new HashMap();
model.put('order', order);
var content = template.render(model).text;
var mail = new Mail();
mail.addTo(order.customerEmail);
mail.setFrom('[email protected]');
mail.setSubject(Resource.msg('email.order.subject', 'email', null));
mail.setContent(content, 'text/html', 'UTF-8');
mail.send();
}
通貨フォーマット
通貨はロケールに関連付けられています:
var Money = require('dw/value/Money');
var StringUtils = require('dw/util/StringUtils');
// ロケールを使用してフォーマット
var price = new Money(99.99, 'USD');
var formatted = StringUtils.formatMoney(price); // 現在のロケールを使用
// テンプレート内
<isprint value="${product.priceModel.price}" style="CURRENCY"/>
日付フォーマット
var StringUtils = require('dw/util/StringUtils');
var Calendar = require('dw/util/Calendar');
var date = new Calendar();
var formatted = StringUtils.formatCalendar(date, 'yyyy-MM-dd'); // ISO 形式
var localized = StringUtils.formatCalendar(date, 'MMMM d, yyyy'); // ロケール対応
ベストプラクティス
- UTF-8 を使用 - すべてのプロパティファイルで必須(非 ASCII 文字に対応)
- バンドルをページ/機能ごとに整理 - 言語ごとではなく
- キーを説明的に保つ -
account.profile.firstNameであってlabel1ではない - 動的な値にはパラメータを使用 - 文字列を連結しない
- すべてのロケールをテスト - フォールバックが正しく機能することを確認
- テンプレートやスクリプトにテキストをハードコードしない
詳細リファレンス
- ローカリゼーションパターン - 完全なパターンと例