TYPO3/Configure language and currency

From Aimeos documentation

TYPO3
Other languages:
English 100% • ‎русский 38%


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.

Language configuration

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:

  1. 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:

  1. config.language = fr

For the Swiss variant of the German translations, product names and descriptions:

  1. 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:

  1. [globalVar = GP:L = 1]
  2.   config.language = de
  3.   config.sys_language_uid = 1
  4.   plugin.tx_aimeos.settings.client.html.common.format.separatorDecimal = ,
  5.   plugin.tx_aimeos.settings.client.html.common.format.separator1000 = .
  6. [global]

Currency configuration

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:

  1. 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:

  1. 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:

  1. plugin.tx_aimeos.settings.typo3.param.name.currency = cur

Using the locale selector

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:

  1. plugin.tx_aimeos.settings.client.html.locale.select.standard.subparts {
  2.     0 = currency
  3. }

The generated list of currencies or language/currency combinations depends on the configured list in the locale panel of the administration interface.