การโอนย้ายข้อมูลจากแอป Order Printer ไปยัง Shopify Order Printer

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

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

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

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

ในหน้านี้

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

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

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

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

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

ขั้นตอนมีดังนี้

ในส่วนผู้ดูแล Shopify ของคุณ ให้ไปที่การตั้งค่า > แอปและช่องทางการขาย
คลิก Order Printer
คลิก “เปิดแอป”
คลิก "เทมเพลต"
คลิกที่นำเข้า
ในกล่องโต้ตอบ ให้คลิก นําเข้า
ตรวจสอบว่าเทมเพลตของคุณใช้ตัวแปรดั้งเดิมใดๆ หรือไม่ แล้วแทนที่ด้วยตัวแปรใหม่
ดูตัวอย่างเทมเพลตของคุณและตรวจสอบให้แน่ใจว่าเทมเพลตแสดงอย่างถูกต้อง
ตัวเลือกเสริม: พิมพ์เอกสารเพื่อทดสอบ

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