Αντιμετώπιση προβλημάτων για τα εισαγόμενα πρότυπα του Order Printer

Όταν μετεγκαθιστάτε τα πρότυπά σας από την εφαρμογή παλαιού τύπου Order Printer στη νέα εφαρμογή Shopify Order Printer, οι μεταβλητές Liquid ενημερώνονται για να διασφαλιστεί η συμβατότητα με τη νέα εφαρμογή. Σε σπάνιες περιπτώσεις, μπορεί να χρειαστεί να αντιμετωπίσετε προβλήματα με τα εισαγόμενα πρότυπά σας.

Αν τα εισαγόμενα πρότυπά σας δεν εκτυπώνονται σωστά, τότε μπορεί να χρειαστεί να επεξεργαστείτε μη αυτόματα τον κώδικα του προτύπου σας στη νέα εφαρμογή Shopify Order Printer. Ελέγξτε τους παρακάτω πιο συνηθισμένους λόγους για τους οποίους τα πρότυπα ενδέχεται να μην εισάγονται σωστά:

Τα πρότυπα περιλαμβάνουν προσαρμοσμένη γλώσσα CSS
Τα πρότυπα περιέχουν μετα-πεδία
Οι μεταβλητές Liquid ενδέχεται να μην ενημερωθούν σωστά

Σε αυτήν τη σελίδα μπορείτε να βρείτε αναλυτικές πληροφορίες σχετικά με τον τρόπο αντιμετώπισης πιθανών προβλημάτων κατά την εισαγωγή των προσαρμοσμένων προτύπων σας στη νέα εφαρμογή Shopify Order Printer.

Σε αυτήν τη σελίδα

Ενημέρωση κοινών προσαρμογών σχεδίασης CSS

Αν τα πρότυπα που μεταφέρετε περιλαμβάνουν προσαρμοσμένο κώδικα CSS, τότε μπορεί να χρειαστεί να ενημερώσετε με μη αυτόματο τρόπο τον κώδικα CSS στα πρότυπά σας για τη σωστή εμφάνιση στοιχείων σχεδίασης, όπως εικόνες, προσαρμοσμένες γραμματοσειρές, λογότυπα ή γραμμωτούς κώδικες.

Ενημέρωση μεταβλητών μετα-πεδίων

Για να αποκτήσετε πρόσβαση σε ένα μετα-πεδίο, πρέπει να καθορίσετε τον χώρο ονομάτων του μετα-πεδίου και δεν χρειάζεται να προσθέσετε το .value στη μεταβλητή. Μάθετε περισσότερα σχετικά με τους ορισμούς μετα-πεδίων.

Για παράδειγμα, αντί για τη μεταβλητή product.metafields.custom.manufacturerid.value, χρησιμοποιήστε τη μεταβλητή product.metafields.custom.manufacturerid.

Για να προσδιορίσετε τις τιμές του χώρου ονομάτων για κάθε μετα-πεδίο, ανατρέξτε στη σελίδα Προσαρμοσμένα δεδομένα στον Διαχειριστή Shopify. Οι ορισμοί μετα-πεδίων ομαδοποιούνται ανάλογα με τα αντικείμενα στα οποία αναφέρονται, όπως προϊόντα, παραλλαγές ή παραγγελίες.

Ενημέρωση κοινών μεταβλητών Liquid

Στις περισσότερες περιπτώσεις, οι μεταβλητές Liquid ενημερώνονται αυτόματα κατά τη διαδικασία μετεγκατάστασης. Ωστόσο, εάν δεν γίνει σωστά η μετεγκατάσταση των προτύπων σας και χρησιμοποιείτε κάποια από τις μεταβλητές που αναφέρονται σε αυτή την ενότητα, τότε μπορεί να χρειαστεί να αντικαταστήσετε μη αυτόματα τις παλιές μεταβλητές με νέες. Η εφαρμογή Shopify Order Printer χρησιμοποιεί διαφορετικές μεταβλητές από την παλαιού τύπου εφαρμογή Order Printer.

Για παράδειγμα, αν χρησιμοποιείτε τη μεταβλητή date, τότε θα πρέπει να την αντικαταστήσετε με τη μεταβλητή created_at.

Μεταβλητές παραγγελίας

Οι μεταβλητές παραγγελίας χρησιμοποιούνται διαφορετικά στην εφαρμογή Shopify Order Printer. Για να αποκτήσετε πρόσβαση στις μεταβλητές παραγγελίας, πρέπει να προσθέσετε το πρόθεμα order.. Για παράδειγμα, για να αποκτήσετε πρόσβαση στη μεταβλητή billing_address, πρέπει να χρησιμοποιήσετε τη μεταβλητή order.billing_address.

Οι παρακάτω συνήθεις μεταβλητές παραγγελίας είναι προσβάσιμες χωρίς το πρόθεμα order.:

line_items
tax_lines
fulfillments
transactions
refunds
shipping_methods
customer

Για παράδειγμα, αν θέλετε να αποκτήσετε πρόσβαση στη μεταβλητή στοιχείων γραμμής, μπορείτε να χρησιμοποιήσετε το line_items ή το order.line_items.

Μπορείτε επίσης να δημιουργήσετε τα δικά σας ψευδώνυμα για το πρότυπό σας. Για παράδειγμα, μπορείτε να χρησιμοποιήσετε τη σύνταξη Liquid {% assign fulfillments_count = order.fulfillments | size %} και, στη συνέχεια, να αναφερθείτε σε αυτή χρησιμοποιώντας το {{ fulfillments_count }} στον κώδικά σας.

Μεταβλητή παραγγελίας
Μεταβλητή στην παλαιού τύπου εφαρμογή Order Printer	Μεταβλητή στη νέα εφαρμογή Shopify Order Printer
`line_items`	Στοιχεία γραμμής επιστροφής χρημάτων δεν περιλαμβάνονται στη `line_items` μεταβλητή. Εξετάστε τις παρακάτω λεπτομέρειες: Μπορείτε να αποκτήσετε πρόσβαση στα επιστρεφόμενα στοιχεία γραμμής χρησιμοποιώντας τη μεταβλητή `refunds.<each>.refund_line_items`. Εξετάστε το ακόλουθο παράδειγμα. `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %}` Μπορείτε να προσθέσετε τα επιστρεφόμενα στοιχεία γραμμής στη συλλογή `line_items`, αν θέλετε. Εξετάστε το ακόλουθο παράδειγμα. `{% assign refunded_line_items = order.refunds \| map: "refund_line_items" \| map: "line_item" %} {% assign line_items_with_refunded = order.line_items \| concat: refunded_line_items \| uniq %}` Πρέπει να βεβαιωθείτε ότι περιλαμβάνετε το φίλτρο `\| uniq` για να αποφύγετε τα διπλότυπα των στοιχείων γραμμής επιστροφής χρημάτων. Στοιχεία γραμμής φιλοδωρήματος δεν περιλαμβάνονται στη `line_items` μεταβλητή. Εξετάστε τις παρακάτω λεπτομέρειες: Μπορείτε να αποκτήσετε πρόσβαση στα στοιχεία γραμμής φιλοδωρήματος χρησιμοποιώντας τη μεταβλητή `tip_line_items`. Μπορείτε να προσθέσετε τα `tip_line_items` στη συλλογή `line_items`, αν θέλετε. Εξετάστε το ακόλουθο παράδειγμα. `{% assign line_items_with_tips = order.line_items \| concat: order.tip_line_items %}` Για να μιμηθείτε τη συλλογή `line_items` της προηγούμενης έκδοσης του Order Printer, μπορείτε να χρησιμοποιήσετε τον ακόλουθο κώδικα-παράδειγμα. `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %} {% assign all_line_items = order.line_items \| concat: refunded_line_items \| concat: order.tip_line_items \| uniq %} {% for line_item in all_line_items %} ... {% endfor %}`
`credit_card`	Χρησιμοποιήστε τα στοιχεία πληρωμής από κάθε συναλλαγή της παραγγελίας, με τη μεταβλητή `transactions.<each>.payment_details`.
`current_shipping_price`	`shipping_price`
`date`	Χρησιμοποιήστε τη μεταβλητή `created_at`. Χρησιμοποιήστε το φίλτρο `date` για να μορφοποιήσετε τη χρονοσήμανση, για παράδειγμα με το `{{ order.created_at \| date: "%B %e, %Y" }}`.
`gateways`	`unique_gateways` ή `transactions.<each>.gateway`
`order_currency`	`currency`
`processed_at`	Χρησιμοποιήστε τη μεταβλητή `created_at`. Περιέχει την τιμή του `order.processed_at` από το GraphQL API και αντιστοιχεί στον πραγματικό χρόνο επεξεργασίας της παραγγελίας και όχι στον χρόνο εισαγωγής της παραγγελίας στο Shopify. Είναι το ίδιο με το `order.processed_at` από την παλιά εφαρμογή Order Printer. Μπορείτε να χρησιμοποιήσετε το φίλτρο `date` για να μορφοποιήσετε τη χρονοσήμανση, για παράδειγμα με το `{{ order.created_at \| date: "%B %e, %Y" }}`.
`payment_transactions`	Φιλτράρετε το `order.transactions` για την κατάσταση `kind` στη σύνταξη Liquid με το where ή με βρόχο και μια εντολή `if`. Δείτε τα παρακάτω παραδείγματα. `{% assign sale_transactions = order.transactions \| where: "kind", "sale" %} {% assign capture_transactions = order.transactions \| where: "kind", "capture" %} {% for transaction in transactions %} {% if transaction.kind == "sale" or transaction.kind == "capture" %} Transaction ID: {{ transaction.id }} Kind: {{ transaction.kind }} Amount: {{ transaction.amount \| money }} {% endif %} {% endfor %}` `{% assign sale_transactions = order.transactions \| where: "kind", "sale" %} {% assign capture_transactions = order.transactions \| where: "kind", "capture" %} {% assign payment_transactions = sale_transactions \| concat: capture_transactions %}`
`refund_transactions`	Φιλτράρετε το `order.transactions` για την κατάσταση `kind` στη σύνταξη Liquid με τη συνάρτηση where ή με βρόχο και μια δήλωση `if` εσωτερικά, όπως στο ακόλουθο παράδειγμα. `{% assign refund_transactions = order.transactions \| where: "kind", "refund" %}`
`shipping_line`	`shipping_methods \| first`
`shipping_lines`	`shipping_methods`
`show_line_item_taxes`	`tax_lines.size > 0`. Μπορείτε να το ορίσετε ως μεταβλητή στην αρχή του προτύπου και να αναφερθείτε σε αυτό πολλές φορές, όπως στο ακόλουθο παράδειγμα. `{% if tax_lines.size > 0 %} {% assign show_line_item_taxes = true %} {% else %} {% assign show_line_item_taxes = false %} {% endif %}`
`total_tax`	`tax_price`
`total_paid`	`net_payment`

Μεταβλητές LineItem

Μεταβλητή LineItem
Μεταβλητή στην παλαιού τύπου εφαρμογή Order Printer	Μεταβλητή στη νέα εφαρμογή Shopify Order Printer
`fulfillable_quantity`	`quantity - successfully_fulfilled_quantity`
`fulfilled`	`quantity == successfully_fulfilled_quantity`
`name`	`title`
`product_title`	`product.title`
`unit_discount`	`quantity ? line_level_total_discount / quantity : 0`
`variant_title`	`variant.title`
`weight`	`grams`

Μεταβλητές διεκπεραίωσης

μεταβλητή διεκπεραίωσης
Μεταβλητή στην παλαιού τύπου εφαρμογή Order Printer	Μεταβλητή στη νέα εφαρμογή Shopify Order Printer
`date`	`created_at`

Μεταβλητές Shop

Μεταβλητή Shop
Μεταβλητή στην παλαιού τύπου εφαρμογή Order Printer	Μεταβλητή στη νέα εφαρμογή Shopify Order Printer
`owner`	`account_owner.name`
`address`	`shop.address.address1`
`address2`	`shop.address.address2`
`city`	`shop.address.city`
`country`	`shop.address.country`
`country_code`	`shop.address.country_code`
`province`	`shop.address.province`
`province_code`	`shop.address.province_code`
`zip`	`shop.address.zip`

Μεταβλητές διεύθυνσης

Μεταβλητή διεύθυνσης
Μεταβλητή στην παλαιού τύπου εφαρμογή Order Printer	Μεταβλητή στη νέα εφαρμογή Shopify Order Printer
`latitude`	Αν η μεταβλητή `address` αντλήθηκε από το χαρακτηριστικό `location`, τότε το γεωγραφικό πλάτος και μήκος είναι διαθέσιμα στο ίδιο το αντικείμενο `location`.
`longitude`	Αν η μεταβλητή `address` αντλήθηκε από το χαρακτηριστικό `location`, τότε το γεωγραφικό πλάτος και μήκος είναι διαθέσιμα στο ίδιο το αντικείμενο `location`.

Μεταβλητές επιστροφής χρημάτων

Μεταβλητή επιστροφής χρημάτων
Μεταβλητή στην παλαιού τύπου εφαρμογή Order Printer	Μεταβλητή στη νέα εφαρμογή Shopify Order Printer
`date`	Χρησιμοποιήστε τη μεταβλητή `created_at`. Χρησιμοποιήστε το φίλτρο `date` για να μορφοποιήσετε τη χρονοσήμανση, για παράδειγμα με το `{{ order.created_at \| date: "%B %e, %Y" }}`.

Μεταβλητές ShippingLine

Μεταβλητή ShippingLine
Μεταβλητή στην παλαιού τύπου εφαρμογή Order Printer	Μεταβλητή στη νέα εφαρμογή Shopify Order Printer
`current_price`	`price`
`price`	`original_price`

Μεταβλητές συναλλαγής

Οι ακόλουθες μεταβλητές συναλλαγής καταργήθηκαν και δεν είναι δυνατή η αντικατάστασή τους στην εφαρμογή Shopify Order Printer:

authorization
message
test

Μεταβλητές παραλλαγής

μεταβλητή παραλλαγής
Μεταβλητή στην παλαιού τύπου εφαρμογή Order Printer	Μεταβλητή στη νέα εφαρμογή Shopify Order Printer
`grams`	`weight`

Μεταβλητές μετα-πεδίου

Για να αποκτήσετε πρόσβαση σε ένα μετα-πεδίο, πρέπει να καθορίσετε το Namespace του μετα-πεδίου και δεν χρειάζεται να προσθέσετε το .value στη μεταβλητή. Μάθετε περισσότερα για τους ορισμούς μετα-πεδίων.

Για παράδειγμα, αντί για τη μεταβλητή product.metafields.manufacturerid.value, χρησιμοποιήστε τη μεταβλητή product.metafields.custom.manufacturerid.

Για να προσδιορίσετε τις τιμές Namespace για κάθε μετα-πεδίο, ανατρέξτε στη σελίδα Προσαρμοσμένα δεδομένα στον Διαχειριστή Shopify. Οι ορισμοί μετα-πεδίων ομαδοποιούνται ανάλογα με τα αντικείμενα στα οποία αναφέρονται, όπως προϊόντα, παραλλαγές ή παραγγελίες.

Αντιστοίχιση φίλτρων

Αντιστοίχιση φίλτρων
Όνομα φίλτρου στην παλιά εφαρμογή Order Printer	Όνομα φίλτρου στη νέα εφαρμογή Shopify Order Printer
`files_url`	`file_url`
`payment_method` και `payment_methods`	Χρησιμοποιήστε το πεδίο transaction.gateway_display_name στις συναλλαγές παραγγελιών. Οι μέθοδοι πληρωμής δεν κατηγοριοποιούνται πλέον σε συγκεκριμένους τύπους, όπως `{credit card, debit card, bank transfer}`. Η παλιά εφαρμογή Order Printer αντιστοίχιζε μόνο ένα μικρό υποσύνολο των πυλών πληρωμών που λειτουργούν επί του παρόντος σε αυτές τις κατηγορίες. Οι πάροχοι πυλών πληρωμών διαχειρίζονται από την πλευρά τους τους τύπους μεθόδων πληρωμής που χρησιμοποιούν οι πελάτες.