การโอนย้ายเทมเพลตของคุณจากแอป Order Printer ไปยัง Shopify Order Printer

หน้านี้พิมพ์ขึ้นเมื่อ Jul 26, 2024 หากต้องการเวอร์ชันปัจจุบัน โปรดไปที่ https://help.shopify.com/th/manual/orders/printing-orders/shopify-order-printer/migration

หากคุณมีเทมเพลตที่กำหนดเองในแอป Order Printer ดั้งเดิม คุณจะต้องย้ายเทมเพลตของคุณไปยังแอป Shopify Order Printer

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

เพื่อให้เทมเพลตของคุณทำงานในแอปใหม่ได้ คุณจะต้องแทนที่ตัวแปรเดิมด้วยตัวแปรใหม่ ตัวอย่างเช่น หากคุณใช้ตัวแปร date คุณจะต้องแทนที่ด้วยตัวแปร created_at

ในหน้านี้ คุณสามารถค้นหารายการตัวแปรที่คุณอาจต้องแทนที่ด้วยตัวแปรใหม่ในแอป Shopify Order Printer

ในหน้านี้

ข้อควรพิจารณาในการโอนย้ายเทมเพลตที่มีอยู่ของคุณ

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

โอนย้ายเทมเพลตที่มีอยู่ของคุณไปยังแอป Shopify Order Printer

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

ขั้นตอน:

  1. จากส่วนผู้ดูแล Shopify ให้คลิกการตั้งค่า > แอปและช่องทางการขาย
  2. คลิก Order Printer

  3. คลิก “เปิดแอป”

  4. คลิก "เทมเพลต"

  5. คลิกที่นำเข้า

  6. ในกล่องโต้ตอบ ให้คลิก นําเข้า

  7. ตรวจสอบว่าเทมเพลตของคุณใช้ตัวแปรดั้งเดิมใดๆ หรือไม่ แล้วแทนที่ด้วยตัวแปรใหม่

  8. ดูตัวอย่างเทมเพลตของคุณและตรวจสอบให้แน่ใจว่าเทมเพลตแสดงอย่างถูกต้อง

  9. ตัวเลือกเสริม: พิมพ์เอกสารเพื่อทดสอบ

การใช้ตัวแปรคำสั่งซื้อในแอป Shopify Order Printer

ตัวแปรคำสั่งซื้อจะถูกใช้แตกต่างกันในแอป 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 }} ในโค้ดของคุณ

ตัวแปรการแม็ป

แอป Shopify Order Printer ใช้ตัวแปรที่แตกต่างจากแอป Order Printer ดั้งเดิม หากเทมเพลตที่มีอยู่ของคุณใช้ตัวแปรใดๆ ที่แสดงอยู่ในส่วนนี้ คุณจะต้องแทนที่ตัวแปรเก่าด้วยตัวแปรใหม่

ตัวอย่างเช่น หากคุณใช้ตัวแปร date คุณจะต้องแทนที่ด้วยตัวแปร created_at

ตัวแปรคำสั่งซื้อ

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

พร้อมเริ่มต้นการขายด้วย Shopify แล้วหรือยัง

ทดลองใช้งานฟรี