Referanse for Liquid-variabler og filtre for Shopify Order Printer

Du kan bruke Liquid til å bygge dine egne tilpassede maler med Shopify Order Printer-appen. Med Liquid kan du opprette tekstmaler og gjengi dem basert på de unike dataene til hver enkelt bestilling.

Liquid-referansene som er oppført på denne siden, er en utvidelse av versjonen med åpen kildekode av Liquid, og er ment for å brukes i Shopify Order Printer-appen. For å gjengi informasjon basert order og shop egenskaper, kan du bruke listen over objekter, tagger og filtre fra denne referansen for å tilpasse malene dine. Du kan også bruke Admin GraphQL API-dokumenter for å finne ut mer om objektfelt.

På denne siden

Bruke variabler og attributter

I malene for Shopify Order Printer er kjernedataobjektene order og shop. Du kan bruke order.variable_name for å bruke bestillingsegenskapene.

De følgende vanlige bestillingsattributtene er tilgjengelige uten prefikset order.:

line_items
tax_lines
fulfillments
transactions
discounts
refunds
shipping_methods
customer

Hvis du for eksempel vil ha tilgang til varelinjevariabelen, kan du bruke line_items eller order.line_items.

Liquid-variabler tilgjengelig i Shopify Order Printer

Følgende klasser er tilgjengelige. Attributtene er oppført i alfabetisk rekkefølge.

Bestilling

Følgende bestillingsegenskaper er tilgjengelige i 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. Tidspunktet bestillingen ble behandlet. Dette tilsvarer order.processed_at fra GraphQL API. Bruk filteret date til å formatere tidsstempelet, for eksempel med {{ order.created_at | date: "%B %e, %Y" }}.
customer
discounts. Avviklet fordi ikke alle rabattyper og -detaljer er innhentet. Egenskapen order.discounts er erstattet av order.discount_applications.
discounts_amount. Avviklet fordi ikke alle rabattyper og -detaljer er innhentet. Egenskapen order.discounts er erstattet av order.total_discounts.
discount_applications
discounts_savings. Avviklet fordi ikke alle rabattyper og -detaljer er innhentet. Egenskapen order.discounts er erstattet av -.
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

Se gjennom følgende liste over Shop-egenskaper som er tilgjengelig for 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

LineItem

Se gjennom følgende liste over varelineegenskaper som er tilgjengelig for Shopify Order Printer:

aggregated_update
applied_discounts. Avskrevet fordi ikke alle rabattyper og -detaljer er tilgjengelig. Egenskapen line_item.discounts er erstattet av line_item.discount_allocations.
current_quantity
discount_allocations
discounts. Avskrevet fordi ikke alle rabattyper og -detaljer er tilgjengelig. Egenskapen line_item.discounts er erstattet av 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. Avskrevet fordi rabatter fra automatiske rabatter og rabattkoder ikke er inkludert. Egenskapen line_item.line_price er erstattet av line_item.final_line_price.
message
options_with_values
original_line_price
original_price
price. Avskrevet fordi rabatter fra automatiske rabatter og rabattkoder ikke er inkludert. Egenskapen line_item.price er erstattet av 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. Avskrevet fordi rabatter fra automatiske rabatter og rabattkoder ikke er inkludert. Egenskapen line_item.total_discount er erstattet av line_item.line_level_total_discount.
unit_price
unit_price_measurement
url
url_to_remove
variant
variant_id
vendor

Innfrielse

Gå gjennom følgende liste over oppfyllelsesegenskaper som er tilgjengelige for Shopify Order Printer:

created_at. Bruk filteret date til å formatere tidsstempelet, for eksempel med {{ 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

Adresse

Gå gjennom følgende liste over adresseegenskapene som er tilgjengelige i 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

Kunde

Se gjennom følgende liste over kundeegenskaper som er tilgjengelig for 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

Gå gjennom følgende liste over DiscountApplication-attributter som er tilgjengelig i Shopify Order Printer:

target_selection
target_type
title
total_allocated_amount
type
value_type
value

Skrive ut rabatter

Rabatter kan gjelde for hele bestillingen, eller for bestemte varelinjer:

Rabatter på bestillingsnivå: De gjelder for hele bestillingen. Du kan vise disse rabattene separat nederst når du skriver ut bestillingsfakturaen.
Rabatter på varelinjenivå: De gjelder for enkeltvarer. Du kan nevne disse rabattene når du skriver ut detaljer om individuelle varelinjer i varelinjeseksjonen.

Du kan få tilgang til rabattinformasjon ved hjelp av følgende variabler:

Få tilgang til alle rabatter som gjelder for bestillingen eller noen av varelinjene med verdien order.total_discounts og samlingen order.discount_applications.
Få tilgang til varelinjerabatter med verdien line_item.line_level_total_discount eller samlingen line_item.line_level_discount_allocations.
Få tilgang til varelinjens pris slik den var før rabatter med verdien line_item.original_price. - Få tilgang til resultatprisen for varelinjen etter at alle relaterte rabatter på varelinjenivå er iberegnet med verdien line_item.final_price. - Verdiene line_item.original_line_price og line_item.final_line_price tilsvarer verdiene line_item.original_price og line_item.final_price multiplisert med line_item.quantity.
Få tilgang til rabatter på bestillingsnivå med samlingen order.cart_level_discount_applications.

Eksempekodeblokk for utskrift av rabatter på varelinjenivå:

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

Eksempelkodeblokk for utskrift av rabatter på bestillingsnivå:

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

Finn ut mer om rabattyper og hvordan du jobber med rabatter i Liquid.

DiscountAllocation

Se gjennom følgende liste over DiscountAllocation-attributter som er tilgjengelig for Shopify Order Printer:

amount
discount_application

Rabatt

Se gjennom følgende liste over rabattegenskaper som er tilgjengelig for Shopify Order Printer:

amount
code
free_shipping_discount
id
savings
title
total_amount
total_savings

Produkt

Se gjennom følgende liste over produktegenskaper som er tilgjengelig for 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

Variant

Se gjennom følgende liste over variantegenskaper som er tilgjengelig for 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

Refusjon

Se gjennom følgende liste over refusjonsegenskaper som er tilgjengelig for Shopify Order Printer:

amount
created_at
id
note
refund_line_items
restock
transactions

ShippingLine

Se gjennom følgende liste over fraktlinjeegenskaper som er tilgjengelig i Shopify Order Printer:

handle
id
original_price
price. Avviklet fordi prisen ikke inkluderte rabatter på bestillingsnivå. Egenskapen shipping_line.price er erstattet av shipping_line.price_with_discounts.
price_with_discounts
tax_lines
title

Avgiftslinje

Se gjennom følgende liste over avgiftslinjeegenskaper som er tilgjengelig for Shopify Order Printer:

price
rate
rate_percentage
title

Transaksjon

Se gjennom følgende liste over transaksjonsegenskaper som er tilgjengelig for 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

Metafelt

Et metafelt knyttet til et overordnet objekt. For å finne ut hvordan du får tilgang til et metafelt på et bestemt objekt, kan du se Access-metafelter.

Metafelter støtter flere datatyper, som fastslår hvilken type informasjon som er lagret i metafeltet. For å få tilgang til metafelter, vil tilgangsstien for metafelter bestå av to forkortelser:

navnefelt – en gruppering av metafelter for å hindre konflikter,
nøkkel – metafeltnavnet.

Gitt dette, har du tilgang til metafeltobjektet med følgende syntaks: {{ resource.metafields.namespace.key }}.

Navngi: <object>.metafields.<namespace>.<key>. For eksempel order.metafields.shipping.express_delivery_status.

Typer:

String
Array – bruk [] å indeksere. For eksempel order.metafield.shipping.express_delivery_status[0]
Integer
Boolean
Date

Merk Metaobject-typen støttes ikke.

Objekter som støtter metafelter:

Order
Customer
Product
Variant
Location

Tilgjengelige Liquid-filtre i Shopify Order Printer

Bruk

For å legge til filtre på en utdata, legger du til filteret og eventuelle filterparametre i utdataenes krøllbelagte klammeparenter {{ }}, innledes med et datakanaltegn |. I eksempelet nedenfor er produktet objektet, tittelen er egenskapen og upcase er filteret som brukes:

{{ product.title | upcase }}

Hvis product.title har den Health potion , vil HEALTH POTION bli utdataene fra det upcase filteret.

Se Filtre-seksjonen fra Liquid-referansen for Shopify-temaer for mer informasjon om hvordan du bruker Liquid-filtre.

Filtre som skal brukes på adresseobjekter

format_address

For brukseksempler, se Liquid-dokumentasjonen for Shopify-temaer for format_address.

Filtre som skal brukes på tekst/streng

camelcase
camelize
encode_url_component
format_code
handle
highlight
pad_spaces
paragraphize
pluralize
url_escape
url_param_escape

For bruksekseringer kan du se Liquid-dokumentasjonen for Shopify-temaer for strengfiltre.

Filtre som skal brukes på pengebeløpende tall

money
money_with_currency
money_without_currency
money_without_trailing_zeros

Shopify Order Printer bruker formateringsalternativene for valuta i e-postvarsler som er konfigurert i Shopify-administrator til å formatere pengebeløp. Du kan endre valutaformateringen. Angi verdiene Email with currency og Email without currency i Shopify-administrator for å endre formatering av pengebeløp i Shopify Order Printer.

For brukseksempler, se Liquid-dokumentasjonen for Shopify-temaer for pengefiltre.

Filtre som gjelder for konverter objekter til json

json

For brukseksempler, se Liquid-dokumentasjonen for Shopify-temaer for json.filtre.

Filtre som brukes på tall med vektbetydning

weight
weight_with_unit

Se dokumentasjonen for Liquid for Shopify-temaer for vekt med enhet for bruk.

Filtre som brukes for tagger

highlight_active_tag
link_to_add_tag
link_to_remove_tag
link_to_tag

For brukseksempler, se Liquid-dokumentasjonen for Shopify-temaer for taggfiltre.

Filtre som skal brukes på URL-adresser

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

Se dokumentasjonen for Liquid-dokumentasjonen for Shopify-temaer for medier og html-filtre for bruk.

Filtre som skal brukes på samlinger

link_to_type
link_to_vendor
sort_by
url_for_type
url_for_vendor
within

For brukseksempler, se Liquid-dokumentasjonen for Shopify-temaer for samlingsfiltre.