Locales

Rename operations can apply translations based on the customer’s language, so when a customer checks out, Checkout Commander has to decide which language — if any — to translate to. It does this using the customer’s locale.

What is a locale?

A locale is a language with an optional country. For example, fr identifies French generally, while fr-CA identifies French as used in Canada. Read more about IETF language tag. See Locale settings for how to configure the locales available to your rename operations.

Which translation does a customer see at checkout?

When a customer checks out, Checkout Commander first looks for a translation matching the full customer locale, such as fr-CA, and use that translation value. If a translation does not exist for the exact locale, then for a language-only translation value will be used, such as fr. If neither translation is configured, the original shipping rate or payment method name remains unchanged. Checkout Commander does not fall back to Primary Locale - it is assumed that is the language the original value contains.

For example, a rename operation can use different wording for French and French Canadian customers:

Locale	Translation for `Standard Shipping`
French (`fr`)	`Livraison standard`
French (Canada) (`fr-CA`)	`Expédition standard`

The customer’s locale determines which available translation they see at checkout.