Mukautettujen skriptien käyttäminen ilmoitusmalleissa

Mitä on malliskripting?

Ilmoitusmallit tukevat skriptikieltä nimeltä Liquid (Scribanin pohjalta). Tämän avulla voit sisällyttää lähetystietoja, joita ei ole saatavilla tavallisina yhdistämistageina — kuten mukautettuja viitekenttiä — sekä lisätä yksinkertaista logiikkaa, kuten "näytä tämä osio vain, jos arvo on olemassa."

Sinun ei tarvitse olla kehittäjä käyttääksesi tätä ominaisuutta, mutta se vaatii, että kirjoitat koodia suoraan mallieditoriin.

Milloin minun kannattaa käyttää skriptejä?

Käytä skriptejä, kun:

• Tarvitset viitekentän, jolle ei ole saatavilla tavallista yhdistämistagia (esimerkiksi mukautettu tilausviite, joka on tallennettu tietyn viitetyypin alle)
• Haluat näyttää tai piilottaa osion sen mukaan, onko arvo olemassa
• Sinun täytyy rakentaa mukautettu URL käyttämällä lähetystietoja

Tavallisille kentille, kuten vastaanottajan nimelle, tilausnumerolle tai seurantalinkille — käytä normaaleja yhdistämistageja. Skripting on tarkoitettu erityistilanteisiin.
 

Mihin skriptit lisätään editorissa

Skriptit täytyy lisätä olemassa olevan sisältölohkon sisään — ei erillisenä itsenäisenä lohkona. Jos lisäät skriptilohkon yksinään, sähköpostiisi syntyy tyhjä väli.

Kaksi tyypillistä paikkaa skriptien lisäämiseen:

1. Tekstilohkon sisällä — arvon näyttämiseksi osana sähköpostitekstiä
2. Painikkeen linkkikentässä — dynaamisen URL-osoitteen rakentamiseen

Esimerkki 1: Näytä viitekenttä sähköpostitekstissä

Tämä esimerkki näyttää, miten mukautettu viitearvo (viitetyyppi 7 — vastaanottajan viite) näytetään sähköpostissasi.

1. Avaa mallisi. Siirry kohtaan Portal > Settings > Notifications > Templates ja avaa muokattava malli.
    
2. Napsauta tekstilohkoa, johon arvo halutaan näkyviin. Skriptin täytyy olla samassa lohkossa muun tekstin kanssa — ei erillisessä lohkossa.
    

3. Kirjoita skripti lohkon alkuun. Liitä seuraava aivan tekstilohkon alkuun, ennen muuta sisältöä:

   {%- for rf in references -%}{%- if rf.type_id == 7 -%}{%- assign ref_val = rf.value -%}{%- endif -%}{%- endfor -%}

   
   Lisää seuraavalle riville otsikko ja tulosta arvo:

   Vastaanottajan viite: {{ ref_val }}

    

4. Esikatsele malli. Käytä Preview-painiketta ja syötä viivakoodi lähetyksestä, jossa on vastaanottajan viite. Varmista, että arvo näkyy oikein.
    

   

    

Entä jos viite puuttuu joistakin lähetyksistä?

Lisää varavaihtoehto, jotta mikään ei näytä rikkinäiseltä. Tämä piilottaa koko rivin, jos arvoa ei löydy:

{%- for rf in references -%}{%- if rf.type_id == 7 -%}{%- assign ref_val = rf.value -%}{%- endif -%}{%- endfor -%}
{% if ref_val %}Vastaanottajan viite: {{ ref_val }}{% endif %}

Esimerkki 2: Näytä osio ehdollisesti

Käytä tätä näyttämään tekstilohko vain, kun tietty ehto täyttyy — esimerkiksi näyttämään nouto-ohjeet vain, kun noutokoodi on olemassa.

{% if pickup_code %}
Noutokoodisi on: {{ pickup_code }}
Näytä tämä koodi, kun haet pakettisi.
{% endif %}

Esimerkki 3: Dynaaminen painike-URL

Kiinteän URL-osoitteen sijaan voit sisällyttää lähetystietoja linkkiin.

1. Lisää painikelohko malliin.
    

2. Avaa painikkeen linkkiasetukset ja syötä URL. Yksinkertaisille kentille kirjoita URL suoraan linkkikenttään:

   https://anywebsite.no/?s={{any_number}}

   
   
   Viitearvo URL-osoitteessa:

   {%- for rf in references -%}{%- if rf.type_id == 7 -%}{%- assign ref_val = rf.value -%}{%- endif -%}{%- endfor -%}https://yourwebsite.com/search?ref={{ ref_val }}

   Huom: Pidä kaikki yhdellä rivillä ilman välilyöntiä skriptin ja URL-osoitteen välillä.

Yleiset viitetyyppien ID:t

Viitteet tunnistetaan type_id-numerolla. Korvaa 7 yllä olevissa esimerkeissä sen kentän type ID:llä, jota tarvitset.

Jos et ole varma, mitä type ID:tä kenttäsi käyttää, tarkista lähetys Shipment Data API:sta tai ota yhteyttä nShiftin tukeen.