Aimeos supports multiple languages and currencies in one shop site. The site/language/currency combinations available for customers must be configured in the locale panel of the administration interface.
The default language is English if nothing else is configured via TypoScript. To change the language for a complete page tree, insert the following line into the setup section of the root page of the (sub-)page tree:
config.language = <ISO language code>
The language code must be one of the codes that is enabled and used in the locale panel of the administration interface for the site. You can use two letter ISO codes like "fr", "es", etc. or ISO language codes in combination with the country code like "de_CH".
To use the french translations, product names and descriptions:
config.language = fr
For the Swiss variant of the German translations, product names and descriptions:
config.language = de_CH
If the translation for a language variant is not available, the base language will be used, e.g. German translations would be used if the Swiss variant isn't available.
The fallback to the base language is only available for translations! Product names, descriptions and all other texts in the shop need to be available in the language variant. Otherwise, the product labels (or more generally speaking, the item labels) will be used.
The number format is independent from the language configuration. To adapt this to a specific locale, you can configure decimal and thousand separator via TypoScript for each language:
[globalVar = GP:L = 1]
config.language = de
config.sys_language_uid = 1
plugin.tx_aimeos.settings.client.html.common.format.separatorDecimal = ,
plugin.tx_aimeos.settings.client.html.common.format.separator1000 = .
By default, the currency of the first locale combination added in the locale tab of the administration interface is used if nothing else is configured. You can change the default to a different value via TypoScript by using this setting:
plugin.tx_aimeos.settings.mshop.locale.currency = <ISO currency code>
The currency must be enabled and used in the locale panel of the administration interface for the site like the language.
To use US Dollar as default currency for the site and the page tree, add this configuration to the setup section of the root page of the (sub-)page tree:
plugin.tx_aimeos.settings.mshop.locale.currency = USD
The currency values must be the official three letter ISO currency codes. They reflect the values that are provided in the "mshop_locale_currency" table by default.
If your shop offers multiple currencies for one site (e.g. customers can choose to pay in Euro or US Dollar), the currency used in the shop can be set by the "loc-currency" parameter value.
The loc-currency value takes precedence over the TypoScript configuration.
Since Aimeos TYPO3 2.0, the name of the currency parameter name can be changed. Instead of "loc-currency", you can also use another name like "cur" by adding the following line to your TypoScript setup section:
plugin.tx_aimeos.settings.typo3.param.name.currency = cur
Since version 1.3 of the Aimeos TYPO3 extension, there's a plug-in for a language and currency selector available. It allows users in the front-end to change the used language and currency. In the TYPO3 context, the language is normally determined by the "config.language" TypoScript variable. Therefore, if only the currency selector should be shown, use this configuration:
0 = currency
The generated list of currencies or language/currency combinations depends on the configured list in the locale panel of the administration interface.