> ## Documentation Index
> Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Lokalisointi

> Määritä kielet, mukauta verkkokaupan käyttöliittymätekstit ja tarjoa asiakkaille käännettyä sisältöä heidän omalla kielellään.

TWICE Commerce tukee monikielisiä verkkokauppoja valmiiksi. Määrität, mitä kieliä verkkokauppasi tarjoaa, asetat oletuskielen ja voit halutessasi ohittaa minkä tahansa käyttöliittymätekstin — painikkeet, otsikot, kentät ja kassan tekstit — kielikohtaisesti. Sisällön käännökset (tuotenimet, kuvaukset) hoidetaan erikseen käännösjärjestelmän kautta.

## Miten se toimii

Lokalisoinnissa on TWICEssä kaksi kerrosta:

| Kerros                  | Mitä se kattaa                                                                                                                                                                                                                                                                                                       | Missä sitä hallitaan                                                                                                                                       |
| :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Järjestelmätekstit**  | Verkkokauppaan ja kassaan sisäänrakennettu käyttöliittymäteksti — painikkeet, otsikot, kenttien nimet, virheilmoitukset                                                                                                                                                                                              | **Asetukset > Käännökset** (Verkkokauppa / Commerce / Kassa -alueet)                                                                                       |
| **Sisällön käännökset** | Kauppiaan kirjoittama teksti — listausten nimet, kuvaukset ja mukautettujen osioiden sisältö; kokoelmien otsikot; sijaintien nimet; sopimusdokumenttien nimet; attribuuttien nimet, kuvaukset ja vaihtoehtojen nimikkeet; varianttien nimet; verkkokaupan sisältö; kassan vaiheiden kuvaukset; navigaation nimikkeet | **Asetukset > Käännökset** (Listaukset / Kokoelmat / Sijainnit / Sopimusdokumentit / Attribuutit / Variantit -alueet) sekä verkkokaupan ja kassan editorit |

Järjestelmäteksteille toimitetaan oletuskäännökset kaikilla 24 tuetulla kielellä. Ohitat yksittäisiä tekstejä silloin, kun haluat vastata brändisi äänensävyä tai selkeyttää termejä asiakkaillesi. Sisällön käännökset hallitaan aina käsin — kirjoitat käännetyn tekstin jokaiselle kentälle ja kielelle.

## Kielten määritys

### Oletuskieli

Jokaisella organisaatiolla on **oletuskieli**. Se on kieli, jolla verkkokauppasi näytetään, kun mikään muu asetus ei päde, ja perustaso, johon sisällön käännöksiä verrataan. Oletuksena se on englanti, mutta sen voi vaihtaa kohdassa **Asetukset > Käännökset**.

### Käytössä olevat kielet

Ota käyttöön lisää kieliä, jotta verkkokauppasi on saatavilla niillä. TWICE tukee 24 kieltä:

|                |               |               |                         |
| :------------- | :------------ | :------------ | :---------------------- |
| englanti (en)  | suomi (fi)    | venäjä (ru)   | saksa (de)              |
| slovakki (sk)  | ruotsi (sv)   | hollanti (nl) | unkari (hu)             |
| norja (no)     | ranska (fr)   | espanja (es)  | italia (it)             |
| tšekki (cs)    | tanska (da)   | liettua (lt)  | viro (et)               |
| puola (pl)     | sloveeni (sl) | kroaatti (hr) | brasilianportugali (br) |
| portugali (pt) | latvia (lv)   | turkki (tr)   | ukraina (uk)            |

Kielen poistaminen käytöstä säilyttää kaikki olemassa olevat ohitukset ja sisällön käännökset. Ne tulevat takaisin näkyviin, jos otat kielen uudelleen käyttöön.

## Järjestelmätekstien ohitukset

Järjestelmätekstit ovat verkkokauppasi ja kassasi sisäänrakennettuja käyttöliittymätekstejä. Jokaiselle tekstille toimitetaan TWICE Commercen ylläpitämä oletuskäännös. Voit ohittaa minkä tahansa näistä teksteistä kielikohtaisesti — myös oletuskielelläsi — vastaamaan brändisi äänensävyä.

### Alueet

Ohitukset on jaettu kolmeen alueeseen:

| Alue             | Kattaa                                                                             |
| :--------------- | :--------------------------------------------------------------------------------- |
| **Verkkokauppa** | Verkkokaupan käyttöliittymä — navigointi, tuotesivut, ostoskori, haku, suodattimet |
| **Commerce**     | Jaetut komponentit — tuotekortit, saatavuusmerkinnät, hintojen esitys              |
| **Kassa**        | Kassaprosessi — kenttien nimet, maksuvaiheet, tilausvahvistus                      |

Jokaista aluetta muokataan erikseen. Kassan ohitukset voivat lisäksi vaihdella kassamäärityksittäin, jos käytät useita kassaprosesseja.

### Ohituksen muoto

Jokainen ohitus kohdistuu tiettyyn tekstiin nimiavaruudella varustetulla avaimella. Avain yhdistää alueen nimiavaruuden ja pisteillä erotetun polun, joka yksilöi tekstin:

<CodeGroup>
  ```text Ohitusavaimen muoto theme={null}
  <namespace>:<dotted.path>

  storefront:cart.checkout
  checkout:contact.email
  commerce:productCard.bookButton
  ```

  ```json Esimerkkiohituksia (suomi) theme={null}
  {
    "storefront:cart.checkout": "Siirry kassalle",
    "storefront:cart.continueShopping": "Jatka ostoksia",
    "checkout:contact.email": "Sahkopostiosoite",
    "commerce:productCard.bookButton": "Varaa nyt"
  }
  ```
</CodeGroup>

### Ohitusten muokkaus

Avaa **Asetukset > Käännökset**, valitse kieli ja valitse alue sivupalkista (Verkkokauppa, Commerce tai Kassa). Oletuskieli näkyy muiden käytössä olevien kielten rinnalla — voit ohittaa järjestelmätekstejä millä tahansa kielellä, ei vain muilla kuin oletuskielellä.

Editori näyttää jokaisesta tekstistä:

* **Avain** — tekstin tunniste
* **Oletus** — TWICE Commercen ylläpitämä sisäänrakennettu käännös
* **Ohitus** — oma tekstisi (tyhjä, jos ohitusta ei ole)

Kirjoita ohituksesi Ohitus-sarakkeeseen. Ota se käyttöön tallentamalla. Palauta teksti oletukseen tyhjentämällä ohituskenttä.

<Note>Oletuskielen ohitukset ovat hyödyllisiä, kun haluat vastata brändisi äänensävyä muuttamatta ensisijaista kieliasetustasi. Voit esimerkiksi nimetä ”Lisää ostoskoriin” uudelleen muotoon ”Varaa nyt” oletuskielelläsi.</Note>

### Varautumislogiikka

Kun asiakas katselee verkkokauppaasi, järjestelmä ratkaisee jokaisen tekstin tässä järjestyksessä:

1. **Kauppiaan ohitus** asiakkaan kielellä — jos olet asettanut sellaisen, se voittaa
2. **Oletuskäännös** — TWICE Commercen ylläpitämä sisäänrakennettu käännös
3. **Oletuskielen arvo** — jos pyydetylle kielelle ei ole käännöstä, käytetään oletuskielen arvoa

Asiakas näkee aina tekstin. Puuttuva ohitus ei koskaan tuota tyhjää merkkijonoa.

## Verkkokaupan kielivalitsin

Kun otat käyttöön useamman kuin yhden kielen, verkkokauppa näyttää yläpalkissa **kielivalitsimen** — ohuen palkin ilmoituspalkin ja otsikon yläpuolella. Asiakkaat vaihtavat kieltä napsauttamalla sitä poistumatta sivulta.

Valitsin näyttää jokaisen kielen sen **omakielisellä nimellä** (esimerkiksi ”Deutsch” saksalle ja ”Suomi” suomelle). Aktiivinen kieli on korostettu pudotusvalikossa. Kielen vaihtaminen päivittää sivun sisällön, järjestelmätekstit ja käännetyn kauppiassisällön välittömästi.

Kielivalitsin ei näy kassa- tai tilauslinkkisivuilla. Jos käytössä on vain yksi kieli, yläpalkki piilotetaan kokonaan (ellei toimipistevalitsin ole myös näkyvissä).

### Kielen valinta

Kun asiakas saapuu verkkokauppaasi, järjestelmä päättää näytettävän kielen näin:

1. **`?lang=`-parametri** — kielivalitsin asettaa sen jokaisella vaihdolla. Voit myös linkittää sen avulla suoraan sivun tiettyyn kieliversioon.
2. **Oletuskieli** — organisaatiosi oletuskieli
3. **Ensimmäinen käytössä oleva kieli** — käytössä olevien kielten listan ensimmäinen kieli
4. **Varakieli** — englanti

Verkkokauppa lataa oikean kielipaketin, soveltaa sen päälle kauppiaan ohitukset ja näyttää sivun. Muiden kuin oletuskielen kielipaketit ladataan tarvittaessa, jotta sivut latautuvat nopeasti.

`?lang=`-parametri säilyy sivulta toiselle siirryttäessä, joten asiakkaat pysyvät valitsemallaan kielellä selatessaan.

## Tapahtumasähköpostit

Tapahtumasähköpostit (tilausvahvistukset, toimitusilmoitukset) lähetetään vastaanottajan toivomalla kielellä, jos kyseinen kieli on käytössä olevien kielten listallasi. Jos vastaanottajan kieli ei ole käytössä, sähköpostit lähetetään oletuskielelläsi.

## Usein kysyttyä

<AccordionGroup>
  <Accordion title="Mikä ero on järjestelmäteksteillä ja sisällön käännöksillä?">
    Järjestelmätekstit ovat verkkokauppasi mukana tulevaa sisäänrakennettua käyttöliittymätekstiä — painikkeiden nimiä, otsikoita, kenttien nimiä ja virheilmoituksia. Sisällön käännökset koskevat omaa sisältöäsi — listausten nimiä, kuvauksia, mukautettujen osioiden sisältöä, kokoelmien otsikoita, sijaintien nimiä, sopimusdokumenttien nimiä, attribuuttien nimiä, kuvauksia ja vaihtoehtojen nimikkeitä, varianttien nimiä, verkkokaupan sisältöä, kassan vaiheiden kuvauksia sekä navigaation nimikkeitä. Sisällön käännöksiä hallitaan kohdassa **Asetukset > Käännökset** sekä verkkokaupan ja kassan editoreissa.
  </Accordion>

  <Accordion title="Pitääkö järjestelmätekstit kääntää itse?">
    Ei. Järjestelmäteksteille toimitetaan oletuskäännökset kaikilla 24 tuetulla kielellä. Ohitat yksittäisiä tekstejä vain silloin, kun haluat mukauttaa sanamuotoa — millä tahansa kielellä, myös oletuskielelläsi.
  </Accordion>

  <Accordion title="Voiko eri kassamäärityksillä olla eri ohitukset?">
    Kyllä. Jokaisella kassamäärityksellä voi olla oma joukkonsa järjestelmätekstien ohituksia. Tästä on hyötyä, jos käytät eri kassaprosesseja eri käyttötapauksiin (esimerkiksi vuokraus vs. osto).
  </Accordion>

  <Accordion title="Mitä tapahtuu, jos poistan kielen käytöstä?">
    Kielen poistaminen käytöstä poistaa sen verkkokaupastasi. Kaikki kyseisen kielen ohitukset ja sisällön käännökset säilyvät ja palaavat näkyviin, jos otat kielen uudelleen käyttöön.
  </Accordion>

  <Accordion title="Kääntääkö järjestelmä sisällön automaattisesti?">
    Ei. Sisällön käännökset ja järjestelmätekstien ohitukset hallitaan käsin. Kirjoitat tai tuot käännetyn tekstin jokaiselle kentälle ja kielelle.
  </Accordion>

  <Accordion title="Voinko viedä ja tuoda käännöksiä?">
    Kyllä. Käännöseditori tukee massavientiä ja -tuontia sekä sisällön käännöksille että järjestelmätekstien ohituksille.
  </Accordion>
</AccordionGroup>

## Aiheeseen liittyvät käsitteet

<CardGroup cols={2}>
  <Card title="Monikielinen sisältö" icon="language" href="/docs/fi/concepts/admin/translations">
    Käännä listauksia, kokoelmia, sijainteja, attribuutteja ja variantteja
  </Card>

  <Card title="Verkkokauppa" icon="store" href="/docs/fi/concepts/sales-channels/online-store">
    Verkkokaupan arkkitehtuuri, teemat ja usean toimipisteen tuki
  </Card>

  <Card title="Asetukset – Käännökset" icon="gear" href="/docs/fi/settings/translations">
    Vaiheittainen opas käännösasetusten käyttöliittymään
  </Card>
</CardGroup>