การแก้ไขปัญหาเกี่ยวกับเทมเพลตของ Order Printer ที่นำเข้าไว้

เมื่อคุณ โอนย้ายเทมเพลต จากแอป Order Printer ดั้งเดิมไปยังแอป Shopify Order Printer ใหม่ ตัวแปร Liquid ของคุณจะได้รับการอัปเดตเพื่อให้แน่ใจว่าสามารถใช้งานร่วมกับแอปใหม่ได้ ในบางเคสที่พบไม่บ่อย คุณอาจจำเป็นต้องแก้ไขปัญหาของเทมเพลตที่นำเข้าไว้

หากเทมเพลตที่คุณนำเข้าไว้นั้นไม่สามารถพิมพ์ได้อย่างถูกต้อง คุณอาจต้องแก้ไขโค้ดเทมเพลตด้วยตนเองในแอป Shopify Order Printer ใหม่ โปรดตรวจสอบสาเหตุที่พบบ่อยที่สุดต่อไปนี้ ซึ่งอาจทำให้ไม่สามารถนำเข้าเทมเพลตได้อย่างถูกต้อง

• เทมเพลตที่รวม CSS แบบกำหนดเอง
• เทมเพลตที่ประกอบด้วยเมตาฟิลด์
• ตัวแปร Liquid อาจอัปเดตไม่ถูกต้อง

ในหน้านี้ คุณสามารถดูข้อมูลโดยละเอียดเกี่ยวกับวิธีแก้ไขปัญหาที่อาจเกิดขึ้นได้เมื่อทำการนำเข้าเทมเพลตที่กำหนดเองของคุณไปยังแอป Shopify Order Printer ใหม่

การอัปเดตการปรับแต่งการออกแบบ CSS ทั่วไป

หากเทมเพลตที่คุณกำลังถ่ายโอนมี CSS แบบกำหนดเอง คุณอาจจำเป็นต้องอัปเดตโค้ด CSS ในเทมเพลตของคุณด้วยตนเองเพื่อให้สามารถองค์ประกอบการออกแบบ เช่น รูปภาพ แบบอักษรที่กำหนดเอง โลโก้ หรือบาร์โค้ดมีการแสดงอย่างถูกต้อง

หมายเหตุ

ฝ่ายช่วยเหลือด้านธีมของ Shopify สามารถช่วยคุณในการปรับแต่งเล็กน้อยภายในขอบเขตของนโยบายการออกแบบของ Shopify หากต้องการการปรับแต่งที่ซับซ้อน โปรดพิจารณาจ้างนักออกแบบจากภายนอก

• เพิ่มโลโก้ของคุณไปยังเทมเพลต
• เพิ่มรูปภาพลงในเทมเพลต
• ทำให้ความกว้างตาราง 100%
• แสดงรูปภาพขนาดย่อของสินค้า
• เพิ่มรายละเอียดคำสั่งซื้อ
• เพิ่มบาร์โค้ดลงในเทมเพลต
• เพิ่มคิวอาร์โค้ดลงในเทมเพลต
• การใช้แบบอักษรของ Google ในเทมเพลต
• การเพิ่มขนาดแบบอักษร

การอัปเดตตัวแปรเมตาฟิลด์

หากต้องการเข้าถึงเมตาฟิลด์ คุณต้องระบุเนมสเปซของเมตาฟิลด์ โดยที่คุณไม่ต้องเพิ่ม .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 %} หากต้องการเลียนแบบคอลเลกชัน Order Printer line_items ดั้งเดิมคุณสามารถใช้รหัสตัวอย่างต่อไปนี้ได้ {% 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
วันที่	ใช้ created_at ตัวแปร ใช้ตัวกรอง วันที่ เพื่อจัดรูปแบบการประทับเวลา ตัวอย่างเช่น {{ order.created_at | date: "%B %e, %Y" }}
ช่องทาง	unique_gateways หรือ transactions.<each>.gateway
order_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 สำหรับชนิดและสถานะรูปแบบภาษา 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" %} ID ธุรกรรม: {{ 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 สำหรับสถานะชนิดในไวยากรณ์ Liquid โดยมีตำแหน่ง หรือการวนซ้ำ และ ถ้า อยู่ภายใน ดังตัวอย่างต่อไปนี้ {% assign refund_transactions = order.transactions | where: "kind", "refund" %}
shipping_lines	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
จัดการแล้ว	ปริมาณ == successfully_fulfilled_quantity
ชื่อ	title
product_title	product.title
unit_discount	quantity ? line_level_total_discount / quantity : 0
variant_title	variant.title
weight	กรัม

ตัวแปรการจัดการคำสั่งซื้อ

ตัวแปรการจัดการคำสั่งซื้อ

ตัวแปรในแอป Order Printer ดั้งเดิม	ตัวแปรในแอป Shopify Order Printer ใหม่
วันที่	created_at

ตัวแปรร้านค้า

ตัวแปร Shop

ตัวแปรในแอป Order Printer ดั้งเดิม	ตัวแปรในแอป Shopify Order Printer ใหม่
เจ้าของ	account_owner.name
ที่อยู่	shop.address.address1
address2	shop.address.address2
city	shop.address.city
ประเทศ	shop.address.country
country_code	shop.address.country_code
province	shop.address.province
province_code	shop.address.province_code
รหัสไปรษณีย์	shop.address.zip

ตัวแปรที่อยู่

ตัวแปรที่อยู่

ตัวแปรในแอป Order Printer ดั้งเดิม	ตัวแปรในแอป Shopify Order Printer ใหม่
ละติจูด	หากตัวแปร address เป็นการอ้างอิงมาจากแอตทริบิวต์ location ละติจูดและลองจิจูดจะพร้อมใช้งานบนออบเจ็กต์ location
ลองจิจูด	หากตัวแปร address เป็นการอ้างอิงมาจากแอตทริบิวต์ location ละติจูดและลองจิจูดจะพร้อมใช้งานบนออบเจ็กต์ location

ตัวแปรการคืนเงิน

ตัวแปรการคืนเงิน

ตัวแปรในแอป Order Printer ดั้งเดิม	ตัวแปรในแอป Shopify Order Printer ใหม่
วันที่	ใช้ created_at ตัวแปร ใช้ตัวกรอง วันที่ เพื่อจัดรูปแบบการประทับเวลา ตัวอย่างเช่น {{ 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 ใหม่
กรัม	weight

ตัวแปรเมตาฟิลด์

หากต้องการเข้าถึงเมตาฟิลด์ คุณต้องระบุเนมสเปซของเมตาฟิลด์ โดยที่คุณไม่ต้องเพิ่ม .value ให้กับตัวแปร ดูข้อมูลเพิ่มเติมเกี่ยวกับคำจำกัดความเมตาฟิลด์

ตัวอย่างเช่น แทนที่จะใช้ตัวแปร product.metafields.manufacturerid.value ให้ใช้ตัวแปร product.metafields.custom.manufacturerid แทน

หากต้องการระบุค่าเนมสเปซของเมตาฟิลด์แต่ละรายการ ให้ดูที่หน้าข้อมูลแบบกำหนดเองในส่วนผู้ดูแล 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 ดั้งเดิมได้จับคู่เฉพาะส่วนย่อยของช่องทางการเงินที่ยังใช้งานอยู่ในหมวดหมู่เหล่านี้เท่านั้น ผู้ให้บริการช่องทางการชำระเงินจะจัดการประเภทของวิธีการชำระเงินที่ลูกค้าใช้อยู่