פתרון בעיות עבור תבניות 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.

באפשרותך גם ליצור כינויים (aliases) משלך עבור התבנית שלך. לדוגמה, ניתן להשתמש בתחביר 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.kind }} סכום: {{ 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`

משתני עסקה

משתני העסקה הבאים הוסרו ולא ניתן להחליפם באפליקציה Order Printer של Shopify:

authorization
message
test

משתני גרסה

משתנה גרסה
משתנה באפליקציית המורשת של Order Printer	משתנה באפליקציית Shopify Order Printer החדשה
`grams`	`weight`

משתני מטא שדה

כדי לגשת למטא שדה, יש לציין את ה-Namespace שלו, ואין צורך להוסיף את .value למשתנה. למידע נוסף על הגדרות מטא שדה.

לדוגמה, במקום המשתנה product.metafields.manufacturerid.value, יש להשתמש במשתנה product.metafields.custom.manufacturerid.

כדי לזהות את ערכי ה-Namespace עבור כל מטא שדה, ניתן לעיין בעמוד נתונים מותאמים אישית במנהל של Shopify. הגדרות מטא שדה מקובצות לפי האובייקטים שהן מתייחסות אליהם, כגון מוצרים, גרסאות או הזמנות.

מיפוי מסננים

מיפוי מסננים
שם המסנן באפליקציית המורשת Order Printer	שם המסנן באפליקציה החדשה Order Printer של Shopify
`files_url`	`file_url`
`payment_method` ו-`payment_methods`	יש להשתמש בשדה transaction.gateway_display_name בעסקאות הזמנה. אמצעי תשלום כבר אינם מסווגים לסוגים ספציפיים, כגון `{credit card, debit card, bank transfer}`. אפליקציית המורשת Order Printer מיפתה רק תת-קבוצה קטנה של שערי תשלום פעילים כיום לקטגוריות אלו. ספקי שערי תשלום מנהלים בצד שלהם את סוגי אמצעי התשלום שבהם הלקוחות משתמשים.