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.

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.

Nota

Puoi creare i tuoi alias all'interno del corpo del modello con la sintassi Liquid {% assign fulfillments_count = order.fulfillments | size %} e poi farvi riferimento con la sintassi {{ fulfillments_count }} in fondo al testo del modello.

Variabili Liquid disponibili su Shopify Order Printer

Nota

Puoi aggiungere il seguente codice al modello: <a href="{{ shop.url }}/admin/orders/{{ order.id }}">View order</a> . Verrà visualizzato come URL finale, ad esempio: <a href="https://myshop.myshopify.com/admin/orders/123">View order</a>.

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

Ordine

Nota

Per maggiori dettagli sugli attributi dell'ordine elencati di seguito, consulta la documentazione relativa all'oggetto Order di Shopify Liquid.

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

Nota

Per maggiori dettagli sugli attributi del negozio elencati di seguito, consulta la documentazione relativa all'oggetto Shop di Shopify Liquid.

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

Nota

Per maggiori dettagli sugli attributi di LineItem elencati di seguito, consulta la documentazione relativa all'oggetto LineItem di Shopify Liquid.

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

Nota

Per maggiori dettagli sugli attributi dell'evasione elencati di seguito, consulta la documentazione relativa all'oggetto Fulfillment di Shopify Liquid.

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

Nota

Per maggiori dettagli sugli attributi dell'indirizzo elencati di seguito, consulta la documentazione relativa all'oggetto Address di Shopify Liquid.

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

Nota

Per maggiori dettagli sugli attributi del cliente elencati di seguito, consulta la documentazione relativa all'oggetto Customer di Shopify Liquid.

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

Nota

Per maggiori dettagli sugli attributi DiscountApplication elencati di seguito, consulta la documentazione Liquid dei Temi Shopify relativa all'oggetto 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

Nota

Per maggiori dettagli sugli attributi DiscountAllocation elencati di seguito, consulta la documentazione Liquid dei Temi Shopify relativa all'oggetto DiscountAllocation.

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

• amount
• discount_application

Sconto

Nota

Deprecato perché non rileva tutti i tipi e i dettagli degli sconti.

L'oggetto sconto è stato sostituito dagli oggetti discount_allocation e discount_application.

Per maggiori dettagli sugli attributi dello sconto elencati di seguito, consulta la documentazione Liquid dei Temi Shopify relativa all'oggetto 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

Nota

Per maggiori dettagli sugli attributi del prodotto elencati di seguito, consulta la documentazione relativa all'oggetto Product di Shopify Liquid.

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

Nota

Per maggiori dettagli sugli attributi della variante elencati di seguito, consulta la documentazione relativa all'oggetto Variant di Shopify Liquid.

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

Nota

Per maggiori dettagli sugli attributi del rimborso elencati di seguito, consulta la documentazione relativa all'oggetto Refund di Shopify Liquid.

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
• tax_lines
• title

TaxLine

Nota

Per maggiori dettagli sugli attributi di TaxLine elencati di seguito, consulta la documentazione relativa all'oggetto TaxLine di Shopify Liquid.

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

• price
• rate
• rate_percentage
• title

Transazione

Nota

Per maggiori dettagli sugli attributi della transazione elencati di seguito, consulta la documentazione relativa all'oggetto Transaction di Shopify Liquid.

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.