Riferimento variabili e filtri Liquid per Shopify Order Printer

Puoi utilizzare Liquid per creare modelli personalizzati tramite l'app Shopify Order Printer. Con Liquid puoi creare modelli di testo ed eseguirne il rendering in base ai dati univoci di ciascun ordine.

I riferimenti Liquid elencati in questa pagina sono un'estensione della versione open source di Liquid da utilizzare con l'app Shopify Order Printer. Per visualizzare le informazioni basate su attributi order e shop, puoi utilizzare l'elenco di oggetti, tag e filtri in questo riferimento per personalizzare i modelli. Puoi anche utilizzare i documenti sull'API Admin GraphQL per maggiori informazioni sui campi degli oggetti.

Su questa pagina

Utilizzo di variabili e attributi

Nei modelli Shopify Order Printer, gli oggetti dati principali sono order e shop. Puoi utilizzare order.variable_name per accedere agli attributi dell'ordine.

I seguenti attributi d'ordine più usati sono accessibili senza il prefisso order.:

line_items
tax_lines
fulfillments
transactions
discounts
refunds
shipping_methods
customer

Ad esempio, se vuoi accedere alla variabile delle voci dell'ordine, puoi utilizzare line_items o order.line_items.

Variabili Liquid disponibili su Shopify Order Printer

Sono disponibili le seguenti classi. Gli attributi sono elencati in ordine alfabetico.

Ordine

Su Shopify Order Printer sono disponibili i seguenti attributi dell'ordine:

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. L'ora in cui l'ordine è stato elaborato. Corrisponde a order.processed_at dall'API GraphQL. Utilizza il filtro date per formattare il timestamp, ad esempio con {{ order.created_at | date: "%B %e, %Y" }}.
customer
discounts. Deprecato perché non rileva tutti i tipi e i dettagli degli sconti. La proprietà order.discounts è stata sostituita da order.discount_applications.
discounts_amount. Deprecato perché non rileva tutti i tipi e i dettagli degli sconti. La proprietà order.discounts è stata sostituita da order.total_discounts.
discount_applications
discounts_savings. Deprecato perché non rileva tutti i tipi e i dettagli degli sconti. La proprietà order.discounts è stata sostituita da -.
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

Esamina il seguente elenco di attributi di negozio disponibili su 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

Esamina il seguente elenco di attributi di voce disponibili su Shopify Order Printer:

aggregated_update
applied_discounts. Deprecato perché non sono disponibili tutti i tipi e i dettagli degli sconti. La proprietà line_item.discounts è stata sostituita da line_item.discount_allocations.
current_quantity
discount_allocations
discounts. Deprecato perché non sono disponibili tutti i tipi e i dettagli degli sconti. La proprietà line_item.discounts è stata sostituita da 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. Deprecati perché non sono inclusi gli sconti automatici e i codici sconto. La proprietà line_item.line_price è stata sostituita da line_item.final_line_price.
message
options_with_values
original_line_price
original_price
price. Deprecati perché non sono inclusi gli sconti automatici e i codici sconto. La proprietà line_item.price è stata sostituita da 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. Deprecati perché non sono inclusi gli sconti automatici e i codici sconto. La proprietà line_item.total_discount è stata sostituita da line_item.line_level_total_discount.
unit_price
unit_price_measurement
url
url_to_remove
variant
variant_id
vendor

Evasione

Esamina il seguente elenco di attributi di evasione disponibili su Shopify Order Printer:

created_at. Utilizza il filtro date per formattare il timestamp, ad esempio con {{ 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

Indirizzo

Esamina il seguente elenco di attributi di indirizzo disponibili su 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

Cliente

Esamina il seguente elenco di attributi di cliente disponibili su 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

Consulta l'elenco seguente di attributi DiscountApplication disponibili su Shopify Order Printer:

target_selection
target_type
title
total_allocated_amount
type
value_type
value

Stampa sconti

Gli sconti possono essere applicati a tutto l'ordine o a voci specifiche:

Sconti a livello di ordine: si applicano a tutto l'ordine. Puoi mostrare questi sconti separatamente in fondo alla stampa della fattura dell'ordine.
Sconti a livello di voce: si applicano a singoli articoli. Puoi menzionare questi sconti quando si stampano i dettagli di una singola voce nella sezione.

Puoi accedere alle informazioni sugli sconti utilizzando le seguenti variabili:

Accedi a tutti gli sconti applicati all'ordine o a una qualsiasi delle sue voci con il valore order.total_discounts e la collezioneorder.discount_applications.
Accedi agli sconti per voci con il valore line_item.line_level_total_discount o la collezioneline_item.line_level_discount_allocations.
- Accedi al prezzo della voce così come era prima di applicare eventuali sconti con il valoreline_item.original_price.
- Accedi alla voce del prezzo risultante dopo aver applicato tutti i relativi sconti a livello di voce con il valore line_item.final_price.
- I line_item.original_line_price e line_item.final_line_price sono uguali ai valori line_item.original_price e line_item.final_price moltiplicati per line_item.quantity.
Accedi agli sconti a livello di ordine con la collezioneorder.cart_level_discount_applications.

Esempio di blocco di codice per stampare sconti a livello di voce dell'ordine:

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

Esempio di blocco di codice per la stampa di sconti a livello di ordine:

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

Maggiori informazioni sui tipi di sconto e sull'uso degli sconti in Liquid.

DiscountAllocation

Consulta l'elenco seguente di attributi DiscountAllocation disponibili su Shopify Order Printer:

amount
discount_application

Sconto

Esamina il seguente elenco di attributi di sconto disponibili su Shopify Order Printer:

amount
code
free_shipping_discount
id
savings
title
total_amount
total_savings

Prodotto

Esamina il seguente elenco di attributi di prodotto disponibili su 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

Variante

Esamina il seguente elenco di attributi di variante disponibili su 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

Rimborso

Esamina il seguente elenco di attributi di rimborso disponibili su Shopify Order Printer:

amount
created_at
id
note
refund_line_items
restock
transactions

ShippingLine

Esamina il seguente elenco di attributi di voce di spedizione su Shopify Order Printer:

handle
id
original_price
price. Deprecato perché il prezzo non includeva sconti a livello di ordine. La proprietà shipping_line.price è stata sostituita da shipping_line.price_with_discounts.
price_with_discounts
tax_lines
title

TaxLine

Esamina il seguente elenco di attributi di riga delle imposte disponibili su Shopify Order Printer:

price
rate
rate_percentage
title

Transazione

Esamina il seguente elenco di attributi di transazione disponibili su 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

Metafield

Un metafield allegato a un oggetto principale. Per maggiori informazioni su come accedere a un metafield su un oggetto specifico, consulta Accesso ai metafield.

I metafield supportano più tipi di dati, che determinano il tipo di informazioni archiviate nel metafield. Per accedere ai metafield, il percorso di accesso per i metafield è costituito da due elementi:

spazio dei nomi: un raggruppamento di metafield per evitare conflitti;
key: il nome del metafield.

Dato questo, puoi accedere all'oggetto metafield con la sintassi seguente: {{ resource.metafields.namespace.key }}.

Denominazione: <object>.metafields.<namespace>.<key>. Ad esempio, order.metafields.shipping.express_delivery_status.

Tipi:

String
Array -: usa [] per indicizzare. Per esempio order.metafield.shipping.express_delivery_status[0]
Integer
Boolean
Date

Nota: il tipo Metaobject non è supportato.

Oggetti che supportano i metafield:

Order
Customer
Product
Variant
Location

Filtri Liquid disponibili in Shopify Order Printer

Utilizzo

Per applicare filtri a un output, aggiungi il filtro e tutti i parametri del filtro all'interno dei delimitatori della parentesi graffa dell'output {{ }}, preceduti da un carattere di detrazione |. Nell'esempio seguente, product è l'oggetto, title è la sua proprietà e upcase è il filtro in fase di applicazione:

{{ product.title | upcase }}

Se product.title ha il valore Health potion, HEALTH POTION sarà l'output dal filtro upcase.

Consulta la sezione filtri del riferimento Liquid dei temi Shopify per dettagli su come utilizzare i filtri Liquid.

Filtri da applicare agli oggetti di indirizzo

format_address

Per esempi di utilizzo, consulta la documentazione Liquid dei temi di Shopify relativa a format_address.

Filtri da applicare a qualsiasi testo/stringa

camelcase
camelize
encode_url_component
format_code
handle
highlight
pad_spaces
paragraphize
pluralize
url_escape
url_param_escape

Per esempi di utilizzo, consulta la documentazione Liquid dei temi di Shopify relativa ai filtri di stringa.

Filtri da applicare ai numeri relativi all'importo

money
money_with_currency
money_without_currency
money_without_trailing_zeros

Shopify Order Printer utilizza le opzioni di formattazione della valuta per le notifiche via email configurate nel Pannello di controllo di Shopify per la formattazione del denaro. Puoi modificare la formattazione della valuta. Imposta i valori Email with currency e Email without currency nel Pannello di controllo di Shopify per modificare la formattazione dei filtri di denaro in Shopify Order Printer.

Per esempi di utilizzo, consulta la documentazione Liquid dei temi di Shopify relativa ai filtri dell'importo.

Filtri da applicare per convertire gli oggetti in json

json

Per esempi di utilizzo, consulta la documentazione Liquid dei temi di Shopify relativa ai filtri json.

Filtri da applicare ai numeri relativi al peso

weight
weight_with_unit

Per esempi di utilizzo, consulta la documentazione Liquid dei temi di Shopify relativa al peso unitario.

Filtri da applicare ai tag

highlight_active_tag
link_to_add_tag
link_to_remove_tag
link_to_tag

Per esempi di utilizzo, consulta la documentazione Liquid dei temi di Shopify relativa ai filtri di tag.

Filtri da applicare agli 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

Per esempi di utilizzo, consulta la documentazione Liquid dei temi di Shopify relativa ai filtri multimediali e html.

Filtri da applicare alle collezioni

link_to_type
link_to_vendor
sort_by
url_for_type
url_for_vendor
within

Per esempi di utilizzo, consulta la documentazione Liquid dei temi di Shopify relativa ai filtri di collezione.