Lokalisierungsfähigkeit
Diese Fähigkeit führt Sie durch die Lokalisierung von B2C-Commerce-Storefronts für mehrere Sprachen und Regionen.
Übersicht
B2C Commerce unterstützt Lokalisierung durch:
| Komponente | Ansatz |
|---|---|
| Vorlagen | Einzelnes Vorlagenset + Ressourcenbündel |
| Formulare | Gemeinsame Definitionen + locale-spezifische Beschriftungen |
| Statischer Inhalt | Locale-spezifische Ordner |
| Produktdaten | Lokalisierbare Attribute |
Locale-Format
Locales folgen ISO-Standards: {Sprache}_{Land}
| Format | Beispiel | Beschreibung |
|---|---|---|
en | Englisch | Nur Sprache |
en_US | Englisch/USA | Sprache + Land |
fr_CA | Französisch/Kanada | Sprache + Land |
de_DE | Deutsch/Deutschland | Sprache + Land |
Ressourcenbündel
Verzeichnisstruktur
/cartridge
/templates
/resources
account.properties # Standard (Englisch)
checkout.properties
/fr
account.properties # Französisch
checkout.properties
/de
account.properties # Deutsch
checkout.properties
/fr_CA
account.properties # Französisch, Kanada
Property-Dateiformat
account.properties (Standard):
##############################################
# Account-Seiten
##############################################
account.title=Mein Konto
account.greeting=Willkommen zurück
account.logout=Abmelden
# Dashboard
dashboard.title=Dashboard
dashboard.orders=Bestellhistorie
dashboard.addresses=Adressbuch
dashboard.wishlist=Wunschliste
# Profil
profile.title=Profil
profile.firstName=Vorname
profile.lastName=Nachname
profile.email=E-Mail-Adresse
profile.save=Änderungen speichern
account_fr.properties (Französisch):
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
Ressourcen in Vorlagen verwenden
<!-- Einfache Nachricht -->
<h1>${Resource.msg('account.title', 'account', null)}</h1>
<!-- Mit Fallback -->
<p>${Resource.msg('account.greeting', 'account', 'Willkommen')}</p>
<!-- Mit Parametern -->
<p>${Resource.msgf('cart.items', 'cart', null, cartCount)}</p>
Resource.msg()-Parameter:
- Schlüsselname
- Bündelname (Dateiname ohne Erweiterung)
- Standardwert (null = Schlüssel verwenden, falls nicht gefunden)
Parametrisierte Nachrichten
Property:
cart.itemCount=Sie haben {0} Artikel in Ihrem Warenkorb
greeting.personalized=Hallo, {0} {1}!
order.confirmation=Bestellung #{0} aufgegeben am {1}
Vorlage:
${Resource.msgf('cart.itemCount', 'cart', null, itemCount)}
${Resource.msgf('greeting.personalized', 'common', null, firstName, lastName)}
Locale-Fallback
B2C Commerce verwendet eine Fallback-Kette: fr_CA → fr → Standard
Beispiel: Anforderung von fr_CA:
- Suche in
/resources/fr_CA/account.properties - Wenn nicht gefunden, suche in
/resources/fr/account.properties - Wenn nicht gefunden, suche in
/resources/account.properties
Statische Dateien
Verzeichnisstruktur
/cartridge
/static
/default
/css
style.css
/images
logo.png
buttons/
submit.png
/js
main.js
/fr
/images
buttons/
submit.png # Französischer Text auf dem Button
/de
/images
buttons/
submit.png # Deutscher Text auf dem Button
Referenzierung statischer Dateien
<!-- Verwendet locale-spezifische Version, falls verfügbar -->
<img src="${URLUtils.staticURL('/images/buttons/submit.png')}" alt="Absenden"/>
<!-- CSS (normalerweise nicht lokalisiert) -->
<link rel="stylesheet" href="${URLUtils.staticURL('/css/style.css')}"/>
Formularlokalisierung
Formulardefinition
<?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>
Ressourcenbündel
forms.properties:
form.email.label=E-Mail-Adresse
form.email.required=E-Mail ist erforderlich
form.email.invalid=Bitte geben Sie eine gültige E-Mail-Adresse ein
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-Lokalisierung
Locale-bewusste URLs
<!-- Aktuelle Locale-URL -->
<a href="${URLUtils.url('Product-Show', 'pid', 'ABC123')}">Produkt anzeigen</a>
<!-- Bestimmte Locale-URL -->
<a href="${URLUtils.url(new URLAction('Product-Show', 'MySite', 'fr'))}">
Voir le produit
</a>
Sprachwechsler
<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>
Controller-Lokalisierung
Aktuelle Locale abrufen
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();
});
Locale-spezifische Logik
server.get('Checkout', function (req, res, next) {
var locale = req.locale.id;
// Locale-spezifisches Datumsformat
var dateFormat = locale.startsWith('en_US') ? 'MM/dd/yyyy' : 'dd/MM/yyyy';
// Locale-spezifischer Inhalt
var termsContentId = 'terms-' + locale.replace('_', '-').toLowerCase();
res.render('checkout', {
dateFormat: dateFormat,
termsContentId: termsContentId
});
next();
});
E-Mail-Vorlagen
Locale setzen
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();
}
Währungsformatierung
Währung ist an die Locale gebunden:
var Money = require('dw/value/Money');
var StringUtils = require('dw/util/StringUtils');
// Mit Locale formatieren
var price = new Money(99.99, 'USD');
var formatted = StringUtils.formatMoney(price); // Verwendet aktuelle Locale
// In Vorlage
<isprint value="${product.priceModel.price}" style="CURRENCY"/>
Datumsformatierung
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-bewusst
Bewährte Praktiken
- UTF-8 verwenden für alle Property-Dateien (erforderlich für Nicht-ASCII-Zeichen)
- Bündel nach Seite/Funktion organisieren, nicht nach Sprache
- Schlüssel beschreibend halten -
account.profile.firstNamenichtlabel1 - Parameter für dynamische Werte verwenden - Zeichenketten nicht verketten
- Alle Locales testen - sicherstellen, dass Fallback korrekt funktioniert
- Text in Vorlagen oder Skripten nicht hartcodieren
Detaillierte Referenz
- Lokalisierungsmuster - Vollständige Muster und Beispiele