重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
b2c-localization by salesforcecommercecloud/b2c-developer-tooling
npx skills add https://github.com/salesforcecommercecloud/b2c-developer-tooling --skill b2c-localization此技能指导您如何为多种语言和地区本地化 B2C Commerce 店面。
B2C Commerce 通过以下方式支持本地化:
| 组件 | 方法 |
|---|---|
| 模板 | 单一模板集 + 资源包 |
| 表单 | 共享定义 + 特定于地区的标签 |
| 静态内容 | 特定于地区的文件夹 |
| 产品数据 | 可本地化的属性 |
地区遵循 ISO 标准:{语言}_{国家}
| 格式 | 示例 | 描述 |
|---|---|---|
en |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 英语 |
| 仅语言 |
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=我的账户
account.greeting=欢迎回来
account.logout=退出登录
# 账户仪表板
dashboard.title=仪表板
dashboard.orders=订单历史
dashboard.addresses=地址簿
dashboard.wishlist=愿望清单
# 个人资料
profile.title=个人资料
profile.firstName=名字
profile.lastName=姓氏
profile.email=电子邮件地址
profile.save=保存更改
account_fr.properties(法语):
account.title=Mon compte
account.greeting=Bon retour
account.logout=Se déconnecter
dashboard.title=Tableau de bord
dashboard.orders=Historique des commandes
dashboard.addresses=Carnet d'adresses
dashboard.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() 参数:
属性:
cart.itemCount=您的购物车中有 {0} 件商品
greeting.personalized=您好,{0} {1}!
order.confirmation=订单 #{0} 于 {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="提交"/>
<!-- 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=电子邮件地址
form.email.required=电子邮件为必填项
form.email.invalid=请输入有效的电子邮件地址
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 -->
<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('orders@example.com');
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'); // 地区感知
account.profile.firstName 而不是 label1每周安装次数
61
代码仓库
GitHub 星标数
34
首次出现
2026年2月21日
安全审计
安装于
github-copilot56
codex53
cursor53
opencode52
amp51
kimi-cli51
This skill guides you through localizing B2C Commerce storefronts for multiple languages and regions.
B2C Commerce supports localization through:
| Component | Approach |
|---|---|
| Templates | Single template set + resource bundles |
| Forms | Shared definitions + locale-specific labels |
| Static content | Locale-specific folders |
| Product data | Localizable attributes |
Locales follow ISO standards: {language}_{country}
| Format | Example | Description |
|---|---|---|
en | English | Language only |
en_US | English/USA | Language + country |
fr_CA | French/Canada | Language + country |
de_DE | German/Germany | Language + country |
/cartridge
/templates
/resources
account.properties # Default (English)
checkout.properties
/fr
account.properties # French
checkout.properties
/de
account.properties # German
checkout.properties
/fr_CA
account.properties # French Canadian
account.properties (default):
##############################################
# Account Pages
##############################################
account.title=My Account
account.greeting=Welcome back
account.logout=Sign Out
# Account Dashboard
dashboard.title=Dashboard
dashboard.orders=Order History
dashboard.addresses=Address Book
dashboard.wishlist=Wishlist
# Profile
profile.title=Profile
profile.firstName=First Name
profile.lastName=Last Name
profile.email=Email Address
profile.save=Save Changes
account_fr.properties (French):
account.title=Mon compte
account.greeting=Bon retour
account.logout=Se déconnecter
dashboard.title=Tableau de bord
dashboard.orders=Historique des commandes
dashboard.addresses=Carnet d'adresses
dashboard.wishlist=Liste de souhaits
profile.title=Profil
profile.firstName=Prénom
profile.lastName=Nom
profile.email=Adresse e-mail
profile.save=Enregistrer les modifications
<!-- Simple message -->
<h1>${Resource.msg('account.title', 'account', null)}</h1>
<!-- With fallback -->
<p>${Resource.msg('account.greeting', 'account', 'Welcome')}</p>
<!-- With parameters -->
<p>${Resource.msgf('cart.items', 'cart', null, cartCount)}</p>
Resource.msg() parameters:
Property:
cart.itemCount=You have {0} items in your cart
greeting.personalized=Hello, {0} {1}!
order.confirmation=Order #{0} placed on {1}
Template:
${Resource.msgf('cart.itemCount', 'cart', null, itemCount)}
${Resource.msgf('greeting.personalized', 'common', null, firstName, lastName)}
B2C Commerce uses a fallback chain: fr_CA → fr → default
Example: Requesting 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 # French text on button
/de
/images
buttons/
submit.png # German text on button
<!-- Uses locale-specific version if available -->
<img src="${URLUtils.staticURL('/images/buttons/submit.png')}" alt="Submit"/>
<!-- CSS (usually not localized) -->
<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
<!-- Current locale URL -->
<a href="${URLUtils.url('Product-Show', 'pid', 'ABC123')}">View Product</a>
<!-- Specific locale 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;
// Locale-specific date format
var dateFormat = locale.startsWith('en_US') ? 'MM/dd/yyyy' : 'dd/MM/yyyy';
// Locale-specific content
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('orders@example.com');
mail.setSubject(Resource.msg('email.order.subject', 'email', null));
mail.setContent(content, 'text/html', 'UTF-8');
mail.send();
}
Currency is tied to locale:
var Money = require('dw/value/Money');
var StringUtils = require('dw/util/StringUtils');
// Format with locale
var price = new Money(99.99, 'USD');
var formatted = StringUtils.formatMoney(price); // Uses current locale
// In template
<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 format
var localized = StringUtils.formatCalendar(date, 'MMMM d, yyyy'); // Locale-aware
account.profile.firstName not label1Weekly Installs
61
Repository
GitHub Stars
34
First Seen
Feb 21, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
github-copilot56
codex53
cursor53
opencode52
amp51
kimi-cli51
Shopify内容管理API与SEO优化指南 | 自动化创建页面博客导航
473 周安装