Informacja o zmiennych i filtrach Liquid dla Shopify Order Printer

Ta strona została wydrukowana dnia Jun 29, 2024. Aby zapoznać się z aktualną wersją, odwiedź https://help.shopify.com/pl/manual/orders/printing-orders/shopify-order-printer/liquid-variables-and-filters-reference.

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
Zmienne Liquid dostępne w aplikacji Shopify Order Printer
Filtry Liquid dostępne w aplikacji Shopify Order Printer

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.

Order

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ą wartości line_item.line_level_total_discount lub kolekcji line_item.line_level_discount_allocations.
- 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
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.

Informacja o zmiennych i filtrach Liquid dla Shopify Order Printer

Na tej stronie

Używanie zmiennych i atrybutów

Zmienne Liquid dostępne w aplikacji Shopify Order Printer

Order

Shop

LineItem

Realizacja

Adres

Customer

DiscountApplication

Drukowanie rabatów

DiscountAllocation

Rabat

Produkt

Wariant

Zwrot kosztów

Linia wysyłki

Pozycja podatkowa

Transakcja

Metapole

Filtry Liquid dostępne w aplikacji Shopify Order Printer

Użycie

Filtry do zastosowania w obiektach adresu

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

Filtry do zastosowania dla liczb dotyczących pieniędzy

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

Filtry do zastosowania dla liczb dotyczących wagi

Filtry do zastosowania dla tagów

Filtry do zastosowania dla adresów URL

Filtry do zastosowania dla kolekcji

Gotowy(-a) do rozpoczęcia sprzedaży za pomocą Shopify?