Di chuyển từ ứng dụng Order Printer sang Shopify Order Printer

Nếu có bất kỳ mẫu tùy chỉnh nào trong ứng dụng Order Printer cũ, bạn cần di chuyển mẫu sang ứng dụng Order Printer của Shopify.

Để di chuyển mẫu, bạn có thể nhập các mẫu có sẵn vào ứng dụng Shopify Order Printer. Tuy nhiên, cách triển khai của ứng dụng Shopify Order Printer mới có một số khác biệt nhỏ so với ứng dụng Order Printer cũ. Điều này nghĩa là ban đầu, có thể một số mẫu bạn hiện có sẽ không hoạt động và bạn cần thực hiện một số điều chỉnh đối với mã của mẫu.

Để mẫu hoạt động được trong ứng dụng mới, bạn cần thay thế các biến cũ bằng các biến mới. Ví dụ: Nếu sử dụng biến date thì bạn cần thay biến này bằng biến created_at.

Trang này có danh sách các biến mà có thể bạn cần thay thế bằng biến mới trong ứng dụng Order Printer của Shopify.

Những lưu ý khi di chuyển mẫu hiện có

Trước khi di chuyển các mẫu hiện có sang ứng dụng Order Printer của Shopify, bạn cần lưu ý những điều sau:

• Để di chuyển mẫu hiện có, bạn cần thành thạo với HTML, CSS và Liquid. Bộ phận hỗ trợ chủ đề Shopify có thể giúp thực hiện điều chỉnh nhỏ trong phạm vi Chính sách thiết kế của Shopify.
• Nghiên cứu tài liệu tham khảo về biến Liquid và bộ lọc dành cho Shopify Order Printer để biết tất cả các tùy chỉnh mẫu được hỗ trợ.
• Nếu mẫu hiện có sử dụng CSS tùy chỉnh thì bạn cần chuyển và điều chỉnh mã trong ứng dụng mới theo cách thủ công.
• Để truy cập biến đơn hàng trong ứng dụng Order Printer của Shopify, bạn cần thêm tiền tố đơn hàng.
• Khi nhập các mẫu có sẵn, bạn sẽ không nhập được trường thông tin bổ sung. Bạn có thể cần di chuyển thủ công các mẫu có chứa trường thông tin bổ sung.

Di chuyển mẫu hiện có sang ứng dụng Order Printer của Shopify

Nếu có mẫu có sẵn từ ứng dụng Order Printer cũ, bạn có thể nhập những mẫu này vào ứng dụng Shopify Order Printer. Bạn không thể nhập các mẫu cụ thể mà chỉ có thể nhập tất cả các mẫu cùng một lúc.

Bước:

1. Trên trang quản trị Shopify, nhấp vào Cài đặt > Ứng dụng và kênh bán hàng.
2. Nhấp vào Order Printer.

3. Nhấp vào Mở ứng dụng.

4. Nhấp vào Mẫu.

5. Nhấp vào Import (Nhập).

6. Trong hộp thoại, nhấp vào Import (Nhập).

7. Kiểm tra lại xem các mẫu của bạn có sử dụng bất kỳ biến cũ nào không, sau đó thay thế bằng các biến mới.

8. Xem trước mẫu và đảm bảo rằng mẫu hiển thị đúng cách.

9. Không bắt buộc: In tài liệu thử nghiệm.

Sử dụng biến đơn hàng trong ứng dụng Order Printer của Shopify

Biến đơn hàng được sử dụng theo các cách khác nhau trong ứng dụng Order Printer của Shopify. Để truy cập biến đơn hàng, bạn cần thêm tiền tố order.. Ví dụ: Để truy cập biến billing_address, bạn cần sử dụng order.billing_address.

Bạn có thể truy cập các biến đơn hàng thường dùng sau đây mà không cần tiền tố order.:

• line_items
• tax_lines
• fulfillments
• transactions
• refunds
• shipping_methods
• customer

Ví dụ: Nếu muốn truy cập biến mục hàng, bạn có thể sử dụng line_items hoặc order.line_items.

Bạn cũng có thể tạo bí danh riêng cho mẫu. Ví dụ: Bạn có thể sử dụng cú pháp Liquid {% assign fulfillments_count = order.fulfillments | size %}, sau đó tham chiếu cú pháp này bằng {{ fulfillments_count }} trong mã.

Ánh xạ biến

Ứng dụng Order Printer của Shopify sử dụng các biến khác với ứng dụng Order Printer cũ. Nếu mẫu hiện có sử dụng bất kỳ biến nào được liệt kê trong mục này thì bạn cần thay thế các biến cũ bằng biến mới.

Ví dụ: Nếu sử dụng biến date thì bạn cần thay biến này bằng biến created_at.

Biến đơn hàng

Biến đơn hàng

Biến trong ứng dụng Order Printer cũ	Biến trong ứng dụng Shopify Order Printer mới
line_items	Mục hàng đã hoàn tiền không có trong biến line_items. Xem chi tiết dưới đây: Bạn có thể truy cập mục hàng đã hoàn tiền bằng biến refunds.<each>.refund_line_items . Xem ví dụ sau. {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %} Bạn có thể đưa các mục hàng đã hoàn tiền vào bộ sưu tập line_items nếu muốn. Xem ví dụ sau. {% 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 %} Bạn cần đảm bảo đã thêm bộ lọc | uniq để tránh nhân bản các mục hàng đã hoàn tiền. Mục hàng tiền boa không có trong biến line_items . Xem chi tiết dưới đây: Bạn có thể truy cập mục hàng tiền boa bằng biến tip_line_items . Bạn có thể đưa tip_line_items vào bộ sưu tập line_items nếu muốn. Xem ví dụ sau. {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %} Để mô phỏng bộ sưu tập line_items của Order Printer cũ, bạn có thể sử dụng mã ví dụ như sau. {% 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	Sử dụng thông tin thanh toán dựa trên từng giao dịch từ đơn hàng có biến transactions.<each>.payment_details .
current_shipping_price	shipping_price
date	Sử dụng biến created_at. Sử dụng bộ lọc date để định dạng dấu thời gian, ví dụ như {{ order.created_at | date: "%B %e, %Y" }}.
cổng	unique_gateways hoặc transactions.<each>.gateway
order_currency	đơn vị tiền tệ
processed_at	Sử dụng biến created_at. Biến này có giá trị là order.processed_at trong GraphQL API và mang ý nghĩa là thời gian thực tế xử lý đơn hàng, không phải thời gian nhập đơn hàng vào Shopify. Biến này giống với order.processed_at trong ứng dụng Order Printer cũ. Bạn có thể sử dụng bộ lọc date để định dạng dấu thời gian, ví dụ như {{ order.created_at | date: "%B %e, %Y" }}.
payment_transactions	Lọc qua order.transactions để tìm trạng thái kind trong cú pháp Liquid bằng where hoặc bằng vòng lặp và if bên trong. Xem ví dụ sau. {% 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 giao dịch: {{ transaction.id }} Loại: {{ transaction.kind }} Số tiền: {{ 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	Lọc qua order.transactions để tìm trạng thái kind trong cú pháp Liquid bằng where hoặc bằng vòng lặp và if bên trong như trong ví dụ sau. {% 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. Bạn có thể xác định đây là một biến ở đầu mẫu và dẫn chiếu nhiều lần, như trong ví dụ sau. {% 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

Biến LineItem

Biến LineItem

Biến trong ứng dụng Order Printer cũ	Biến trong ứng dụng Shopify Order Printer mới
fulfillable_quantity	quantity - successfully_fulfilled_quantity
đã thực hiện	số lượng == successfully_fulfilled_quantity
tên	tiêu đề
product_title	product.title
unit_discount	quantity ? line_level_total_discount / quantity : 0
variant_title	variant.title
weight	gam

Biến quá trình thực hiện

biến quá trình thực hiện

Biến trong ứng dụng Order Printer cũ	Biến trong ứng dụng Shopify Order Printer mới
date	created_at

Biến cửa hàng

Biến shop

Biến trong ứng dụng Order Printer cũ	Biến trong ứng dụng Shopify Order Printer mới
chủ sở hữu	account_owner.name
địa chỉ	shop.address.address1
address2	shop.address.address2
city	shop.address.city
quốc gia	shop.address.country
country_code	shop.address.country_code
province	shop.address.province
province_code	shop.address.province_code
ZIP	shop.address.zip

Biến địa chỉ

Biến địa chỉ

Biến trong ứng dụng Order Printer cũ	Biến trong ứng dụng Shopify Order Printer mới
vĩ độ	Nếu biến address được dẫn chiếu từ thuộc tính location thì vĩ độ và kinh độ sẽ có sẵn trên chính đối tượng location.
kinh độ	Nếu biến address được dẫn chiếu từ thuộc tính location thì vĩ độ và kinh độ sẽ có sẵn trên chính đối tượng location.

Biến tiền hoàn lại

Biến tiền hoàn lại

Biến trong ứng dụng Order Printer cũ	Biến trong ứng dụng Shopify Order Printer mới
date	Sử dụng biến created_at. Sử dụng bộ lọc date để định dạng dấu thời gian, ví dụ như {{ order.created_at | date: "%B %e, %Y" }}.

Biến ShippingLine

Biến ShippingLine

Biến trong ứng dụng Order Printer cũ	Biến trong ứng dụng Shopify Order Printer mới
current_price	giá
giá	original_price

Biến giao dịch

Các biến giao dịch sau đã bị gỡ bỏ và không thể thay thế trong ứng dụng Order Printer của Shopify:

• authorization
• message
• test

Biến mẫu mã

biến mẫu mã

Biến trong ứng dụng Order Printer cũ	Biến trong ứng dụng Shopify Order Printer mới
gam	weight

Biến trường thông tin bổ sung

Để truy cập trường thông tin bổ sung, bạn cần chỉ định Không gian tên của trường thông tin bổ sung và không cần thêm .value vào biến. Tìm hiểu thêm về định nghĩa trường thông tin bổ sung.

Ví dụ: Thay vì biến product.metafields.manufacturerid.value , sử dụng biến product.metafields.custom.manufacturerid.

Để xác định giá trị Không gian tên cho mỗi trường thông tin bổ sung, tham khảo trang Dữ liệu tùy chỉnh trên trang quản trị Shopify. Định nghĩa trường thông tin bổ sung được phân nhóm theo đối tượng các trường này dẫn chiếu đến, ví dụ như sản phẩm, mẫu mã hoặc đơn hàng.

Ánh xạ bộ lọc

Ánh xạ bộ lọc

Lọc tên trong ứng dụng Order Printer cũ	Lọc tên trong ứng dụng Shopify Order Printer mới
files_url	file_url
payment_method và payment_methods	Sử dụng trường transaction.gateway_display_name đối với giao dịch đơn hàng. Phương thức thanh toán không còn được sắp xếp thành các loại cụ thể, ví dụ như {thẻ tín dụng, thẻ ghi nợ, chuyển khoản}. Ứng dụng Order Printer cũ chỉ ánh xạ một tập hợp con nhỏ các cổng thanh toán hiện đang hoạt động với những danh mục này. Nhà cung cấp cổng thanh toán quản lý các loại phương thức thanh toán mà khách hàng sử dụng từ phía họ.