Referanse for Liquid-variabler og filtre for Shopify Order Printer

Denne siden ble skrevet ut den Jun 29, 2024. Gå til https://help.shopify.com/nb/manual/orders/printing-orders/shopify-order-printer/liquid-variables-and-filters-reference for nyeste versjon.

Du kan bruke Liquid til å bygge dine egne tilpassede maler med Shopify Order Printer-appen. Med Liquid kan du opprette tekstmaler og gjengi dem basert på de unike dataene til hver enkelt bestilling.

Liquid-referansene som er oppført på denne siden, er en utvidelse av versjonen med åpen kildekode av Liquid, og er ment for å brukes i Shopify Order Printer-appen. For å gjengi informasjon basert order og shop egenskaper, kan du bruke listen over objekter, tagger og filtre fra denne referansen for å tilpasse malene dine. Du kan også bruke Admin GraphQL API-dokumenter for å finne ut mer om objektfelt.

På denne siden

Bruke variabler og attributter

I malene for Shopify Order Printer er kjernedataobjektene order og shop. Du kan bruke order.variable_name for å bruke bestillingsegenskapene.

De følgende vanlige bestillingsattributtene er tilgjengelige uten prefikset order.:

  • line_items
  • tax_lines
  • fulfillments
  • transactions
  • discounts
  • refunds
  • shipping_methods
  • customer

Hvis du for eksempel vil ha tilgang til varelinjevariabelen, kan du bruke line_items eller order.line_items.

Liquid-variabler tilgjengelig i Shopify Order Printer

Følgende klasser er tilgjengelige. Attributtene er oppført i alfabetisk rekkefølge.

Bestilling

Følgende bestillingsegenskaper er tilgjengelige 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. Tidspunktet bestillingen ble behandlet. Dette tilsvarer order.processed_at fra GraphQL API. Bruk filteret date til å formatere tidsstempelet, for eksempel med {{ order.created_at | date: "%B %e, %Y" }}.
  • customer
  • discounts. Avviklet fordi ikke alle rabattyper og -detaljer er innhentet. Egenskapen order.discounts er erstattet av order.discount_applications.
  • discounts_amount. Avviklet fordi ikke alle rabattyper og -detaljer er innhentet. Egenskapen order.discounts er erstattet av order.total_discounts.
  • discount_applications
  • discounts_savings. Avviklet fordi ikke alle rabattyper og -detaljer er innhentet. Egenskapen order.discounts er erstattet 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

Se gjennom følgende liste over Shop-egenskaper som er tilgjengelig for 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

Se gjennom følgende liste over varelineegenskaper som er tilgjengelig for Shopify Order Printer:

  • aggregated_update
  • applied_discounts. Avskrevet fordi ikke alle rabattyper og -detaljer er tilgjengelig. Egenskapen line_item.discounts er erstattet av line_item.discount_allocations.
  • current_quantity
  • discount_allocations
  • discounts. Avskrevet fordi ikke alle rabattyper og -detaljer er tilgjengelig. Egenskapen line_item.discounts er erstattet 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. Avskrevet fordi rabatter fra automatiske rabatter og rabattkoder ikke er inkludert. Egenskapen line_item.line_price er erstattet av line_item.final_line_price.
  • message
  • options_with_values
  • original_line_price
  • original_price
  • price. Avskrevet fordi rabatter fra automatiske rabatter og rabattkoder ikke er inkludert. Egenskapen line_item.price er erstattet 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. Avskrevet fordi rabatter fra automatiske rabatter og rabattkoder ikke er inkludert. Egenskapen line_item.total_discount er erstattet av line_item.line_level_total_discount.
  • unit_price
  • unit_price_measurement
  • url
  • url_to_remove
  • variant
  • variant_id
  • vendor

Innfrielse

Gå gjennom følgende liste over oppfyllelsesegenskaper som er tilgjengelige for Shopify Order Printer:

  • created_at. Bruk filteret date til å formatere tidsstempelet, for eksempel 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

Adresse

Gå gjennom følgende liste over adresseegenskapene som er tilgjengelige 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

Kunde

Se gjennom følgende liste over kundeegenskaper som er tilgjengelig for 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

Gå gjennom følgende liste over DiscountApplication-attributter som er tilgjengelig i Shopify Order Printer:

  • target_selection
  • target_type
  • title
  • total_allocated_amount
  • type
  • value_type
  • value

Skrive ut rabatter

Rabatter kan gjelde for hele bestillingen, eller for bestemte varelinjer:

  • Rabatter på bestillingsnivå: De gjelder for hele bestillingen. Du kan vise disse rabattene separat nederst når du skriver ut bestillingsfakturaen.
  • Rabatter på varelinjenivå: De gjelder for enkeltvarer. Du kan nevne disse rabattene når du skriver ut detaljer om individuelle varelinjer i varelinjeseksjonen.

Du kan få tilgang til rabattinformasjon ved hjelp av følgende variabler:

  • Få tilgang til alle rabatter som gjelder for bestillingen eller noen av varelinjene med verdien order.total_discounts og samlingen order.discount_applications.

  • Få tilgang til varelinjerabatter med verdien line_item.line_level_total_discount eller samlingen line_item.line_level_discount_allocations.

    • Få tilgang til varelinjens pris slik den var før rabatter med verdien line_item.original_price.
    • Få tilgang til resultatprisen for varelinjen etter at alle relaterte rabatter på varelinjenivå er iberegnet med verdien line_item.final_price.
    • Verdiene line_item.original_line_price og line_item.final_line_price tilsvarer verdiene line_item.original_price og line_item.final_price multiplisert med line_item.quantity.

  • Få tilgang til rabatter på bestillingsnivå med samlingen order.cart_level_discount_applications.

Eksempekodeblokk for utskrift av rabatter på varelinjenivå:

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

Eksempelkodeblokk for utskrift av rabatter på bestillingsnivå:

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

DiscountAllocation

Se gjennom følgende liste over DiscountAllocation-attributter som er tilgjengelig for Shopify Order Printer:

  • amount
  • discount_application

Rabatt

Se gjennom følgende liste over rabattegenskaper som er tilgjengelig for Shopify Order Printer:

  • amount
  • code
  • free_shipping_discount
  • id
  • savings
  • title
  • total_amount
  • total_savings

Produkt

Se gjennom følgende liste over produktegenskaper som er tilgjengelig for 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

Se gjennom følgende liste over variantegenskaper som er tilgjengelig for 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

Refusjon

Se gjennom følgende liste over refusjonsegenskaper som er tilgjengelig for Shopify Order Printer:

  • amount
  • created_at
  • id
  • note
  • refund_line_items
  • restock
  • transactions

ShippingLine

Se gjennom følgende liste over fraktlinjeegenskaper som er tilgjengelig i Shopify Order Printer:

  • handle
  • id
  • original_price
  • tax_lines
  • title

Avgiftslinje

Se gjennom følgende liste over avgiftslinjeegenskaper som er tilgjengelig for Shopify Order Printer:

  • price
  • rate
  • rate_percentage
  • title

Transaksjon

Se gjennom følgende liste over transaksjonsegenskaper som er tilgjengelig for 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

Metafelt

Et metafelt knyttet til et overordnet objekt. For å finne ut hvordan du får tilgang til et metafelt på et bestemt objekt, kan du se Access-metafelter.

Metafelter støtter flere datatyper, som fastslår hvilken type informasjon som er lagret i metafeltet. For å få tilgang til metafelter, vil tilgangsstien for metafelter bestå av to forkortelser:

  • navnefelt – en gruppering av metafelter for å hindre konflikter,
  • nøkkel – metafeltnavnet.

Gitt dette, har du tilgang til metafeltobjektet med følgende syntaks: {{ resource.metafields.namespace.key }}.

Navngi: <object>.metafields.<namespace>.<key>. For eksempel order.metafields.shipping.express_delivery_status.

Typer:

  • String
  • Array – bruk [] å indeksere. For eksempel order.metafield.shipping.express_delivery_status[0]
  • Integer
  • Boolean
  • Date

Merk Metaobject-typen støttes ikke.

Objekter som støtter metafelter:

  • Order
  • Customer
  • Product
  • Variant
  • Location

Tilgjengelige Liquid-filtre i Shopify Order Printer

Bruk

For å legge til filtre på en utdata, legger du til filteret og eventuelle filterparametre i utdataenes krøllbelagte klammeparenter {{ }}, innledes med et datakanaltegn |. I eksempelet nedenfor er produktet objektet, tittelen er egenskapen og upcase er filteret som brukes:

{{ product.title | upcase }}

Hvis product.title har den Health potion , vil HEALTH POTION bli utdataene fra det upcase filteret.

Se Filtre-seksjonen fra Liquid-referansen for Shopify-temaer for mer informasjon om hvordan du bruker Liquid-filtre.

Filtre som skal brukes på adresseobjekter

  • format_address

For brukseksempler, se Liquid-dokumentasjonen for Shopify-temaer for format_address.

Filtre som skal brukes på tekst/streng

  • camelcase
  • camelize
  • encode_url_component
  • format_code
  • handle
  • highlight
  • pad_spaces
  • paragraphize
  • pluralize
  • url_escape
  • url_param_escape

For bruksekseringer kan du se Liquid-dokumentasjonen for Shopify-temaer for strengfiltre.

Filtre som skal brukes på pengebeløpende tall

  • money
  • money_with_currency
  • money_without_currency
  • money_without_trailing_zeros

Shopify Order Printer bruker formateringsalternativene for valuta i e-postvarsler som er konfigurert i Shopify-administrator til å formatere pengebeløp. Du kan endre valutaformateringen. Angi verdiene Email with currency og Email without currency i Shopify-administrator for å endre formatering av pengebeløp i Shopify Order Printer.

For brukseksempler, se Liquid-dokumentasjonen for Shopify-temaer for pengefiltre.

Filtre som gjelder for konverter objekter til json

  • json

For brukseksempler, se Liquid-dokumentasjonen for Shopify-temaer for json.filtre.

Filtre som brukes på tall med vektbetydning

  • weight
  • weight_with_unit

Se dokumentasjonen for Liquid for Shopify-temaer for vekt med enhet for bruk.

Filtre som brukes for tagger

  • highlight_active_tag
  • link_to_add_tag
  • link_to_remove_tag
  • link_to_tag

For brukseksempler, se Liquid-dokumentasjonen for Shopify-temaer for taggfiltre.

Filtre som skal brukes på URL-adresser

  • 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 dokumentasjonen for Liquid-dokumentasjonen for Shopify-temaer for medier og html-filtre for bruk.

Filtre som skal brukes på samlinger

  • link_to_type
  • link_to_vendor
  • sort_by
  • url_for_type
  • url_for_vendor
  • within

For brukseksempler, se Liquid-dokumentasjonen for Shopify-temaer for samlingsfiltre.

Er du klar til å begynne å selge med Shopify?

Prøv det gratis