Siirry pääsisältöön
Koodieditorilla hallitset mallia täysin. Mallit ovat HTML:ää ja CSS:ää sekä Liquidia, samaa mallikieltä, jota Shopify käyttää: {{ order_name }} tulostaa tilauksen nimen, {% for line_item in line_items %} toistuu jokaiselle tuotteelle. Foliantin tilausmuuttujat noudattavat Shopify Order Printerin muuttujia, joten sille kirjoitetut mallit toimivat useimmiten sellaisenaan. Koodieditori on käytettävissä kaikissa tilauksissa.

Avaa koodieditori

Avaa malli editorissa ja napsauta Koodi-välilehteä. Koodimallit avautuvat suoraan siellä. Visuaalisesta mallista näet ensin käännetyn koodin. Napsauta Muokkaa koodia muuttaaksesi sitä. Katso Vaihda visuaalisen ja koodinäkymän välillä. Vasemmassa ruudussa on kolme välilehteä: Oikeassa ruudussa on reaaliaikainen esikatselu. Se päivittyy pian sen jälkeen, kun lopetat kirjoittamisen.

Lisää kenttä

  1. Vie kohdistin kohtaan, johon kenttä tulee.
  2. Napsauta Lisää kenttä.
  3. Etsi kenttä (esimerkiksi “tracking” tai “SKU”) kohdassa Hae kenttiä ja napsauta sitä.
Foliant lisää kentän Liquid-koodin kohdistimen kohdalle, esimerkiksi {{ shipping_address.city }}. Rivikohteiden kentät, kuten {{ line_item.sku }}, toimivat vain rivikohteiden silmukan sisällä: lisää itse silmukka valitsemalla Rivikohteet.

Hae koodista

Napsauta hakupainiketta Lisää kenttä -painikkeen vieressä (tai paina koodissa ⌘F / Ctrl+F) etsiäksesi tekstiä mallista.

Koodivirheet

Editori tarkistaa koodisi kirjoittaessasi ja merkitsee ongelmat marginaaliin:
  • Virheet estävät tallentamisen ja keskeyttävät esikatselun. Sulkematon {{ tai {% on virhe. Virheet luetellaan editorin yläpuolella olevassa Koodivirheitä-ilmoituksessa, ja jokaisen kohdalla on Siirry riville.
  • Varoitukset osoittavat asioita, jotka voivat olla väärin, mutta eivät estä tallentamista, esimerkiksi tuntematon Liquid-suodatin, -tagi tai -objekti, tuntematon HTML-tagi tai CSS-ominaisuus tai sulkematon HTML-tagi.
Kun tallennat, Foliant tarkistaa myös mallin: Liquidin on oltava luettavaa, HTML-tagien on oltava tasapainossa ja upotettu SVG saa sisältää vain piirtoelementtejä. Jos jokin on vialla, tallennus epäonnistuu ja Päivittäminen epäonnistui -ilmoitus luettelee enintään viisi ongelmaa ja niiden rivinumerot, jos ne tiedetään. Jos malli tallentuu, mutta esikatselua ei voida muodostaa, ilmoitus näyttää Liquidin viestin ja rivin, jos se tiedetään.

Kirjoita hyviä malleja

  • Rahasummat ovat sentteinä: tulosta ne aina rahasuodattimella, kuten {{ total_price | money }}. Katso Raha ja valuutta malleissa.
  • Käytä | escape -suodatinta asiakkaiden kirjoittamaan tekstiin, kuten huomautuksiin ja osoitteisiin: {{ note | escape }}.
  • Käytä {{ 'subtotal' | t }} tekstiin, jonka kuuluu noudattaa asiakirjan kieltä. Katso Päivämäärät, kielet ja käännökset.
  • Käytä arvonlisäverolle Foliantin valmiita koodinpätkiä: {% include 'vat_breakdown' %} tulostaa ALV-erittelytaulukon ja {% include 'legal_notes' %} lakisääteiset merkinnät (käännetty verovelvollisuus, vienti, IOSS…).

Hyvä tietää

  • Jos numeroitu malli (lasku, hyvityslasku tai tarjous) ei tulosta document_number-arvoa missään, Foliant lisää asiakirjan loppuun pienen rivin, jossa on numero. Katso Asiakirjanumerot malleissa.
  • Koodimallien sivunumerot ja toistuvat taulukon otsikot löytyvät mallin asetussivulta kohdasta Sivun asettelu.
  • Kun haluat tuoda mallin Shopify Order Printeristä tai Order Printer Prosta, käytä Mallit-sivun toimintoa Tuo malli. Katso Tuo malli Order Printeristä.

Aiheeseen liittyvät artikkelit