Informacja o zmiennych i filtrach Liquid dla Shopify Order Printer

Języka Liquid możesz używać do tworzenia własnych niestandardowych szablonów za pomocą aplikacji Shopify Order Printer. Liquid umożliwia tworzenie i renderowanie szablonów tekstowych na podstawie unikalnych danych każdego zamówienia.

Referencje dotyczące języka Liquid przedstawione na tej stronie stanowią rozszerzenie wersji open-source Liquid i są przeznaczone do użytku w aplikacji Shopify Order Printer. Aby renderować informacje na podstawie atrybutów order i shop, możesz użyć listy obiektów, tagów i filtrów z przedstawionej tutaj informacji w celu dostosowania szablonów. Ponadto możesz użyć dokumentów API GraphQL Admin, aby dowiedzieć się więcej o polach obiektu.

Na tej stronie

Używanie zmiennych i atrybutów

W szablonach Shopify Order Printer główne obiekty danych to order oraz shop. Możesz użyć order.variable_name, aby uzyskać dostęp do atrybutów zamówienia.

Wymienione poniżej często używane atrybuty zamówienia są dostępne bez prefiksu order.:

line_items
tax_lines
fulfillments
transactions
discounts
refunds
shipping_methods
customer

Na przykład, jeśli chcesz uzyskać dostęp do zmiennej pozycji pojedynczej, możesz użyć atrybutu line_items lub order.line_items.

Zmienne Liquid dostępne w aplikacji Shopify Order Printer

Dostępne są poniższe klasy. Atrybuty są wyświetlane w kolejności alfabetycznej.

Zamówienie

W aplikacji Shopify Order Printer dostępne są następujące atrybuty zamówienia:

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. Czas przetwarzania zamówienia. Równa się ona wartościomorder.processed_at z GraphQL API. Użyj date, aby sformatować sygnaturę czasową, na przykład za pomocą {{ order.created_at | date: "%B %e, %Y" }}.
customer
discounts. Nieaktualne, ponieważ nie wszystkie typy i szczegóły rabatów są rejestrowane. Właściwość order.discounts została zastąpiona przez order.discount_applications.
discounts_amount. Nieaktualne, ponieważ nie wszystkie typy i szczegóły rabatów są rejestrowane. Właściwość order.discounts została zastąpiona przez order.total_discounts.
discount_applications
discounts_savings. Nieaktualne, ponieważ nie wszystkie typy i szczegóły rabatów są rejestrowane. Właściwość order.discounts została zastąpiona przez -.
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

Przejrzyj następującą listę atrybutów Shop dostępnych w aplikacji 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

Przejrzyj następującą listę atrybutów pozycji pojedynczej dostępnych w aplikacji Shopify Order Printer:

aggregated_update
applied_discounts. Nieaktualne, ponieważ nie wszystkie typy i szczegóły rabatu są dostępne. Właściwość line_item.discounts została zastąpiona przez line_item.discount_allocations.
current_quantity
discount_allocations
discounts. Nieaktualne, ponieważ nie wszystkie typy i szczegóły rabatu są dostępne. Właściwość line_item.discounts została zastąpiona przez 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. Nieaktualne, ponieważ rabaty z automatycznych rabatów i kodów rabatowych nie są uwzględnione. Właściwość line_item.line_price została zastąpiona przez line_item.final_line_price.
message
options_with_values
original_line_price
original_price
price. Nieaktualne, ponieważ rabaty z automatycznych rabatów i kodów rabatowych nie są uwzględnione. Właściwość line_item.price została zastąpiona przez 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. Nieaktualne, ponieważ rabaty z automatycznych rabatów i kodów rabatowych nie są uwzględnione. Właściwość line_item.total_discount została zastąpiona przez line_item.line_level_total_discount.
unit_price
unit_price_measurement
url
url_to_remove
variant
variant_id
vendor

Realizacja

Przejrzyj następującą listę atrybutów realizacji dostępnych w aplikacji Shopify Order Printer:

created_at. Użyj date, aby sformatować sygnaturę czasową, na przykład za pomocą {{ 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

Adres

Przejrzyj następującą listę atrybutów adresu dostępnych w aplikacji 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

Customer

Przejrzyj następującą listę atrybutów klienta dostępnych w aplikacji 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

Przejrzyj następującą listę atrybutów DiscountApplication dostępnych w aplikacji Shopify Order Printer:

target_selection
target_type
title
total_allocated_amount
type
value_type
value

Drukowanie rabatów

Rabaty można stosować do całego zamówienia lub do określonych pozycji pojedynczych:

Rabaty na poziomie zamówienia: Dotyczą całego zamówienia. Rabaty te można wyświetlać osobno na dole podczas drukowania faktury do zamówienia.
Rabaty na poziomie pozycji pojedynczych: Dotyczą poszczególnych pozycji. Rabaty te można podać podczas drukowania szczegółów pozycji pojedynczych w sekcji pozycji pojedynczych.

Dostęp do informacji o rabatach można uzyskać za pomocą następujących zmiennych:

Uzyskaj dostęp do wszystkich rabatów zastosowanych do zamówienia lub dowolnej z jego pozycji pojedynczych za pomocą wartości order.total_discounts i kolekcji order.discount_applications.
Uzyskaj dostęp do rabatów na poziomie pozycji za pomocą line_item.line_level_total_discountwartości lub line_item.line_level_discount_allocationskolekcji.
Uzyskaj dostęp do ceny pozycji przed zastosowaniem rabatów za pomocą wartości line_item.original_price. - Uzyskaj dostęp do ceny wynikowej pozycji po zastosowaniu wszystkich powiązanych rabatów na poziomie pozycji za pomocą wartości line_item.final_price. - Wartości line_item.original_line_price i line_item.final_line_price są równe wartościom line_item.original_price i line_item.final_price pomnożonym przez line_item.quantity.
Uzyskaj dostęp do rabatów na poziomie zamówienia za pomocą kolekcji order.cart_level_discount_applications.

Przykładowy blok kodu do drukowania rabatów na poziomie pozycji pojedynczych:

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

Przykładowy blok kodu do drukowania rabatów na poziomie zamówienia:

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

Dowiedz się więcej o typach rabatów i pracy z rabatami w języku Liquid.

DiscountAllocation

Przejrzyj poniższą listę atrybutów DiscountAllocation dostępnych w aplikacji Shopify Order Printer:

amount
discount_application

Rabat

Przejrzyj następującą listę atrybutów rabatu dostępnych w aplikacji Shopify Order Printer:

amount
code
free_shipping_discount
id
savings
title
total_amount
total_savings

Produkt

Przejrzyj następującą listę atrybutów produktu dostępnych w aplikacji 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

Wariant

Przejrzyj następującą listę atrybutów wariantu dostępnych w aplikacji 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

Zwrot kosztów

Przejrzyj następującą listę atrybutów zwrotu kosztów dostępnych w aplikacji Shopify Order Printer:

amount
created_at
id
note
refund_line_items
restock
transactions

Linia wysyłki

Przejrzyj następującą listę atrybutów linii wysyłki dostępnych w aplikacji Shopify Order Printer:

handle
id
original_price
price. Nieaktualne, ponieważ cena nie zawierała rabatów na poziomie zamówienia. Właściwość shipping_line.price została zastąpiona przez shipping_line.price_with_discounts.
price_with_discounts
tax_lines
title

Pozycja podatkowa

Przejrzyj następującą listę atrybutów pozycji pojedynczej dostępnych w aplikacji Shopify Order Printer:

price
rate
rate_percentage
title

Transakcja

Przejrzyj następującą listę atrybutów transakcji dostępnych w aplikacji 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

Metapole

Metapole dołączone do obiektu nadrzędnego. Aby dowiedzieć się, jak uzyskać dostęp do metapola dla określonego obiektu, zapoznaj się z sekcją Dostęp do metapól.

Metapola obsługują wiele typów danych, które określają rodzaj informacji przechowywanych w metapolu. Uzyskanie dostępu do metapól umożliwia ścieżka dostępu dla metapól składająca się z dwóch warstw:

przestrzeń nazw - grupa metapól w celu uniknięcia konfliktu
klucz - nazwa metapola.

W związku z tym możesz uzyskać dostęp do obiektu metapola za pomocą następującej składni: {{ resource.metafields.namespace.key }}.

Nazewnictwo: <object>.metafields.<namespace>.<key>. Na przykład: order.metafields.shipping.express_delivery_status.

Typy:

String
Array - użyj [] do indeksowania. Przykład: order.metafield.shipping.express_delivery_status[0]
Integer
Boolean
Date

Uwaga Typ Metaobject nie jest obsługiwany.

Obiekty obsługujące metapola:

Order
Customer
Product
Variant
Location

Filtry Liquid dostępne w aplikacji Shopify Order Printer

Użycie

Aby zastosować filtry do danych wyjściowych, dodaj filtr i wszelkie parametry filtra w nawiasach klamrowych {{ }}, poprzedzone kreską pionową |. W poniższym przykładzie produkt jest obiektem, tytuł jest jego właściwością, a upcase to zastosowany filtr:

{{ product.title | upcase }}

Jeśli product.title ma wartość Health potion, HEALTH POTION to dane wyjściowe po zastosowaniu filtraupcase.

Zapoznaj się z sekcją Filtry z referencji Shopify Themes Liquid, aby uzyskać szczegółowe informacje na temat korzystania z filtrów Liquid.

Filtry do zastosowania w obiektach adresu

format_address

Przykłady wykorzystania przedstawiono w dokumentacji Shopify Themes Liquid dotyczącej format_address.

Filtry do zastosowania dla dowolnego tekstu / ciągu znaków

camelcase
camelize
encode_url_component
format_code
handle
highlight
pad_spaces
paragraphize
pluralize
url_escape
url_param_escape

Przykłady wykorzystania przedstawiono w dokumentacji Shopify Themes Liquid dotyczącej filtrów ciągów znaków.

Filtry do zastosowania dla liczb dotyczących pieniędzy

money
money_with_currency
money_without_currency
money_without_trailing_zeros

W aplikacji Shopify Order Printer używane są opcje formatowania walut powiadomień e-mail skonfigurowane w panelu administracyjnym Shopify na potrzeby formatowania pieniędzy. Możesz zmienić formatowanie walut. Ustaw wartości Email with currency i Email without currency w panelu administracyjnym Shopify, aby zmienić formatowanie filtrów pieniędzy w aplikacji Shopify Order Printer.

Przykłady wykorzystania przedstawiono w dokumentacji Shopify Themes Liquid dotyczącej filtrów pieniędzy.

Filtry, które należy zastosować, aby przekonwertować obiekty na json

json

Przykłady wykorzystania przedstawiono w dokumentacji Shopify Themes Liquid dotyczącej filtrów json.

Filtry do zastosowania dla liczb dotyczących wagi

weight
weight_with_unit

Przykłady wykorzystania przedstawiono w dokumentacji Shopify Themes Liquid dotyczącej wagi z jednostką.

Filtry do zastosowania dla tagów

highlight_active_tag
link_to_add_tag
link_to_remove_tag
link_to_tag

Przykłady wykorzystania przedstawiono w dokumentacji Shopify Themes Liquid dotyczącej filtrów tagów.

Filtry do zastosowania dla adresów 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

Przykłady wykorzystania przedstawiono w dokumentacji Shopify Themes Liquid dotyczącej filtrów dla multimediów i html.

Filtry do zastosowania dla kolekcji

link_to_type
link_to_vendor
sort_by
url_for_type
url_for_vendor
within

Przykłady wykorzystania przedstawiono w dokumentacji Shopify Themes Liquid dotyczącej filtrów kolekcji.