Liquid-variabler och filterreferens för Shopify Order Printer

Den här sidan skrevs ut den Jul 27, 2024. Besök https://help.shopify.com/sv/manual/orders/printing-orders/shopify-order-printer/liquid-variables-and-filters-reference för den aktuella versionen.

Du kan använda Liquid för att skapa dina egna anpassade mallar med hjälp av appen Shopify Order Printer. Med Liquid kan du skapa textmallar och återge dem baserat på varje orders unika data.

Liquid-hänvisningarna som listas på den här sidan är ett tillägg till den öppna källkodsversionen av Liquid och är avsedda att användas i appen Shopify Order Printer. Du kan återge information baserat på attributen order och shop genom att använda listan över objekt, taggar och filter från den här referensen för att anpassa dina mallar. Du kan även använda Admin GraphQL API-dokument för att lära dig mer om objektfält.

På den här sidan

Använda variabler och attribut

I mallarna för Shopify Order Printer är de viktigaste dataobjekten order och shop. Du kan använda order.variable_name för att komma åt orderattributen.

Följande vanliga orderattribut är tillgängliga utan prefixet order.:

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

Om du till exempel vill komma åt postvariablen så kan du använda line_items eller order.line_items.

Liquid-variabler tillgängliga i Shopify Order Printer

Följande klasser är tillgängliga. Attribut listas i alfabetisk ordning.

Beställ

Följande orderattribut finns tillgängliga 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. Den tid då ordern har hanterats. Detta är lika med order.processed_at från GraphQL-API:n. Använd filtret date för att formatera tidsstämpeln, till exempel med {{ order.created_at | date: "%B %e, %Y" }}.
  • customer
  • discounts. Borttagen eftersom alla rabattyper och uppgifter inte samlas in. Egenskapen order.discounts har ersatts av order.discount_applications.
  • discounts_amount. Borttagen eftersom alla rabattyper och uppgifter inte samlas in. Egenskapen order.discounts har ersatts av order.total_discounts.
  • discount_applications
  • discounts_savings. Borttagen eftersom alla rabattyper och uppgifter inte samlas in. Egenskapen order.discounts har ersatts 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

Granska följande lista över Shop-attribut som är tillgängliga i 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

Granska följande lista över postattribut som är tillgängliga i Shopify Order Printer:

  • aggregated_update
  • applied_discounts. Inaktuell eftersom alla rabattyper och detaljer inte är tillgängliga. Egenskapen line_item.discounts har ersatts av line_item.discount_allocations.
  • current_quantity
  • discount_allocations
  • discounts. Inaktuell eftersom alla rabattyper och detaljer inte är tillgängliga. Egenskapen line_item.discounts har ersatts 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. Inaktuell eftersom rabatter från automatiska rabatter och rabattkoder inte ingår. Egenskapen line_item.line_price har ersatts av line_item.final_line_price.
  • message
  • options_with_values
  • original_line_price
  • original_price
  • price. Inaktuell eftersom rabatter från automatiska rabatter och rabattkoder inte ingår. Egenskapen line_item.price har ersatts 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. Inaktuell eftersom rabatter från automatiska rabatter och rabattkoder inte ingår. Egenskapen line_item.total_discount har ersatts av line_item.line_level_total_discount.
  • unit_price
  • unit_price_measurement
  • url
  • url_to_remove
  • variant
  • variant_id
  • vendor

Distribution

Granska följande lista över distributionsattribut som är tillgängliga i Shopify Order Printer:

  • created_at. Använd filtret date för att formatera tidsstämpeln, till exempel 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

Adress

Granska följande lista över adressattribut som finns tillgängliga 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

Kund

Granska följande lista över kundattribut som är tillgängliga i 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

Granska följande lista över DiscountApplication-attribut som är tillgängliga i Shopify Order Printer:

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

Skriv ut rabatter

Rabatter kan tillämpas på hela ordern eller på specifika poster:

  • Ordernivårabatter: De gäller för hela ordern. Du kan visa rabatterna separat längst ner när du skriver ut din orderfaktura.
  • Rabatter på postnivå: De gäller för enskilda artiklar. Du kan nämna dessa rabatter när du skriver ut enskilda artikeldetaljer i postavsnittet.

Du kan komma åt rabattinformationen med hjälp av följande variabler:

  • Få tillgång till alla rabatter som tillämpas på ordern eller någon av dess poster med värdet order.total_discounts och produktserien order.discount_applications.

  • Få tillgång till rabatter för poster med värdet line_item.line_level_total_discount eller produktserien line_item.line_level_discount_allocations.

    • Få tillgång till postpriset som det var innan du tillämpar några rabatter med värdet line_item.original_price.
    • Få tillgång till postens resultatpris efter att ha tillämpat alla relaterade rabatter på postnivå med värdet line_item.final_price.
    • Värdena line_item.original_line_price och line_item.final_line_price är lika med värdenaline_item.original_price och line_item.final_price multiplicerade med line_item.quantity.

  • Få tillgång till rabatter för ordernivå med produktserienorder.cart_level_discount_applications.

Exempel på kodblock för att skriva ut rabatter på postnivå:

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

Exempel på kodblock för att skriva ut rabatter på ordernvå:

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

Granska följande lista över DiscountAllocation-attribut som är tillgängliga i Shopify Order Printer:

  • amount
  • discount_application

Rabatt

Granska följande lista över rabattattribut som är tillgängliga i Shopify Order Printer:

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

Produkt

Granska följande lista över produktattribut som är tillgängliga i 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

Granska följande lista över variantattribut som är tillgängliga i 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

Återbetalning

Granska följande lista över återbetalningsattribut som är tillgängliga i Shopify Order Printer:

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

Leveranspost

Granska följande lista över leveranspostattribut som är tillgängliga i Shopify Order Printer:

  • handle
  • id
  • original_price
  • tax_lines
  • title

TaxLine

Granska följande lista över skattepostattribut som är tillgängliga i Shopify Order Printer:

  • price
  • rate
  • rate_percentage
  • title

Transaktion

Granska följande lista över transaktionsattribut som är tillgängliga i 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

Metafält

Ett metafält som är kopplat till ett överordnat objekt. Se Åtkomst till metafält för mer information om hur du får tillgång till ett metafält för ett specifikt objekt.

Flera datatyper kan användas med metafält, och datatypen avgör vilken typ av information som lagras i metafältet. Åtkomstsökvägen för metafält består av två olika delar som används för åtkomst till dem:

  • namnrymd – en gruppering av metafält för att förhindra konflikter
  • nyckel – metafältets namn.

Med det som utgångspunkt kan du komma åt metafältobjektet med följande syntax: {{ resource.metafields.namespace.key }}.

Namngivning: <object>.metafields.<namespace>.<key>. Till exempel: order.metafields.shipping.express_delivery_status.

Typer:

  • String
  • Array – använd [] för att indexera. Till exempel order.metafield.shipping.express_delivery_status[0]
  • Integer
  • Boolean
  • Date

Obs! Typen Metaobject stöds inte.

Objekt som har stöd för metafält:

  • Order
  • Customer
  • Product
  • Variant
  • Location

Liquid-filter som finns tillgängliga i Shopify Order Printer

Användning

Om du vill tillämpa filter på utdata lägger du till filtret och eventuella filterparametrar inom klammerparenteserna för dessa utdata – {{ }}, med ett vertikalstreck | före. I exemplet nedan är produkten objektet, titeln är dess egenskap och upcase är det filter som tillämpas:

{{ product.title | upcase }}

Om product.title har värdet Health potion kommer HEALTH POTION att vara utdata från filtret upcase.

Se avsnittet Filter i Liquid-referensen för Shopify-teman för mer information om hur du använder Liquid-filter.

Filter som ska tillämpas på adressobjekt

  • format_address

Se format_address i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas på valfri text/sträng

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

Se strängfilter i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas på siffror som står för pengar

  • money
  • money_with_currency
  • money_without_currency
  • money_without_trailing_zeros

Shopify Order Printer använder alternativen för valutaformatering i e-postaviseringar som konfigurerats i Shopify-administratören för att formatera pengar. Du kan ändra valutaformateringen. Ställ in värdena Email with currency och Email without currency i Shopify-administratören för att ändra formateringen för pengafilter i Shopify Order Printer.

Se pengafilter i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas för att konvertera objekt till json

  • json

Se json-filter i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas på siffror som står för vikt

  • weight
  • weight_with_unit

Se vikt med enhet i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas på taggar

  • highlight_active_tag
  • link_to_add_tag
  • link_to_remove_tag
  • link_to_tag

Se taggfilter i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas på URL:er

  • 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 media- och HTML-filter i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Filter som ska tillämpas på produktserier

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

Se produktseriefilter i dokumentationen om Shopify-teman med Liquid för att se användningsexempel.

Är du redo att börja sälja med Shopify?

Prova gratis