Blogin luominen Builderio-sisällöntuotantotyökalulla helpottaa sisällön hallintaa ja minimoi manuaalista työtä. Voit automatisoida blogiartikkelien listaukset, jolloin uusia artikkeleita ei tarvitse lisätä käsin luetteloihin. Kategoriarakenne voidaan myös toteuttaa dynaamisesti erillisten koodejen ja integraatioiden avulla, jolloin ylläpito nopeutuu merkittävästi. Alla on vaiheittaiset ohjeet blogin rakentamiseen, oleellisimmat asetukset sekä vinkkejä jatkokehitystä varten.
 

1) Luo uusi Model

1. Siirry Builderioon ja valitse uuden mallin (Model) luonnin näkymä.
2. Anna mallin nimeksi: Blog article (täsmälleen tämä kirjoitusasu, ilman ylimääräisiä merkkejä).
   • Huom. Nimen on oltava juuri “Blog article” (englanniksi), sillä yksikin väärä merkki estää sen toiminnan.

2) Määritä kentät (Fields)

Siirry mallin Fields-välilehdelle ja lisää seuraavat kentät. Huom A ja B riippuu siitä, tuetko useaa kieltä blogissa.

A) Yksikielisillä kauppoilla aseta ne pakollisiksi.
B) Monikielisillä kaupoilla poista niiden pakotus, jos valitset parametrin lokalisoitavaksi. Yleensä vähintään title ja handle ovat lokalisoidut, päivämäärä ei.

• title: Artikkelin otsikko
• handle: Artikkelin URL-osoitteen (slug) pääte ilman erikoismerkkejä ja ilman mitään etuliitteitä, esim “uusi-toimipiste-avattu”. Linkki ei toimi, jos URL sisältää mitään muita erikoismerkkejä kuin väliviivan.
• image: Blogiartikkelin pääkuva, jota voidaan käyttää artikkelin sivulla ja kategorianäkymissä.
• date: Julkaisupäivämäärä, jota voidaan hyödyntää blogien lajitteluun.
• blurb: Lyhyt esikatseluteksti, joka näkyy blogilistauksissa ja tarvittaessa hakutuloksissa (SEO-hyöty).

Jos tarvitset lisää kenttiä (esimerkiksi pidempi kuvausteksti), voit luoda niitä. Integraatiokumppanisi voi lisätä taustalle tarvittavaa logiikkaa.

3) Aseta dynaaminen esikatselu verkkotunnuksille

1. Avaa mallin “Blog article” asetukset ja mene “Options” välilehteen.
2. Määritä dynamic preview URL vastaamaan verkko-osoitetta ja blogin rakennetta. Kuva alla.
3. Näin pääset esikatselemaan kutakin artikkelia sen oman URL-osoitteen kautta.

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

switch (language) {
    case 'et-EE':
        return "https://veronashelters.ee" + path
    default:
        return "https://turvakauppa.com" + path
}

5) Tarkista asetukset

• Unique identifier tulee olla tarkalleen “blog-article”. Yhdenkin merkin virhe rikkoo toiminnan.
• Public readable tulee olla päällä. Muutoin artikkeli ei näy.

Monikielisessä kaupassa: Mene tilin pääasetuksiin (https://builder.io/account/space) ja tarkista että Locales sisältää samat lokaalit kuin verkokaupan MyStoressa Domains -sivulla arvo Hreflang, esim “fi-FI”. Kirjainkoolla on Builderiolle merkitystä. 

Monikielisessä kaupassa: Virhetilanteissa integraatiopartnerin tulee tarkistaa, että CloudFront välittää samat lokaalit, esimerkiksi “et-EE”, kuin Domainin asetukset hallintapaneelissa. Builderio tarvitsee lokaalin ennen kuin AI Commercen backend vastaa, joten lokaali haetaan verkkopyynnön X-Forwarded-Locale otsakkeesta.

Monikielisessä kaupassa: Mene Advanced Settings ja tarkista että “Allow targeting to multiple URLs on päällä”. Jos tämä asetus ei ole päällä, et pysty lisään eri kielisiä URL-osotteita Preview näkymään myöhemmässä vaiheesa.

6) Artikkelien luominen 

Varmista, että URL-osoitteen targetointi käyttää vain yhtä WHERE -ehtoa, ja kaikki käyttämänne kielivaihtoehdot on lisättynä. Päätätte itse mikä URL on eri kielillä. Täsmälleen sama kirjoitusasu tulee olla “handle”:ssa (HUOM! Ilman polkua).

Varmista, että olet täyttänyt eri kielillä vähintään Titlen ja Handlen, muutoin artikkeli ei toimi! Monikieliset kaupat eivät täytä ollenkaan Default -valintaa. Builderio on tarkoittanut sen yksikielisille kaupoille.

HUOM! Älä lisää polkua “handle” -osioon. Se tulee olla pelkkä sivun slugi kuten “kevaan-turvallisuustsekki”.

Lokalisoi tarvittavat kentät, kuten tekstiä sisältävät kuvat ja teksilohkot. Älä turhaan lokalisoi kaikkea, jotta vältyt päällekkäiseltä manageroinnilta.

7) Kategorisointi 

• AI Commerce tukee automaattista Builderio -artikkelien kategorisointia GraphQL -rajapinnalla. Käyttöliittymän integraatiopartneri voi halutettasi aktivoida toiminnon.

Yhteenveto

Blogin luominen Builderiossa koostuu uuden blog-article-mallin rakentamisesta, pakollisten kenttien määrittämisestä sekä dynaamisen esikatselun (preview URL) asettamisesta. Tärkeää on huolehtia asetukset kerralla kuntoon, jotta virheiden metsästykseltä vältytään jatkossa.