Languages, countries, salutations
Four buttons of the settings open lists that are picked from elsewhere: Languages, Localizations, Countries and Salutation. You reach all four through the Settings navigation entry.
What distinguishes a language from a localization, and why the default localization is a decision for good, is described under languages and translations.
Overview
All four lists are built the same way. Three buttons sit above each of them: New creates an entry, Edit opens the selected one, Delete removes it after a confirmation. The latter two require a selected row. Sorting is fixed to Name, ascending. In all four cases the detail view carries a single Common section with exactly the fields the list shows.
On the languages and the localizations one row is set in bold: that is the default, and it cannot be switched here. TRADElube fixes it while the client is being set up and remembers it. What hangs off it is described under languages and translations.
Languages
A language is the entry for the language itself. It is picked on a localization, and a connected system recognizes from it what it is dealing with.
The list shows three columns, Name, Code and Iso, and the same three fields make up the detail view.
Common
| Field | Meaning | Note |
|---|---|---|
| Name | The designation you pick the language by | Has to be unique |
| Code | The language code, de or en for instance | Has to be unique as well. Up to ten characters, so a regional variant like de-AT fits in too |
| Iso | The three-letter code, ger or eng for instance | Up to three characters |
A new client comes with two languages, German and English. One of them is the default language and therefore stands in bold, in the image English.
Which one it becomes is decided while the client is being set up, and it is fixed afterwards. Left to itself TRADElube picks the entry with the code de, failing that one beginning with de-, otherwise the next best. A client working in English gets the default language set during setup. There is no button for it in the interface. So tell us the language before the first data arrives, because a later switch would silently declare all the texts already written to be in the new language.
Localizations
A localization is a named version of your data and points at exactly one language. It is what you have in front of you while maintaining data: a language tab on the record, an assignment in the transfer plan.
The list shows two columns, Name and Language. Both appear in the detail view as well.
Common
| Field | Meaning | Note |
|---|---|---|
| Name | The designation the version appears under on the record and in the transfer plan | Has to be unique together with the language: two versions of the same language may not share a name |
| Language | The language this version is written in | Not editable on the default localization, see below |
That the language of the default localization is fixed is deliberate. The texts sitting on the record itself hang off it, that is every product name in every list. Changing it would silently declare those texts to be in the new language without changing a word of them. On every further localization the language can be chosen freely.
Several localizations may point at the same language. Whoever runs a consumer shop and a trade shop thereby holds two German versions with different texts.
Countries
A country is picked on an address, that is on the customer and on the order.
Common
The list shows three columns, and the detail view carries the same three fields.
| Field | Meaning | Note |
|---|---|---|
| Name | The name of the country | Has to be unique |
| Country Code (Iso) | The two-letter country code, DE for instance | Has to be unique as well. Up to two characters |
| Country Code (Iso3) | The three-letter country code, DEU for instance | Up to three characters |
A new client comes with three countries, Germany, Austria and Switzerland. You create further ones yourself. TRADElube ships no list of all the countries in the world: few dealers ship to all of them, and a pick list with a few hundred entries only makes entering an address slower.
Salutations
A salutation is picked on an address, just like the country. It carries a single field, the Name, and it has to be unique. The detail view shows exactly that one field.
A new client comes with three salutations, Firma, Herr and Frau, in German in every client. You create further ones yourself, and the three can be renamed like any other entry.
What a connected system sees of this
All four lists have a counterpart on the far side, and none of them carries the same identifier there. That is why they are mapped: you set up once per channel which entry there corresponds to which one here. A Shopware channel carries such a mapping for languages, countries and salutations.
What a mapping is and how it is maintained is described under mappings. Which mappings a channel carries is stated on the page of its system, under Channels and tasks.
Further reading
- Languages and translations: the difference between language and localization and what hangs off the default localization
- Customers: the address salutation and country are picked on
- Mappings: how an entry here is connected to its counterpart in the connected system
- Settings: the remaining buttons