Liquid-variabler och filterreferens för Shopify Order Printer

Du kan använda Liquid för att skapa dina egna anpassade mallar med hjälp av appen Shopify Order Printer. Med Liquid kan du skapa textmallar och återge dem baserat på varje orders unika data.

Liquid-hänvisningarna som listas på den här sidan är ett tillägg till den öppna källkodsversionen av Liquid och är avsedda att användas i appen Shopify Order Printer. Du kan återge information baserat på attributen order och shop genom att använda listan över objekt, taggar och filter från den här referensen för att anpassa dina mallar. Du kan även använda Admin GraphQL API-dokument för att lära dig mer om objektfält.

På den här sidan

Använda variabler och attribut

I mallarna för Shopify Order Printer är de viktigaste dataobjekten order och shop. Du kan använda order.variable_name för att komma åt orderattributen.

Följande vanliga orderattribut är tillgängliga utan prefixet order.:

line_items
tax_lines
fulfillments
transactions
discounts
refunds
shipping_methods
customer

Om du till exempel vill komma åt postvariablen så kan du använda line_items eller order.line_items.

Liquid-variabler tillgängliga i Shopify Order Printer

Följande klasser är tillgängliga. Attribut listas i alfabetisk ordning.

Beställ

Följande orderattribut finns tillgängliga 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. Den tid då ordern har hanterats. Detta är lika med order.processed_at från GraphQL-API:n. Använd filtret date för att formatera tidsstämpeln, till exempel med {{ order.created_at | date: "%B %e, %Y" }}.
customer
discounts. Borttagen eftersom alla rabattyper och uppgifter inte samlas in. Egenskapen order.discounts har ersatts av order.discount_applications.
discounts_amount. Borttagen eftersom alla rabattyper och uppgifter inte samlas in. Egenskapen order.discounts har ersatts av order.total_discounts.
discount_applications
discounts_savings. Borttagen eftersom alla rabattyper och uppgifter inte samlas in. Egenskapen order.discounts har ersatts 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

Granska följande lista över Shop-attribut som är tillgängliga i 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

Granska följande lista över postattribut som är tillgängliga i Shopify Order Printer:

aggregated_update
applied_discounts. Inaktuell eftersom alla rabattyper och detaljer inte är tillgängliga. Egenskapen line_item.discounts har ersatts av line_item.discount_allocations.
current_quantity
discount_allocations
discounts. Inaktuell eftersom alla rabattyper och detaljer inte är tillgängliga. Egenskapen line_item.discounts har ersatts 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. Inaktuell eftersom rabatter från automatiska rabatter och rabattkoder inte ingår. Egenskapen line_item.line_price har ersatts av line_item.final_line_price.
message
options_with_values
original_line_price
original_price
price. Inaktuell eftersom rabatter från automatiska rabatter och rabattkoder inte ingår. Egenskapen line_item.price har ersatts 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. Inaktuell eftersom rabatter från automatiska rabatter och rabattkoder inte ingår. Egenskapen line_item.total_discount har ersatts av line_item.line_level_total_discount.
unit_price
unit_price_measurement
url
url_to_remove
variant
variant_id
vendor

Distribution

Granska följande lista över distributionsattribut som är tillgängliga i Shopify Order Printer:

created_at. Använd filtret date för att formatera tidsstämpeln, till exempel 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

Adress

Granska följande lista över adressattribut som finns tillgängliga 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

Kund

Granska följande lista över kundattribut som är tillgängliga i 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

Granska följande lista över DiscountApplication-attribut som är tillgängliga i Shopify Order Printer:

target_selection
target_type
title
total_allocated_amount
type
value_type
value

Skriv ut rabatter

Rabatter kan tillämpas på hela ordern eller på specifika poster:

Ordernivårabatter: De gäller för hela ordern. Du kan visa rabatterna separat längst ner när du skriver ut din orderfaktura.
Rabatter på postnivå: De gäller för enskilda artiklar. Du kan nämna dessa rabatter när du skriver ut enskilda artikeldetaljer i postavsnittet.

Du kan komma åt rabattinformationen med hjälp av följande variabler:

Få tillgång till alla rabatter som tillämpas på ordern eller någon av dess poster med värdet order.total_discounts och produktserien order.discount_applications.
Få tillgång till rabatter för poster med värdet line_item.line_level_total_discount eller produktserien line_item.line_level_discount_allocations.
- Få tillgång till postpriset som det var innan du tillämpar några rabatter med värdet line_item.original_price.
- Få tillgång till postens resultatpris efter att ha tillämpat alla relaterade rabatter på postnivå med värdet line_item.final_price.
- Värdena line_item.original_line_price och line_item.final_line_price är lika med värdenaline_item.original_price och line_item.final_price multiplicerade med line_item.quantity.
Få tillgång till rabatter för ordernivå med produktserienorder.cart_level_discount_applications.

Exempel på kodblock för att skriva ut rabatter på postnivå:

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

Exempel på kodblock för att skriva ut rabatter på ordernvå:

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

Mer information om rabattyper och arbeta med rabatter i Liquid.

DiscountAllocation

Granska följande lista över DiscountAllocation-attribut som är tillgängliga i Shopify Order Printer:

amount
discount_application

Rabatt

Granska följande lista över rabattattribut som är tillgängliga i Shopify Order Printer:

amount
code
free_shipping_discount
id
savings
title
total_amount
total_savings

Produkt

Granska följande lista över produktattribut som är tillgängliga i 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

Granska följande lista över variantattribut som är tillgängliga i 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

Återbetalning

Granska följande lista över återbetalningsattribut som är tillgängliga i Shopify Order Printer:

amount
created_at
id
note
refund_line_items
restock
transactions

Leveranspost

Granska följande lista över leveranspostattribut som är tillgängliga i Shopify Order Printer:

handle
id
original_price
price. Borttaget eftersom priset inte inkluderar rabatter på ordernivå. Egenskapen shipping_line.price har ersatts av shipping_line.price_with_discounts.
price_with_discounts
tax_lines
title

TaxLine

Granska följande lista över skattepostattribut som är tillgängliga i Shopify Order Printer:

price
rate
rate_percentage
title

Transaktion

Granska följande lista över transaktionsattribut som är tillgängliga i 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

Metafält

Ett metafält som är kopplat till ett överordnat objekt. Se Åtkomst till metafält för mer information om hur du får tillgång till ett metafält för ett specifikt objekt.

Flera datatyper kan användas med metafält, och datatypen avgör vilken typ av information som lagras i metafältet. Åtkomstsökvägen för metafält består av två olika delar som används för åtkomst till dem:

namnrymd – en gruppering av metafält för att förhindra konflikter
nyckel – metafältets namn.

Med det som utgångspunkt kan du komma åt metafältobjektet med följande syntax: {{ resource.metafields.namespace.key }}.

Namngivning: <object>.metafields.<namespace>.<key>. Till exempel: order.metafields.shipping.express_delivery_status.

Typer:

String
Array – använd [] för att indexera. Till exempel order.metafield.shipping.express_delivery_status[0]
Integer
Boolean
Date

Obs! Typen Metaobject stöds inte.

Objekt som har stöd för metafält:

Order
Customer
Product
Variant
Location

Liquid-filter som finns tillgängliga i Shopify Order Printer

Användning

Om du vill tillämpa filter på utdata lägger du till filtret och eventuella filterparametrar inom klammerparenteserna för dessa utdata – {{ }}, med ett vertikalstreck | före. I exemplet nedan är produkten objektet, titeln är dess egenskap och upcase är det filter som tillämpas:

{{ product.title | upcase }}

Om product.title har värdet Health potion kommer HEALTH POTION att vara utdata från filtret upcase.

Se avsnittet Filter i Liquid-referensen för Shopify-teman för mer information om hur du använder Liquid-filter.

Filter som ska tillämpas på adressobjekt

format_address

Se format_address i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas på valfri text/sträng

camelcase
camelize
encode_url_component
format_code
handle
highlight
pad_spaces
paragraphize
pluralize
url_escape
url_param_escape

Se strängfilter i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas på siffror som står för pengar

money
money_with_currency
money_without_currency
money_without_trailing_zeros

Shopify Order Printer använder alternativen för valutaformatering i e-postaviseringar som konfigurerats i Shopify-administratören för att formatera pengar. Du kan ändra valutaformateringen. Ställ in värdena Email with currency och Email without currency i Shopify-administratören för att ändra formateringen för pengafilter i Shopify Order Printer.

Se pengafilter i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas för att konvertera objekt till json

json

Se json-filter i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas på siffror som står för vikt

weight
weight_with_unit

Se vikt med enhet i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas på taggar

highlight_active_tag
link_to_add_tag
link_to_remove_tag
link_to_tag

Se taggfilter i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas på URL:er

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 media- och HTML-filter i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas på produktserier

link_to_type
link_to_vendor
sort_by
url_for_type
url_for_vendor
within

Se produktseriefilter i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.