Tài liệu tham khảo về biến Liquid và bộ lọc dành cho Shopify Order Printer

Trang này được in vào Jul 27, 2024. Để lấy phiên bản hiện tại, vui lòng truy cập https://help.shopify.com/vi/manual/orders/printing-orders/shopify-order-printer/liquid-variables-and-filters-reference.

Bạn có thể sử dụng Liquid để xây dựng mẫu tùy chỉnh của riêng mình bằng ứng dụng Order Printer của Shopify. Với Liquid, bạn có thể tạo và kết xuất các mẫu văn bản dựa trên dữ liệu riêng của từng đơn hàng.

Các tài liệu tham khảo về liquid có tại trang này là phần mở rộng của phiên bản Liquid nguồn mở và được dùng cho ứng dụng Order Printer của Shopify. Để kết xuất thông tin dựa trên các thuộc tính order và shop, bạn có thể sử dụng danh sách đối tượng, thẻ và bộ lọc trong tài liệu tham khảo này để tùy chỉnh mẫu. Bạn cũng có thể sử dụng tài liệu về Admin GraphQL API để tìm hiểu chi tiết về các trường đối tượng.

Trên trang này

Sử dụng biến và thuộc tính

Trong mẫu Shopify Order Printer, các đối tượng dữ liệu cốt lõi là order và shop. Bạn có thể sử dụng order.variable_name để truy cập các thuộc tính đơn hàng.

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

  • line_items
  • tax_lines
  • fulfillments
  • transactions
  • discounts
  • 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.

Biến Liquid hiện có trong Shopify Order Printer

Hiện có các lớp sau. Thuộc tính sẽ được liệt kê theo thứ tự bảng chữ cái.

Đơn hàng

Hiện có các thuộc tính Order sau đây trong Shopify Order Printer:

  • attributes
  • b2b
  • billing_address
  • cancel_reason
  • cancel_reason_label
  • cancelled
  • cancelled_at
  • cart_level_discount_applications
  • checkout_id
  • checkout_payment_collection_url
  • company
  • company_location
  • confirmation_number
  • created_at. Thời gian xử lý đơn hàng. Giá trị này bằng order.processed_at trong GraphQL API. 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" }}.
  • customer
  • discounts. Đã ngừng sử dụng vì không áp dụng được cho tất cả các loại và thông tin chi tiết ưu đãi giảm giá. Thuộc tính order.discounts đã được thay bằng order.discount_applications.
  • discounts_amount. Đã ngừng sử dụng vì không áp dụng được cho tất cả các loại và thông tin chi tiết ưu đãi giảm giá. Thuộc tính order.discounts đã được thay bằng order.total_discounts.
  • discount_applications
  • discounts_savings. Đã ngừng sử dụng vì không áp dụng được cho tất cả các loại và thông tin chi tiết ưu đãi giảm giá. Thuộc tính order.discounts đã được thay bằng -.
  • email
  • fees
  • financial_status
  • financial_status_label
  • fulfilled_line_items
  • fulfillment_aborted
  • fulfillment_status
  • fulfillments
  • gateway
  • id
  • item_count
  • landing_site
  • landing_site_ref
  • line_items
  • line_items_subtotal_price
  • location
  • metafields
  • name
  • net_payment
  • note
  • order_name
  • order_number
  • order_status_url
  • payment
  • payment_details
  • po_number
  • refunds
  • requires_shipping
  • shipping_address
  • shipping_method
  • shipping_methods
  • shipping_price
  • shop
  • shop_name
  • subtotal_price
  • tags
  • tax_lines
  • tax_price
  • tip_line_items
  • total_discounts
  • total_duties
  • total_landed_cost_additional_fees
  • total_net_amount
  • total_outstanding
  • total_price
  • total_refunded_amount
  • total_tip
  • transactions
  • unacceptable_risks
  • unfulfilled_line_items
  • unique_gateways
  • user
  • void_transactions

Shop

Xem danh sách các thuộc tính Shop có sẵn trong Shopify Order Printer sau:

  • accepts_gift_cards
  • account_owner
  • allows_discounts
  • checkout
  • checkout_requires_confirmation_step
  • collections_count
  • contact_information
  • currency
  • customer_accounts_enabled
  • customer_accounts_optional
  • description
  • domain
  • email
  • email_accent_color
  • email_logo_url
  • email_logo_width
  • email_marketing
  • enabled_currencies
  • enabled_locales
  • enabled_payment_types
  • features
  • id
  • latitude
  • legal_notice
  • longitude
  • metafields
  • money_format
  • money_with_currency_format
  • name
  • password_message
  • permanent_domain
  • phone
  • policies
  • privacy_policy
  • products_count
  • refund_policy
  • secure_url
  • shipping_policy
  • subscription_policy
  • terms_of_sale
  • terms_of_service
  • types
  • url

LineItem

Xem danh sách các thuộc tính Line Item có sẵn trong Shopify Order Printer sau:

  • aggregated_update
  • applied_discounts. Đã ngừng sử dụng vì không phải tất cả các loại và thông tin chi tiết ưu đãi giảm giá đều hiển thị. Thuộc tính line_item.discounts đã được thay bằng line_item.discount_allocations.
  • current_quantity
  • discount_allocations
  • discounts. Đã ngừng sử dụng vì không phải tất cả các loại và thông tin chi tiết ưu đãi giảm giá đều hiển thị. Thuộc tính line_item.discounts đã được thay bằng line_item.discount_allocations.
  • final_line_price
  • final_price
  • fulfillment
  • fulfillment_service
  • gift_card
  • grams
  • groups
  • id
  • image
  • index
  • item_updates
  • json_filter
  • key
  • line_level_discount_allocations
  • line_level_total_discount
  • line_price. Đã ngừng sử dụng vì không bao gồm ưu đãi giảm giá thuộc mã giảm giá và ưu đãi giảm giá tự động. Thuộc tính line_item.line_price đã được thay bằng line_item.final_line_price.
  • message
  • options_with_values
  • original_line_price
  • original_price
  • price. Đã ngừng sử dụng vì không bao gồm ưu đãi giảm giá thuộc mã giảm giá và ưu đãi giảm giá tự động. Thuộc tính line_item.price đã được thay bằng line_item.final_price.
  • product
  • product_id
  • properties
  • quantity
  • refunded_quantity
  • requires_shipping
  • selling_plan_allocation
  • sku
  • successfully_fulfilled_quantity
  • tax_lines
  • taxable
  • title
  • total_discount. Đã ngừng sử dụng vì không bao gồm ưu đãi giảm giá thuộc mã giảm giá và ưu đãi giảm giá tự động. Thuộc tính line_item.total_discount đã được thay bằng line_item.line_level_total_discount.
  • unit_price
  • unit_price_measurement
  • url
  • url_to_remove
  • variant
  • variant_id
  • vendor

Thực hiện đơn hàng

Xem danh sách các thuộc tính Thực hiện có sẵn trong Shopify Order Printer sau:

  • created_at. Sử dụng bộ lọc date để định dạng dấu thời gian, ví dụ như {{ fulfillment.created_at | date: "%B %e, %Y" }}.
  • estimated_delivery_at
  • fulfillment_line_items
  • item_count
  • line_items
  • requires_shipping
  • tracking_company
  • tracking_number
  • tracking_numbers
  • tracking_url
  • tracking_urls
  • updated_at

Địa chỉ

Xem danh sách các thuộc tính Address có sẵn trong Shopify Order Printer sau:

  • address1
  • address2
  • city
  • company
  • country
  • country_code
  • country_upper
  • errors
  • first_name
  • id
  • last_name
  • name
  • phone
  • province
  • province_code
  • street
  • summary
  • translated_country_name
  • translated_province_name
  • url
  • zip

Khách hàng

Xem danh sách các thuộc tính Customer có sẵn trong Shopify Order Printer sau:

  • accepts_marketing
  • account_activation_url
  • addresses
  • addresses_count
  • b2b?
  • default_address
  • email
  • first_name
  • has_account
  • id
  • last_name
  • last_order
  • metafields
  • name
  • new_address
  • orders
  • orders_count
  • payment_methods
  • phone
  • reset_password_url
  • subscribe_url
  • tags
  • tax_exempt
  • total_spent

DiscountApplication

Xem danh sách các thuộc tính DiscountApplication có sẵn trong Shopify Order Printer sau:

  • target_selection
  • target_type
  • title
  • total_allocated_amount
  • type
  • value_type
  • value

Ưu đãi giảm giá in

Có thể áp dụng ưu đãi giảm giá cho toàn bộ đơn hàng hoặc cho các mục hàng cụ thể:

  • Giảm giá theo đơn hàng: Ưu đãi giảm giá này áp dụng cho toàn bộ đơn hàng. Bạn có thể trình bày riêng các ưu đãi giảm giá này ở cuối khi in hóa đơn cho đơn hàng.
  • Giảm giá theo mục hàng: Ưu đãi giảm giá này áp dụng cho từng mặt hàng. Bạn có thể đề cập đến những ưu đãi giảm giá này khi in chi tiết từng mặt hàng trong phần mục hàng.

Bạn có thể truy cập thông tin ưu đãi giảm giá bằng những biến sau:

  • Truy cập tất cả ưu đãi giảm giá áp dụng cho đơn hàng hoặc mục hàng bất kỳ trong đơn hàng bằng giá trị order.total_discounts và bộ sưu tập order.discount_applications.

  • Truy cập ưu đãi giảm giá cho mục hàng bằng giá trị line_item.line_level_total_discount hoặc bộ sưu tập line_item.line_level_discount_allocations.

    • Truy cập giá của mục hàng trước khi áp dụng ưu đãi giảm giá bằng giá trị line_item.original_price.
    • Truy cập giá của mục hàng sau khi áp dụng tất cả ưu đãi giảm giá theo mục hàng liên quan bằng giá trị line_item.final_price.
    • Các giá trị line_item.original_line_price và line_item.final_line_price bằng các giá trị line_item.original_price và line_item.final_price nhân với line_item.quantity.

  • Truy cập ưu đãi giảm giá theo đơn hàng bằng bộ sưu tập order.cart_level_discount_applications.

Ví dụ về khối mã dành cho ưu đãi giảm giá in theo mục hàng:

{% for line_item in order.line_items %}
  <tr>
    <td>{{ line_item.quantity }}</td>
    <td>{{ line_item.title }}
    {% if line_item.line_level_discount_allocations.size > 0 %}
      <span class="subduedText">
        {% for discount_allocation in line_item.line_level_discount_allocations %}
        <br>{{ discount_allocation.discount_application.title }} (-{{ discount_allocation.amount | money }})
        {% endfor %}
      </span>
    {% endif %}
    </td>
    <td style="text-align: right;">
      {% if line_item.original_price != line_item.final_price %}
        <span class="subduedText"><s>{{ line_item.original_price | money }}</s></span>
      {% endif %}
      {{ line_item.final_price | money }}
    </td>
  </tr>
{% endfor %}

Ví dụ về khối mã dành cho ưu đãi giảm giá in theo đơn hàng:

{% for discount_application in order.cart_level_discount_applications %}
<tr>
  <td colspan="2" style="text-align: right;">{% if discount_application.title %}<span class="subduedText">{{ discount_application.title }}</span>{% endif %}</td>
  <td style="text-align: right;">-{{ discount_application.total_allocated_amount | money }}</td>
</tr>
{% endfor %}

DiscountAllocation

Xem danh sách các thuộc tính DiscountAllocation có sẵn trong Shopify Order Printer sau:

  • amount
  • discount_application

Giảm giá

Xem danh sách các thuộc tính Discount có sẵn trong Shopify Order Printer sau:

  • amount
  • code
  • free_shipping_discount
  • id
  • savings
  • title
  • total_amount
  • total_savings

Sản phẩm

Xem danh sách các thuộc tính Product có sẵn trong Shopify Order Printer sau:

  • as_json
  • available
  • collections
  • compare_at_price
  • compare_at_price_max
  • compare_at_price_min
  • compare_at_price_varies
  • content
  • created_at
  • description
  • featured_image
  • featured_media
  • first_available_variant
  • gift_card?
  • handle
  • has_only_default_variant
  • id
  • images
  • json_filter
  • media
  • metafields
  • object_type
  • options
  • options_by_name
  • options_with_values
  • price
  • price_max
  • price_min
  • price_varies
  • published_at
  • requires_selling_plan
  • selected_or_first_available_selling_plan_allocation
  • selected_or_first_available_variant
  • selected_selling_plan
  • selected_selling_plan_allocation
  • selected_variant
  • selling_plan_groups
  • tags
  • template_suffix
  • title
  • type
  • url
  • variants
  • vendor

Mẫu mã

Xem danh sách các thuộc tính Variant có sẵn trong Shopify Order Printer sau:

  • as_json
  • available
  • barcode
  • compare_at_price
  • featured_image
  • featured_media
  • id
  • image
  • incoming
  • inventory_management
  • inventory_policy
  • inventory_quantity
  • json_filter
  • metafields
  • next_incoming_date
  • option1
  • option2
  • option3
  • options
  • price
  • product
  • requires_selling_plan
  • requires_shipping
  • selected_selling_plan_allocation
  • selling_plan_allocations
  • sku
  • store_availabilities
  • taxable
  • title
  • unit_price
  • unit_price_measurement
  • url
  • weight
  • weight_in_unit
  • weight_unit

Hoàn tiền

Xem danh sách các thuộc tính Refund có sẵn trong Shopify Order Printer sau:

  • amount
  • created_at
  • id
  • note
  • refund_line_items
  • restock
  • transactions

ShippingLine

Xem danh sách các thuộc tính Shipping Line có sẵn trong Shopify Order Printer sau:

  • handle
  • id
  • original_price
  • tax_lines
  • title

TaxLine

Xem danh sách các thuộc tính Tax Line có sẵn trong Shopify Order Printer sau:

  • price
  • rate
  • rate_percentage
  • title

Transaction

Xem danh sách các thuộc tính Transaction có sẵn trong Shopify Order Printer sau:

  • amount
  • buyer_pending_payment_instructions
  • buyer_pending_payment_notice
  • created_at
  • gateway
  • gateway_display_name
  • id
  • kind
  • name
  • payment_details
  • receipt
  • show_buyer_pending_payment_instructions
  • status
  • status_label

Trường thông tin bổ sung

Trường thông tin bổ sung đính kèm đối tượng gốc. Để tìm hiểu về cách truy cập trường thông tin bổ sung trên một đối tượng cụ thể, tham khảo Truy cập trường thông tin bổ sung.

Các trường thông tin bổ sung hỗ trợ nhiều loại dữ liệu, xác định loại thông tin được lưu trữ trong trường thông tin bổ sung. Để truy cập trường thông tin bổ sung, đường dẫn truy cập trường thông tin bổ sung gồm hai lớp:

  • không gian tên - nhóm các trường thông tin bổ sung để ngăn xung đột,
  • khóa - tên trường thông tin bổ sung.

Nhờ vậy, bạn có thể truy cập đối tượng trường thông tin bổ sung với cú pháp sau: {{ resource.metafields.namespace.key }}.

Đặt tên: <object>.metafields.<namespace>.<key>. Ví dụ: order.metafields.shipping.express_delivery_status.

Loại:

  • String
  • Array - sử dụng [] để lập chỉ mục. Ví dụ: order.metafield.shipping.express_delivery_status[0]
  • Integer
  • Boolean
  • Date

Lưu ý rằng loại Metaobject không được hỗ trợ.

Các đối tượng hỗ trợ trường thông tin bổ sung:

  • Order
  • Customer
  • Product
  • Variant
  • Location

Bộ lọc Liquid có sẵn trong Shopify Order Printer

Sử dụng

Để áp dụng bộ lọc cho thông tin đầu ra, thêm bộ lọc và tham số bộ lọc bất kỳ trong dấu phân tách dấu ngoặc nhọn của đầu ra {{ }}, đứng trước là ký tự thanh dọc |. Trong ví dụ dưới đây, sản phẩm là đối tượng, tiêu đề là thuộc tính của đối tượng và upcase là bộ lọc được áp dụng:

{{ product.title | upcase }}

Nếu product.title có giá trị Health potion thì HEALTH POTION sẽ là đầu ra từ bộ lọc upcase.

Tham khảo mục Bộ lọc trong tài liệu tham khảo về Liquid của Chủ đề Shopify để biết chi tiết về cách sử dụng bộ lọc Liquid.

Bộ lọc được áp dụng trên đối tượng Địa chỉ

  • format_address

Để xem ví dụ về cách sử dụng, tham khảo tài liệu Liquid của Chủ đề Shopify cho format_address.

Bộ lọc được áp dụng trên văn bản/chuỗi bất kỳ

  • camelcase
  • camelize
  • encode_url_component
  • format_code
  • handle
  • highlight
  • pad_spaces
  • paragraphize
  • pluralize
  • url_escape
  • url_param_escape

Để xem ví dụ về cách sử dụng, tham khảo tài liệu Liquid của Chủ đề Shopify về bộ lọc chuỗi.

Bộ lọc được áp dụng trên số có ý nghĩa số tiền

  • money
  • money_with_currency
  • money_without_currency
  • money_without_trailing_zeros

Shopify Order Printer sử dụng tùy chọn định dạng đơn vị tiền tệ cho thông báo qua email được cấu hình trong trang quản trị Shopify để định dạng tiền tệ. Bạn có thể thay đổi định dạng đơn vị tiền tệ. Đặt các giá trị Email with currency và Email without currency trong trang quản trị Shopify để thay đổi định dạng bộ lọc tiền tệ trong Shopify Order Printer.

Để xem ví dụ về cách sử dụng, tham khảo tài liệu Liquid của Chủ đề Shopify cho bộ lọc tiền tệ.

Bộ lọc được áp dụng để chuyển đổi đối tượng thành json

  • json

Để xem ví dụ về cách sử dụng, tham khảo tài liệu Liquid của Chủ đề Shopify cho bộ lọc json.

Bộ lọc được áp dụng trên các số có trọng số

  • weight
  • weight_with_unit

Để xem ví dụ về cách sử dụng, tham khảo tài liệu Liquid của Chủ đề Shopify về trọng lượng có đơn vị.

Bộ lọc được áp dụng trên các thẻ

  • highlight_active_tag
  • link_to_add_tag
  • link_to_remove_tag
  • link_to_tag

Để xem ví dụ về cách sử dụng, tham khảo tài liệu Liquid của Chủ đề Shopify cho bộ lọc thẻ.

Bộ lọc được áp dụng trên URL

  • article_img_url
  • asset_img_url
  • asset_url
  • cdn_asset_url
  • collection_img_url
  • file_img_url
  • file_url
  • global_asset_url
  • image_url
  • img_tag
  • img_url
  • link_to
  • payment_icon_png_url
  • payment_type_img_url
  • payment_type_svg_tag
  • placeholder_svg_tag
  • product_img_url
  • script_tag
  • shopify_asset_url
  • stylesheet_tag

Để xem ví dụ về cách sử dụng, tham khảo tài liệu Liquid của Chủ đề Shopify về bộ lọc phương tiện và html.

Bộ lọc được áp dụng trên bộ sưu tập

  • link_to_type
  • link_to_vendor
  • sort_by
  • url_for_type
  • url_for_vendor
  • within

Để xem ví dụ về cách sử dụng, tham khảo tài liệu Liquid của Chủ đề Shopify cho bộ lọc bộ sưu tập.

Bạn đã sẵn sàng bán hàng với Shopify?

Dùng thử miễn phí