Varmista Builder.io-lokalisoinnin edellytykset

Builder.io Headless CMS:n monikielinen sisältö edellyttää, että käytössä oleva Builder.io-tilaus sisältää lokalisoinnin ja että jokaisen kielialueen verkkotunnus, locale-koodi ja URL-rakenne on päätetty. Varmista ennen muutoksia myös, että kyseinen AI Commerce -kauppa todella lukee tämän sisällön Builder.io-palvelusta. AI Commercen oma Sisällönhallinta on erillinen sisältömalli eikä tämä ohje muuta sen sisältöjä.

Kirjaa hyväksytty vastaavuus esimerkiksi muodossa fi-FI → https://example.fi, sv-SE → https://example.se ja oletus → https://example.com. Käytä samoja locale-koodeja Builder.io-tilan asetuksissa, esikatselulogiikassa, sisällön kohdistuksessa ja kaupan kielireiteissä. Älä ota malliksi toisen tenantin verkkotunnuksia.

Salli kohdistaminen useaan URL-osoitteeseen

Usean URL-osoitteen kohdistaminen otetaan Builder.io-tilan asetuksissa käyttöön ennen kielikohtaisten sivujen tekemistä. Avaa Builder.io-valikko Settings, siirry kohtaan Advanced Settings ja ota käyttöön Allow targeting to multiple URLs. Tämä mahdollistaa saman sisältömerkinnän kohdistamisen hyväksytyille kieli- ja verkkotunnusosoitteille.

Pidä kohdistusehdot yksinkertaisina: lisää vain ne URL-polut ja verkkotunnukset, joilla kyseisen sisällön kuuluu näkyä. Älä lisää yleisiä ehtoja, jotka voivat osua toisen kielen tai tenantin sivuun. Dokumentoi jokaisen kohdistuksen omistaja ja testattava julkinen osoite.

Lisää kielialueet Builder.io-tilaan

Builder.io-lokalisointi määritetään tilan asetuksissa. Avaa Builder.io-valikko Settings, valitse Space ja avaa kohdan Targeting → Localization muokkaus. Lisää jokainen hyväksytty locale-koodi, esimerkiksi fi-FI ja sv-SE, vahvista syöte Enter-näppäimellä ja tallenna valitsemalla Save Changes.

Käytä yhtä kirjoitusasua kaikkialla. Locale-koodien kirjainkoko ja väliviiva on huomioitava myös esikatselun reitityksessä. Älä lisää kielialuetta vain Builder.ioon, jos kaupalla ei ole vastaavaa kieli-, verkkotunnus- ja URL-sopimusta.

Määritä mallin dynaaminen esikatseluosoite

Dynaaminen esikatseluosoite ohjaa Builder.io-editorin oikeaan kielikohtaiseen verkkotunnukseen. Avaa Builder.io-valikko Content, valitse Content Models, avaa käytettävä malli, esimerkiksi Page, ja muokkaa kohtaa Edit dynamic preview URL. Esikatselu vaikuttaa editorin osoitteeseen; se ei yksin julkaise sisältöä eikä muuta kaupan tuotantoreititystä.

Käytä projektin hyväksyttyjä verkkotunnuksia ja normalisoi locale ennen vertailua. Esimerkiksi:

const rawPath = targeting.urlPath || '';
const path = rawPath.startsWith('/') ? rawPath : `/${rawPath}`;
const language = (locale || '').toLowerCase();

switch (language) {
  case 'sv-se':
    return 'https://example.se' + path;
  case 'fi-fi':
    return 'https://example.fi' + path;
  default:
    return 'https://example.com' + path;
}

Vaihda kaikki kolme esimerkkiverkkotunnusta ennen tallennusta. Testaa tyhjä polku, kauttaviivalla alkava polku, fi-FI, sv-SE ja tuntematon locale. Esikatselu ei saa ohjata ulkopuoliselle tai väärän tenantin verkkotunnukselle.

Ota lokalisointi käyttöön sisältökentissä

Lokalisointi otetaan käyttöön sisältömallin kentissä erikseen. Avaa Builder.io-valikko Content Models, valitse malli ja sen Fields-välilehti. Avaa lokalisoitava kenttä, kuten Title tai Meta Description, ja ota käyttöön Localize. Tee sama kaikille kentille, joiden arvon pitää voida erota kielialueittain.

Älä lokalisoi tunnisteita, integraatioavaimia tai muita yhteisiä kenttiä vain varmuuden vuoksi. Päätä kenttäkohtaisesti, onko arvo yhteinen vai kielikohtainen. Jos kuva vaihtelee kielen tai markkinan mukaan, lokalisoitu kuvarivi on sallittu vain, kun jokaiselle kielialueelle on hyväksytty oikea aineisto ja vaihtoehtoinen teksti.

Luo sisältö jokaiselle kielialueelle

Monikielinen Builder.io-sisältö luodaan valitsemalla Builder.io-näkymässä Content ensin oikea locale, esimerkiksi fi-FI, ja avaamalla uusi tai olemassa oleva sisältö. Lisää komponentit valitun localen alle. Valinta Default ei ole tässä mallissa julkaistava kieliversio, joten älä jätä näkyvää sisältöä vain oletusarvon varaan.

Avaa Builder.io-kohta Targeting ja lisää kaikki hyväksytyt URL-polut, joilla sisältö näytetään eri verkkotunnuksissa. Lisää sitten muiden kielten arvot locale- tai maapallovalinnasta. Käännä vähintään otsikko, metakuvaus, näkyvä teksti, linkit, kuvat ja kuvien vaihtoehtoiset tekstit silloin, kun kentät on määritetty lokalisoitaviksi.

Pidä komponenttirakenne yhteisenä, jos markkinakohtaista poikkeusta ei ole päätetty. Tarkista jokaisen linkin kohde samalla kielellä ja varmista, ettei yhden localen sisältö viittaa toisen verkkotunnuksen polkuun.

Julkaise ja testaa kieliversiot

Builder.io-kieliversiot julkaistaan valitsemalla Publish vasta, kun kaikki pakolliset lokalisoidut kentät ja URL-kohdistukset on tarkistettu. Testaa ensin editorin esikatselussa jokainen locale ja verkkotunnus. Sen jälkeen testaa kaupan todellinen julkinen URL erikseen, sillä dynaamisen esikatselun onnistuminen ei todista tuotantointegraation hakua, välimuistia tai reititystä.

Varmista jokaisesta kielialueesta sivun sisältö, otsikko, metakuvaus, kuvat, linkit, URL-polku, canonical-osoite ja kieliversioiden väliset viittaukset. Testaa myös tuntematon locale ja puuttuva käännös: kumpikaan ei saa näyttää vahingossa väärän kielialueen tai väärän tenantin sisältöä. Kirjaa julkaistun Builder.io-sisällön tunniste, versio, locale, kohdeosoite ja hyväksyjä mahdollista palautusta varten.