Rujukan penapis dan pemboleh ubah Liquid untuk Shopify Order Printer

Anda boleh menggunakan Liquid untuk membina templat tersuai anda sendiri menggunakan aplikasi Shopify Order Printer. Dengan Liquid, anda boleh mencipta templat teks dan memaparkannya berdasarkan data unik setiap pesanan.

Rujukan Liquid yang disenaraikan pada halaman ini ialah sambungan bagi versi sumber terbuka Liquid dan bertujuan untuk digunakan pada aplikasi Shopify Order Printer. Untuk memaparkan maklumat berdasarkan atribut order dan shop, anda boleh menggunakan senarai objek, tag dan penapis daripada rujukan ini untuk menyesuaikan templat anda. Anda juga boleh menggunakan dokumen Admin GraphQL API untuk mengetahui butiran tentang medan objek.

Menggunakan pemboleh ubah dan atribut

Dalam templat Shopify Order Printer, objek data teras ialah order dan shop. Anda boleh menggunakan order.variable_name untuk mengakses atribut pesanan.

Atribut pesanan yang biasa digunakan yang berikut boleh diakses tanpa awalan order.:

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

Contohnya, jika anda ingin mengakses pemboleh ubah item baris, anda boleh menggunakan line_items atau order.line_items.

Pemboleh ubah Liquid yang tersedia dalam Shopify Order Printer

Kelas berikut tersedia. Atribut disenaraikan mengikut susunan abjad.

Pesanan

Atribut Pesanan berikut tersedia dalam 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. Masa apabila pesanan telah diproses. Ini adalah sama dengan order.processed_at daripada API GraphQL. Gunakan penapis date untuk memformatkan cap masa, contohnya dengan {{ order.created_at | date: "%B %e, %Y" }}.
  • customer
  • discounts. Telah ditamatkan kerana bukan semua jenis dan butiran diskaun dirakam. Sifat order.discounts telah digantikan dengan order.discount_applications.
  • discounts_amount. Telah ditamatkan kerana bukan semua jenis dan butiran diskaun dirakam. Sifat order.discounts telah digantikan dengan order.total_discounts.
  • discount_applications
  • discounts_savings. Telah ditamatkan kerana bukan semua jenis dan butiran diskaun dirakam. Sifat order.discounts telah digantikan dengan -.
  • 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

Semak senarai atribut Shop berikut yang tersedia dalam Shopify Order Printer:

  • 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

Item Baris

Semak senarai atribut Item Baris berikut yang tersedia dalam Shopify Order Printer:

  • aggregated_update
  • applied_discounts. Ditamatkan penggunaannya kerana tidak semua jenis dan butiran diskaun tersedia. Sifat line_item.discounts telah digantikan dengan line_item.discount_allocations.
  • current_quantity
  • discount_allocations
  • discounts. Ditamatkan penggunaannya kerana tidak semua jenis dan butiran diskaun tersedia. Sifat line_item.discounts telah digantikan dengan 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. Ditamatkan penggunaannya kerana diskaun daripada diskaun automatik dan kod diskaun tidak disertakan. Sifat line_item.line_price telah digantikan dengan line_item.final_line_price.
  • message
  • options_with_values
  • original_line_price
  • original_price
  • price. Ditamatkan penggunaannya kerana diskaun daripada diskaun automatik dan kod diskaun tidak disertakan. Sifat line_item.price telah digantikan dengan 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. Ditamatkan penggunaannya kerana diskaun daripada diskaun automatik dan kod diskaun tidak disertakan. Sifat line_item.total_discount telah digantikan dengan line_item.line_level_total_discount.
  • unit_price
  • unit_price_measurement
  • url
  • url_to_remove
  • variant
  • variant_id
  • vendor

Pemenuhan

Semak senarai atribut Pemenuhan berikut yang tersedia dalam Shopify Order Printer:

  • created_at. Gunakan penapis date untuk memformatkan cap masa, sebagai contoh dengan {{ 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

Alamat

Semak senarai atribut Alamat berikut yang tersedia dalam Shopify Order Printer:

  • 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

Pelanggan

Semak senarai atribut Pelanggan berikut yang tersedia dalam Shopify Order Printer:

  • 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

Semak senarai atribut DiscountApplication berikut yang tersedia dalam Shopify Order Printer:

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

Mencetak diskaun

Diskaun boleh dikenakan pada seluruh pesanan atau pada item baris yang khusus:

  • Diskaun tahap pesanan: Diskaun ini dikenakan pada seluruh pesanan. Anda boleh memaparkan diskaun ini secara berasingan pada bahagian bawah apabila mencetak invois pesanan anda.
  • Diskaun tahap item baris: Diskaun ini dikenakan pada item individu. Anda boleh menyatakan diskaun ini apabila mencetak butiran item individu dalam bahagian item baris.

Anda boleh mengakses maklumat diskaun menggunakan pemboleh ubah yang berikut:

  • Akses semua diskaun yang dikenakan pada pesanan atau mana-mana item barisnya dengan nilai order.total_discounts dan koleksi order.discount_applications.
  • Akses diskaun item baris dengan nilai line_item.line_level_total_discount atau koleksi line_item.line_level_discount_allocations.
  • Akses harga item baris sebelum sebarang diskaun dikenakan dengan nilai line_item.original_price.
  • Akses harga hasil item baris selepas semua diskaun tahap item baris berkaitan dikenakan dengan nilai line_item.final_price.
  • Nilai line_item.original_line_price dan line_item.final_line_price adalah sama dengan nilai line_item.original_price dan line_item.final_price yang didarab dengan line_item.quantity.
  • Akses diskaun tahap pesanan dengan koleksi order.cart_level_discount_applications.

Contoh blok kod untuk mencetak diskaun tahap item baris:

{% 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 %}

Contoh blok kod untuk mencetak diskaun tahap pesanan:

{% 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

Semak senarai atribut DiscountAllocation berikut yang tersedia dalam Shopify Order Printer:

  • amount
  • discount_application

Diskaun

Semak senarai atribut Diskaun berikut yang tersedia dalam Shopify Order Printer:

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

Produk

Semak senarai atribut Produk berikut yang tersedia dalam Shopify Order Printer:

  • 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

Varian

Semak senarai atribut Varian berikut yang tersedia dalam Shopify Order Printer:

  • 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

Bayaran balik

Semak senarai atribut Bayaran balik berikut yang tersedia dalam Shopify Order Printer:

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

Baris pengiriman

Semak senarai atribut Baris pengiriman berikut yang tersedia dalam Shopify Order Printer:

  • handle
  • id
  • original_price
  • price. Ditamatkan kerana harga tidak merangkumi diskaun peringkat pesanan. Sifat shipping_line.price telah digantikan dengan shipping_line.price_with_discounts.
  • price_with_discounts
  • tax_lines
  • title

Baris cukai

Semak senarai atribut Baris cukai berikut yang tersedia dalam Shopify Order Printer:

  • price
  • rate
  • rate_percentage
  • title

Transaksi

Semak senarai atribut Transaksi berikut yang tersedia dalam Shopify Order Printer:

  • 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

Medan meta

Medan meta yang dilampirkan pada objek induk. Untuk mengetahui tentang cara mengakses medan meta pada objek tertentu, rujuk Akses medan meta.

Medan meta menyokong berbilang jenis data, yang menentukan jenis maklumat yang disimpan dalam medan meta. Untuk mengakses medan meta, laluan akses bagi medan meta terdiri daripada dua lapisan:

  • ruang nama - kumpulan medan meta untuk mengelakkan konflik,
  • kunci - nama medan meta.

Berdasarkan perkara ini, anda boleh mengakses objek medan meta dengan sintaks berikut: {{ resource.metafields.namespace.key }}.

Penamaan: <object>.metafields.<namespace>.<key>. Contohnya, order.metafields.shipping.express_delivery_status.

Jenis:

  • Rentetan
  • Tatasusunan - gunakan [ ] untuk indeks. Contohnya, order.metafield.shipping.express_delivery_status[0]
  • Integer
  • Boolean
  • Tarikh

Nota Jenis Metaobjek tidak disokong.

Objek yang menyokong medan meta:

  • Pesanan
  • Pelanggan
  • Produk
  • Varian
  • Lokasi

Penapis Liquid yang tersedia dalam Shopify Order Printer

Penggunaan

Untuk menggunakan penapis pada output, tambahkan penapis dan sebarang parameter penapis dalam pembatas kurungan ikal output {{ }}, didahului dengan aksara paip |. Dalam contoh di bawah, produk ialah objek, tajuk ialah sifatnya dan upcase ialah penapis yang digunakan:

{{ product.title | upcase }}

Jika product.title mempunyai nilai Health potion, HEALTH POTION akan menjadi output daripada penapis upcase.

Rujuk bahagian Penapis daripada rujukan Liquid Tema Shopify untuk butiran tentang cara menggunakan penapis Liquid.

Penapis untuk digunakan pada objek Alamat

  • format_address

Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk format_address.

Penapis untuk digunakan pada mana-mana teks / rentetan

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

Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk penapis rentetan.

Penapis untuk digunakan pada nombor yang mewakili wang

  • money
  • money_with_currency
  • money_without_currency
  • money_without_trailing_zeros

Shopify Order Printer menggunakan pilihan pemformatan mata wang pemberitahuan e-mel yang dikonfigurasikan dalam pentadbir Shopify untuk memformat wang. Anda boleh menukar pemformatan mata wang. Tetapkan nilai E-mel dengan mata wang dan E-mel tanpa mata wang dalam pentadbir Shopify untuk menukar pemformatan penapis wang dalam Shopify Order Printer.

Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk penapis wang.

Penapis untuk digunakan bagi menukar objek kepada json

  • json

Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk penapis json.

Penapis untuk digunakan pada nombor yang mewakili berat

  • weight
  • weight_with_unit

Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk berat berserta unit.

Penapis untuk digunakan pada tag

  • highlight_active_tag
  • link_to_add_tag
  • link_to_remove_tag
  • link_to_tag

Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk penapis tag.

Penapis untuk digunakan pada 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

Untuk contoh penggunaan bagi penapis media yang disokong, rujuk dokumentasi Liquid Tema Shopify untuk penapis media.

Penapis untuk digunakan pada koleksi

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

Untuk contoh penggunaan, rujuk dokumentasi Liquid Tema Shopify untuk penapis koleksi.