Shopify Order Printerin Liquid-muuttujat ja suodatinviitteet

Liquidin avulla voit luoda omia mukautettuja malleja Shopify Order Printer ‑sovelluksella. Liquidin avulla voit luoda tekstimalleja ja hahmontaa ne tilausten yksilöllisten tietojen perusteella.

Tällä sivulla luetellut Liquid-viittaukset ovat Liquidin avoimen lähdekoodin version laajennuksia, ja ne on tarkoitettu käyttäväksi Shopify Order Printer ‑sovelluksessa. Jos haluat hahmontaa order- ja shop-määritteiden perusteella, voit mukauttaa mallejasi käyttämällä tämän viittauksen objektien, tunnisteiden ja suodattimien luetteloa. Voit myös katsoa Admin GraphQL API ‑dokumenteista tietoja objektikentistä.

Tällä sivulla

Muuttujien ja määritteiden käyttäminen

Shopify Order Printer ‑mallien ydintieto-objektit ovat order ja shop. order.variable_name avaa tilauksen määritteet.

Seuraavat yleisesti käytetyt tilausmääritteet ovat käytettävissä ilman order.-etuliitettä:

line_items
tax_lines
fulfillments
transactions
discounts
refunds
shipping_methods
customer

Jos esimerkiksi haluat käyttää rivikohtien muuttujaa, voit käyttää line_items- tai order.line_items-koodia.

Shopify Order Printerissä käytettävissä olevat Liquid-muuttujat

Käytettävissä on seuraavat luokat. Määritteet on listattu aakkosjärjestyksessä.

Tilaus

Shopify Order Printerissä on käytettävissä seuraavat Tilaus-määritteet:

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. Ajankohta, jolloin tilaus on käsitelty. Tämä on yhtä kuin order.processed_at GraphQL API:ssä. Muotoile aikaleima käyttämällä date-suodatinta, esimerkiksi {{ order.created_at | date: "%B %e, %Y" }}.
customer
discounts. Vanhentunut, koska kaikkia alennustyyppejä ja tietoja ei ole tallennettu. order.discounts-ominaisuus on korvattu order.discount_applications-ominaisuudella.
discounts_amount. Vanhentunut, koska kaikkia alennustyyppejä ja tietoja ei ole tallennettu. order.discounts-ominaisuus on korvattu order.total_discounts-ominaisuudella.
discount_applications
discounts_savings. Vanhentunut, koska kaikkia alennustyyppejä ja tietoja ei ole tallennettu. order.discounts-ominaisuus on korvattu --ominaisuudella.
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

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevien kaupan määritteiden luetteloon:

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-objekti

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevien rivikohtien määritteiden luetteloon:

aggregated_update
applied_discounts. Vanhentunut, koska kaikki alennustyypit ja tiedot eivät ole käytettävissä. line_item.discounts-ominaisuus on korvattu line_item.discount_allocations-ominaisuudella.
current_quantity
discount_allocations
discounts. Vanhentunut, koska kaikki alennustyypit ja tiedot eivät ole käytettävissä. line_item.discounts-ominaisuus on korvattu line_item.discount_allocations-ominaisuudella.
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. Vanhentunut, koska automaattisten alennusten ja alennuskoodien alennuksia ei sisällytetä. line_item.line_price-ominaisuus on korvattu line_item.final_line_price-ominaisuudella.
message
options_with_values
original_line_price
original_price
price. Vanhentunut, koska automaattisten alennusten ja alennuskoodien alennuksia ei sisällytetä. line_item.price-ominaisuus on korvattu line_item.final_price-ominaisuudella.
product
product_id
properties
quantity
refunded_quantity
requires_shipping
selling_plan_allocation
sku
successfully_fulfilled_quantity
tax_lines
taxable
title
total_discount. Vanhentunut, koska automaattisten alennusten ja alennuskoodien alennuksia ei sisällytetä. line_item.total_discount-ominaisuus on korvattu line_item.line_level_total_discount-ominaisuudella.
unit_price
unit_price_measurement
url
url_to_remove
variant
variant_id
vendor

Jakelu

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevien jakelumääritteiden luetteloon:

created_at. Muotoile aikaleima käyttämällä date-suodatinta, esimerkiksi {{ 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

Osoite

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevien osoitemääritteiden luetteloon:

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

Asiakas

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevien asiakasmääritteiden luetteloon:

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

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevien DiscountApplication-määritteiden luetteloon:

target_selection
target_type
title
total_allocated_amount
type
value_type
value

Alennusten tulostaminen

Alennuksia voidaan soveltaa koko tilaukseen tai tiettyihin rivikohtiin:

Tilaustason alennukset: Sovelletaan koko tilaukseen. Voit näyttää nämä alennukset erikseen alaosassa, kun tulostat tilauksen laskun.
Rivikohtatason alennukset: Sovelletaan yksittäisiin tuotteisiin. Voit mainita nämä alennukset, kun tulostat yksittäisiä tuotetietoja rivikohtaosioon.

Voit käyttää alennusten tietoja seuraavien muuttujien avulla:

Voit käyttää kaikkia tilaukseen sovellettuja alennuksia tai mitä tahansa sen rivikohtia order.total_discounts-arvolla ja order.discount_applications-kokoelmalla.
Voit käyttää rivikohta-alennuksia line_item.line_level_total_discount-arvolla tai line_item.line_level_discount_allocations-kokoelmalla.
- Voit käyttää rivikohdan hintaa sellaisena kuin se oli ennen alennusten soveltamista line_item.original_price-arvolla.
- Voit käyttää rivikohdan seurauksena olevaa hintaa kaikkien liittyvien rivikohtatason alennusten soveltamisen jälkeen line_item.final_price-arvolla.
- line_item.original_line_price- ja line_item.final_line_price-arvot ovat yhtä kuin line_item.original_price- ja line_item.final_price-arvot kerrottuna line_item.quantity-arvolla.
Voit käyttää tilaustason alennuksia order.cart_level_discount_applications-kokoelmalla.

Esimerkkikoodilohko rivikohtatason alennusten tulostamiseen:

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

Esimerkkikoodilohko tilaustason alennusten tulostamiseen:

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

Lue lisää alennustyypeistä ja alennusten käsittelystä Liquidissa.

DiscountAllocation

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevien DiscountAllocation-määritteiden luetteloon:

amount
discount_application

Alennus

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevaan alennusmääritteiden luetteloon:

amount
code
free_shipping_discount
id
savings
title
total_amount
total_savings

Tuote

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevaan tuotemääritteiden luetteloon:

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

Versio

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevaan versiomääritteiden luetteloon:

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

Maksun palautus

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevaan hyvitysmääritteiden luetteloon:

amount
created_at
id
note
refund_line_items
restock
transactions

ShippingLine

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevaan toimitusrivimääritteiden luetteloon:

handle
id
original_price
tax_lines
title

TaxLine

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevaan verorivimääritteiden luetteloon:

price
rate
rate_percentage
title

Tapahtuma

Tutustu seuraavaan Shopify Order Printerissä saatavilla olevaan tapahtumamääritteiden luetteloon:

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

Metakenttä

Ylätason objektiin liitetty metakenttä. Jos haluat lisätietoja tietyn objektin metakentän käytöstä, lue lisää kohdasta Metakenttien käyttö.

Metakentät tukevat useita tietotyyppejä, jotka määrittävät, millaisia tietoja metakenttään tallennetaan. Metakenttien käyttöön vaadittava käyttöpolku koostuu kahdesta tasosta:

nimiavaruus - metakenttien ryhmittely konfliktien estämiseksi,
avain - metakentän nimi.

Voit siis käyttää metakenttäobjektia seuraavalla syntaksilla: {{ resource.metafields.namespace.key }}.

Nimeäminen: <object>.metafields.<namespace>.<key>. Esimerkiksi order.metafields.shipping.express_delivery_status.

Tyypit:

String
Array - käytä indeksoinnissa []. Esimerkiksi: order.metafield.shipping.express_delivery_status[0]
Integer
Boolean
Date

Huomautus Metaobject-tyyppiä ei tueta.

Metakenttiä tukevat objektit:

Order
Customer
Product
Variant
Location

Shopify Order Printerissä käytettävissä olevat Liquid-suodattimet

Käyttö

Jos haluat käyttää suodattimia tuotoksessa, lisää suodatin ja kaikki suodatinparametrit tuotoksen kaarisulkuerottimien sisäpuolelle {{ }} ennen pystyviivaa |. Alla olevassa esimerkissä tuote on objekti, nimi on sen ominaisuus, ja upcase on käytössä oleva suodatin:

{{ product.title | upcase }}

Jos tuotteen product.title arvo on Health potion, upcase-suodattimen tuotos on HEALTH POTION.

Saat lisätietoa Liquid-suodattimien käytöstä tutustumalla Shopify Themes Liquidin Suodattimet-osioon.

Osoiteobjekteissa käytettävät suodattimet

format_address

Katso käyttöesimerkkejä Shopify Themes Liquid -ohjeen kohdasta format_address.

Missä tahansa tekstissä tai merkkijonossa käytettävät suodattimet

camelcase
camelize
encode_url_component
format_code
handle
highlight
pad_spaces
paragraphize
pluralize
url_escape
url_param_escape

Katso käyttöesimerkkejä Shopify Themes Liquid -ohjeen kohdasta merkkijonon suodattimet.

Rahaan viittaavien numeroiden yhteydessä käytettävät suodattimet

money
money_with_currency
money_without_currency
money_without_trailing_zeros

Shopify Order Printer käyttää sähköposti-ilmoitusten valuutan muotoiluvaihtoehtoja, jotka on määritetty Shopify-ylläpitäjässä rahojen muotoilulle. Voit muuttaa valuutan muotoilua. Muuta rahasuodattimien muotoilua Shopify Order Printer -sovelluksessa määrittämällä Email with currency- ja Email without currency -arvot Shopify-ylläpitäjässä.

Katso käyttöesimerkkejä Shopify Themes Liquid -ohjeen kohdasta rahasuodattimet.

Objektien muuttamisen yhteydessä jsoniin käytettävät suodattimet

json

Katso käyttöesimerkkejä Shopify Themes Liquid -ohjeen kohdasta json-suodattimet.

Painoon viittaavien numeroiden yhteydessä käytettävät suodattimet

weight
weight_with_unit

Katso käyttöesimerkkejä Shopify Themes Liquid -ohjeen kohdasta paino ja yksikkö.

Tunnisteiden yhteydessä käytettävät suodattimet

highlight_active_tag
link_to_add_tag
link_to_remove_tag
link_to_tag

Katso käyttöesimerkkejä Shopify Themes Liquid -ohjeen kohdasta tunnisteen suodattimet.

URL-osoitteissa käytettävät suodattimet

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

Katso käyttöesimerkkejä Shopify Themes Liquid -ohjeen kohdista media- ja html-suodattimet.

Kokoelmissa käytettävät suodattimet

link_to_type
link_to_vendor
sort_by
url_for_type
url_for_vendor
within

Katso käyttöesimerkkejä Shopify Themes Liquid -ohjeen kohdasta kokoelman suodattimet.