Ενημέρωση των προτύπων Liquid για Scripts

Αν εκτελείτε script στο διαδικτυακό σας κατάστημα, τότε πρέπει να ελέγξετε πώς επηρεάζουν τις σελίδες στο ηλεκτρονικό σας κατάστημα. Πολλά θέματα περιλαμβάνουν κώδικα για την υποστήριξη των script σας, αλλά ορισμένα όχι. Αν το θέμα σας δεν έχει τον κώδικα, τότε μπορείτε να τον προσθέσετε.

Απαίτηση προγράμματος

Από τις 30 Ιουνίου 2026, το Shopify Scripts έχει καταργηθεί. Τυχόν Scripts που ήταν ακόμα δημοσιευμένα στο κατάστημά σας έχουν απενεργοποιηθεί και δεν λειτουργούν πλέον. Για να δημιουργήσετε ξανά αυτές τις προσαρμογές, μεταβείτε στο Shopify Functions. Μάθετε περισσότερα για τη μετάβαση από το Shopify Scripts στο Shopify Functions.

Αντιμετώπιση προβλημάτων

Τα περισσότερα προβλήματα με τα script και τα θέματα αφορούν script στοιχείων γραμμής που προσφέρουν εκπτώσεις. Για παράδειγμα, η συνολική τιμή της παραγγελίας είναι σωστή, αλλά οι τιμές των στοιχείων γραμμής δεν εμφανίζουν τις εκπτώσεις. Οι πελάτες πρέπει να κατανοήσουν πώς υπολογίζονται οι εκπτώσεις τους. Θέλουν να βλέπουν την αρχική τιμή και την τιμή με την έκπτωση, καθώς και μια σύντομη περιγραφή της έκπτωσης. Αν κάποια από αυτές τις λεπτομέρειες λείπει από το καλάθι σας, τότε πρέπει να προσθέσετε τον κώδικα Liquid για να εμφανίζονται.

Ένας καλός τρόπος για να ελέγξετε πώς το script σας επηρεάζει το ηλεκτρονικό σας κατάστημα είναι να το επισκεφθείτε ως πελάτης και να εκτελέσετε τις ενέργειες που ενεργοποιούν το script.

Χαρακτηριστικά αντικειμένου Liquid

Οι παρακάτω λίστες περιέχουν χαρακτηριστικά αντικειμένου Liquid που συνήθως χρειάζονται για την υποστήριξη script στο καλάθι του καταστήματός σας:

Χαρακτηριστικά αντικειμένου καλαθιού:

• cart.total_discount
• cart.original_total_price

Χαρακτηριστικά στοιχείου γραμμής:

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

Αντικείμενο script:

• Το αντικείμενο script μπορεί να χρησιμοποιηθεί για την επιστροφή πληροφοριών σχετικά με τα ενεργά script ενός καταστήματος. Αυτό το αντικείμενο μπορεί να είναι χρήσιμο κατά την εκσφαλμάτωση των script.

Παράδειγμα

Το παρακάτω παράδειγμα περιγράφει τις αλλαγές που μπορείτε να κάνετε στο πρότυπο cart.liquid για την υποστήριξη ενός script στοιχείου γραμμής.

Παράδειγμα καλαθιού

Για παράδειγμα, αν έχετε ένα καλάθι με τρία στοιχεία γραμμής:

• Μπάλα ποδοσφαίρου
  • Ποσότητα: 1
  • Τιμή μονάδας: 15,00 $
• Μπαλάκι του τένις
  • Ποσότητα: 5
  • Τιμή μονάδας: 5,00 $
• Παπούτσι για τρέξιμο
  • Ποσότητα: 1
  • Τιμή μονάδας: 30,00 $

Και έχετε δημοσιεύσει ένα script που εφαρμόζει τις ακόλουθες εκπτώσεις:

• Έκπτωση 10% σε δύο ή περισσότερα μπαλάκια του τένις
• Έκπτωση 5 $ σε όλα τα παπούτσια

Στη συνέχεια, το πρότυπο cart.liquid μπορεί να είναι ένας απλός πίνακας που παραθέτει τα στοιχεία γραμμής και μια σύνοψη των συνολικών ποσών τους:

<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>

Με τις εκπτώσεις που εφαρμόζονται από το script, αυτό το πρότυπο δημιουργεί τον ακόλουθο πίνακα για το καλάθι σας:

Προϊόν	Ποσότητα	Σύνολο
Μπάλα ποδοσφαίρου	1	15,00 $
Μπαλάκι του τένις	5	22,50 $
Παπούτσι για τρέξιμο	1	25,00 $
Σύνολο		62,50 $

Ενημέρωση των στοιχείων γραμμής

Για να εμφανιστούν οι εκπτώσεις που εφαρμόστηκαν από το script, πρέπει να ενημερώσουμε τα στοιχεία γραμμής ώστε να εμφανίζουν τρία βασικά στοιχεία πληροφοριών:

• η τιμή γραμμής πριν από τις εκπτώσεις
• η τιμή γραμμής μετά τις εκπτώσεις
• ένα μήνυμα που περιγράφει τις εκπτώσεις που εφαρμόστηκαν.

Για να το κάνετε αυτό, χρησιμοποιήστε τα ακόλουθα χαρακτηριστικά αντικειμένου Liquid:

• Το line_item.total_discount επιστρέφει το ποσό της έκπτωσης που έχει εφαρμοστεί στο στοιχείο γραμμής
• Το line_item.original_line_price επιστρέφει την τιμή του στοιχείου γραμμής πριν από τις εκπτώσεις
• Το line_item.message επιστρέφει ένα μήνυμα που περιγράφει τις εκπτώσεις που εφαρμόστηκαν στο στοιχείο γραμμής.

Μπορεί να σας βοηθήσει να διαφοροποιήσετε την αρχική τιμή του στοιχείου γραμμής από την τιμή με την έκπτωση, χρησιμοποιώντας μια διαγραφή με γραμμή:

<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>

Το καλάθι σας θα πρέπει τώρα να έχει την εξής μορφή:

Προϊόν	Ποσότητα	Σύνολο
Μπάλα ποδοσφαίρου	1	15,00 $
Μπαλάκι του τένις	5	22,50 $ 25,00 $ (Έκπτωση 10% σε δύο ή περισσότερα μπαλάκια του τένις)
Παπούτσι για τρέξιμο	1	25,00 $ 30,00 $ (Έκπτωση 5 $ σε όλα τα παπούτσια)
Σύνολο		62,50 $

Ενημέρωση της σύνοψης του καλαθιού

Για να βοηθήσετε τον πελάτη να παρακολουθεί την τιμή της παραγγελίας του, θα πρέπει επίσης να εμφανίσετε:

• το αρχικό μερικό σύνολο του καλαθιού, για να επιτρέψετε στους πελάτες να συγκρίνουν τα σύνολα πριν και μετά την έκπτωση
• το συνολικό κέρδος που έλαβε ο πελάτης στο καλάθι του.

Και πάλι, για να προσθέσετε αυτές τις πληροφορίες, χρησιμοποιήστε τα ακόλουθα χαρακτηριστικά αντικειμένου Liquid:

• Το cart.total_discount επιστρέφει το ποσό της έκπτωσης που εφαρμόζεται στα είδη στο καλάθι
• Το cart.original_total_price επιστρέφει το μερικό σύνολο του καλαθιού πριν από τις εκπτώσεις.

Με αυτές τις πληροφορίες, το ενημερωμένο μπλοκ .summary μπορεί να έχει την εξής μορφή:

<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>

Ο πίνακας του καλαθιού σας θα πρέπει τώρα να έχει την εξής μορφή:

Προϊόν	Ποσότητα	Σύνολο
Μπάλα ποδοσφαίρου	1	15,00 $
Μπαλάκι του τένις	5	22,50 $ 25,00 $ (Έκπτωση 10% σε δύο ή περισσότερα μπαλάκια του τένις)
Παπούτσι για τρέξιμο	1	25,00 $ 30,00 $ (Έκπτωση 5 $ σε όλα τα παπούτσια)
Μερικό σύνολο		70,00 $
Όφελος έκπτωσης		7,50 $
Σύνολο		62,50 $

Προσθέτοντας μερικά νέα αντικείμενα Liquid στα πρότυπά σας, μπορείτε να βοηθήσετε τους πελάτες σας να κατανοήσουν τον τρόπο υπολογισμού των εκπτώσεών τους.

Άλλα παραδείγματα

Το παρακάτω παράδειγμα Liquid εμφανίζει τις εκπτώσεις για κάθε στοιχείο γραμμής:

{% 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 %}

Δείτε ένα άλλο παράδειγμα έκπτωσης που περιλαμβάνει τις αλλαγές στον κώδικα Liquid.