Liquid-komentojonomallien päivitys

Jos suoritat komentosarjoja verkkokaupassasi, sinun on tarkistettava, miten ne vaikuttavat myyntipaikkasi sivuihin. Monet teemat sisältävät koodia, jotka tukevat komentosarjoja, mutta joistakin teemoista tätä koodia ei löydy. Jos teemasi ei sisällä tarvittavaa koodia, voit lisätä sen.

Sopimusvaatimus

Shopify Scripts -komentosarjat ja Script Editor -sovellus ovat vain Shopify Plus -kauppiaiden saatavilla. Tämä Script Editor ei ole enää ladattavissa Shopify App Storesta.

Shopify Scripts -komentosarjat poistetaan 28. elokuuta 2025, eivätkä ne enää toimi. Siirrä nykyiset komentosarjasi Shopify Functions -toimintoihin ennen tätä päivämäärää.

Vianmääritys

Useimmat komentosarjoja ja teemoja koskevat ongelmat liittyvät rivikohtaisiin komentosarjoihin, jotka tarjoavat alennuksia. Esimerkiksi tilauksen kokonaishinta on oikea, mutta rivikohtaiset hinnat eivät näytä alennuksia. Asiakkaiden on ymmärrettävä, kuinka heidän alennuksensa lasketaan, ja he haluavat nähdä alkuperäisen ja alennetun hinnan sekä lyhyen kuvauksen alennuksesta. Jos ostoskorista puuttuu jokin näistä tiedoista, sinun on lisättävä tarvittava Liquid-koodi niiden näyttämiseen.

Yksi hyvä keino komentosarjan toiminnan tarkistamiseen on vierailla kaupassasi asiakkaana ja suorittaa komentosarjan käynnistävät toimet.

Liquid-objektin määritteet

Alla olevista luetteloista löydät tarvittavat Liquid-objektin määritteet, joita tarvitaan yleensä kauppasi ostoskorin komentosarjojen tukemiseen:

Ostoskoriobjektin määritteet:

• cart.total_discount
• cart.original_total_price

Rivikohdan määritteet:

• line_item.discounts
• line_item.message
• line_item.original_price
• line_item.original_line_price
• line_item.total_discount

Komentosarja-objekti:

• Komentosarja-objektin avulla palautat tietoja komentosarjoista, joita kauppa käyttää. Tästä objektista voi olla hyötyä, kun haluat korjata komentosarjoihin liittyviä virheitä.

Esimerkki

Seuraavassa esimerkissä kuvataan muutoksia, joiden avulla voit lisätä rivikohtaisen komentosarjan cart.liquid-malliin.

Esimerkki ostoskorista

Jos sinulla on esimerkiksi ostoskori, jossa on kolme rivikohtaa:

• Jalkapallo

  • Määrä: 1
  • Yksikköhinta: 15,00 $

• Tennispallo

  • Määrä: 5
  • Yksikköhinta: 5,00 $

• Juoksukenkä

  • Määrä: 1
  • Yksikköhinta: 30,00 $

Ja olet julkaissut komentosarjan, joka lisää seuraavat alennukset:

• 10 %:n alennus kahdesta tai useammasta tennispallosta
• 5 dollarin alennus kaikista kengistä

Tämän jälkeen cart.liquid-malli saattaa olla yksinkertainen taulukko, jossa luetellaan rivikohdat ja yhteenveto niiden kokonaissummista:

<table class="cart">
  <thead class="heading">
    <tr>
      <th>Product</th>
      <th>Quantity</th>
      <th>Total</th>
    </tr>
  </thead>

  <tbody class="line-items">
    {% for item in cart.items %}
    <tr>
      <td>{{ item.product.title }}</td>
      <td>{{ item.quantity }}</td>
      <td>{{ item.line_price | money }}</td>
    </tr>
    {% endfor %}
  </tbody>

  <tfoot class="summary">
    <tr>
      <td colspan="2">Total</td>
      <td>{{ cart.total_price | money }}</td>
    </tr>
  </tfoot>
</table>

Komentosarjan soveltamien alennusten kanssa tämä malli luo seuraavan taulukon ostoskorille:

Tuote	Määrä	Yhteensä
Jalkapallo	1	15,00 $
Tennispallo	5	22,50 $
Juoksukenkä	1	25,00 $
Yhteensä		62,50 $

Rivikohtien päivittäminen

Jos haluat näyttää komentosarjan soveltamat alennukset, sinun on ensin päivitettävä rivikohdat näyttämään kolme keskeistä tietoa:

• rivikohdan hinta ennen alennuksia
• rivikohdan hinta alennuksien jälkeen
• viesti, jossa kuvataan sovelletut alennukset.

Tämä onnistuu seuraavien Liquid-objektin määritteiden avulla:

• line_item.total_discount palauttaa rivikohtaan sovelletun alennussumman
• line_item.original_line_price palauttaa rivikohdan hinnan ennen alennuksia
• line_item.message palauttaa viestin, jossa kuvataan rivikohtaan sovelletut alennukset.

Jos haluat, että asiakas erottaa rivikohdan alkuperäisen ja alennetun hinnan vielä selkeämmin toisistaan, voit käyttää yliviivaustehostetta:

<tbody class="line-items">
  {% for item in cart.items %}
  <tr>
    <td>{{ item.product.title }}</td>
    <td>{{ item.quantity }}</td>
    <td>
      {{ item.line_price }}
      {% if item.total_discount > 0 %}
        <s>{{ item.original_line_price }}</s>
        ( {{ item.message }} )
      {% endif %}
    </td>
  </tr>
  {% endfor %}
</tbody>

Ostoskortin pitäisi nyt näyttää tältä:

Tuote	Määrä	Yhteensä
Jalkapallo	1	15,00 $
Tennispallo	5	22,50 $ 25,00 $ (10 %:n alennus kahdesta tai useammasta tennispallosta)
Juoksukenkä	1	25,00 $ 30,00 $ (5 $:n alennus kaikista kengistä)
Yhteensä		62,50 $

Ostoskorin yhteenvedon päivittäminen

Jotta asiakkaasi voi seurata tilauksensa hintaa, sinun tulee myös näyttää:

• ostoskorin alkuperäinen välisumma, jotta asiakkaasi voivat verrata alkuperäistä ja alennuksen jälkeistä kokonaissummaa
• kuinka paljon rahaa asiakas säästää ostoskorissaan olevista tuotteista.

Jotta voit lisätä nämäkin tiedot, käytä seuraavia Liquid-objektin määritteitä:

• cart.total_discount palauttaa ostoskorissa oleviin tuotteisiin sovelletun alennussumman
• cart.original_total_price palauttaa ostoskorin välisumman ennen alennuksia.

Kun lisäät nämä tiedot, päivitetty .summary-lohko voi näyttää tältä:

<tfoot class="summary">
  <tr>
    <td colspan="2">Subtotal</td>
    <td>{{ cart.original_total_price | money }}</td>
  </tr>
  <tr>
    <td colspan="2">Discount Savings</td>
    <td>{{ cart.total_discount | money }}</td>
  </tr>
  <tr>
    <td colspan="2">Total</td>
    <td>{{ cart.total_price | money }}</td>
  </tr>
</tfoot>

Ostoskoritaulukon pitäisi nyt näyttää tältä:

Tuote	Määrä	Yhteensä
Jalkapallo	1	15,00 $
Tennispallo	5	22,50 $ 25,00 $ (10 %:n alennus kahdesta tai useammasta tennispallosta)
Juoksukenkä	1	25,00 $ 30,00 $ (5 $:n alennus kaikista kengistä)
Välisumma		70,00 $
Alennussäästöt		7,50 $
Yhteensä		62,50 $

Lisäämällä muutaman uuden Liquid-objektin malleihisi autat asiakkaitasi ymmärtämään, kuinka heidän alennuksensa lasketaan.

Muita esimerkkejä

Seuraava Liquid-esimerkki näyttää kunkin rivikohdan alennuksen:

  {% if item.original_line_price != item.line_price %}
  <small class="original-price"><s>{{ item.original_line_price | money }}</s></small>
  {% endif %}
  {{ item.line_price | money }}
  {% for discount in item.discounts %}
  <small class="discount">{{ discount.title }}</small>
  {% endfor %}

Katso toinen esimerkki alennuksesta, joka sisältää Liquid-koodilla tehdyt muutokset.