Liquid mainīgo un filtru atsauce lietotnei Shopify Order Printer

Tu vari izmantot Liquid, lai veidotu savas pielāgotās veidnes, izmantojot lietotni Shopify Order Printer. Ar Liquid vari izveidot teksta veidnes un attēlot tās, pamatojoties uz katra pasūtījuma unikālajiem datiem.

Šajā lapā norādītās Liquid atsauces ir atvērtā pirmkoda Liquid versijas paplašinājums, kas paredzēts lietošanai lietotnē Shopify Order Printer. Lai attēlotu informāciju, pamatojoties uz order un shop atribūtiem, vari izmantot šajā atsaucē sniegto objektu, tagu un filtru sarakstu, lai pielāgotu savas veidnes. Vari arī izmantot Admin GraphQL API dokumentāciju, lai uzzinātu papildinformāciju par objektu laukiem.

Mainīgo un atribūtu izmantošana

Lietotnes Shopify Order Printer veidnēs galvenie datu objekti ir order un shop. Lai piekļūtu pasūtījuma atribūtiem, izmanto order.variable_name.

Tālāk minētajiem bieži izmantotajiem pasūtījuma atribūtiem var piekļūt bez priedēkļa order.:

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

Piemēram, ja vēlies piekļūt rindas vienumu mainīgajam, vari izmantot line_items vai order.line_items.

Lietotnē Shopify Order Printer pieejamie Liquid mainīgie

Ir pieejamas tālāk norādītās klases. Atribūti ir uzskaitīti alfabētiskā secībā.

Pasūtījums

Lietotnē Shopify Order Printer ir pieejami tālāk minētie pasūtījumu atribūti:

  • 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. Laiks, kad pasūtījums apstrādāts. Tas ir vienāds ar order.processed_at no GraphQL API. Izmanto date filtru, lai formatētu laikspiedolu, piemēram, ar {{ order.created_at | date: "%B %e, %Y" }}.
  • customer
  • discounts. Novecojis, jo netiek tverti visi atlaižu veidi un informācija. Rekvizīts order.discounts ir aizstāts ar order.discount_applications.
  • discounts_amount. Novecojis, jo netiek tverti visi atlaižu veidi un informācija. Rekvizīts order.discounts ir aizstāts ar order.total_discounts.
  • discount_applications
  • discounts_savings. Novecojis, jo netiek fiksēti visi atlaižu veidi un informācija. Īpašība order.discounts ir aizstāta ar -.
  • 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

Pārskati tālāk norādīto sarakstu ar Shop atribūtiem, kas ir pieejami lietotnē 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

Pārskati tālāk sniegto Shopify Order Printer pieejamo rindas vienuma atribūtu sarakstu:

  • aggregated_update
  • applied_discounts. Novecojis, jo nav pieejami visi atlaižu veidi un informācija. Īpašums line_item.discounts ir aizstāts ar line_item.discount_allocations.
  • current_quantity
  • discount_allocations
  • discounts. Novecojis, jo nav pieejami visi atlaižu veidi un informācija. Īpašums line_item.discounts ir aizstāts ar 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. Novecojis, jo nav iekļautas atlaides no automātiskajām atlaidēm un atlaižu kodiem. Īpašums line_item.line_price ir aizstāts ar line_item.final_line_price.
  • message
  • options_with_values
  • original_line_price
  • original_price
  • price. Novecojis, jo nav iekļautas atlaides no automātiskajām atlaidēm un atlaižu kodiem. Īpašums line_item.price ir aizstāts ar 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. Novecojis, jo nav iekļautas atlaides no automātiskajām atlaidēm un atlaižu kodiem. Īpašums line_item.total_discount ir aizstāts ar line_item.line_level_total_discount.
  • unit_price
  • unit_price_measurement
  • url
  • url_to_remove
  • variant
  • variant_id
  • vendor

Izpilde

Pārskati tālāk sniegto Shopify Order Printer pieejamo izpildes atribūtu sarakstu:

  • created_at. Izmanto filtru date, lai formatētu laikspiedolu, piemēram, šādi: {{ 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

Adrese

Pārskati tālāk sniegto Shopify Order Printer pieejamo adreses atribūtu sarakstu:

  • 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

Klients

Pārskati tālāk sniegto Shopify Order Printer pieejamo klienta atribūtu sarakstu:

  • 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

Pārskati tālāk norādīto DiscountApplication atribūtu sarakstu, kas pieejami Shopify Order Printer:

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

Atlaižu drukāšana

Atlaides var piemērot visam pasūtījumam vai konkrētiem rindas vienumiem:

  • Pasūtījuma līmeņa atlaides: tās tiek piemērotas visam pasūtījumam. Drukājot pasūtījuma rēķinu, šīs atlaides vari parādīt atsevišķi apakšā.
  • Rindas vienuma līmeņa atlaides: tās tiek piemērotas atsevišķiem vienumiem. Drukājot atsevišķa vienuma informāciju rindas vienumu sadaļā, vari norādīt šīs atlaides.

Informācijai par atlaidēm vari piekļūt, izmantojot tālāk norādītos mainīgos:

  • Piekļūsti visām pasūtījumam vai tā rindas vienumiem piemērotajām atlaidēm, izmantojot vērtību order.total_discounts un kolekciju order.discount_applications.
  • Piekļūsti rindas vienuma atlaidēm, izmantojot vērtību line_item.line_level_total_discount vai kolekciju line_item.line_level_discount_allocations.
  • Piekļūsti rindas vienuma cenai, kāda tā bija pirms atlaižu piemērošanas, izmantojot vērtību line_item.original_price.
  • Piekļūsti rindas vienuma gala cenai pēc visu saistīto rindas vienuma līmeņa atlaižu piemērošanas, izmantojot vērtību line_item.final_price.
  • Vērtības line_item.original_line_price un line_item.final_line_price ir vienādas ar vērtībām line_item.original_price un line_item.final_price, kas reizinātas ar line_item.quantity.
  • Piekļūsti pasūtījuma līmeņa atlaidēm, izmantojot kolekciju order.cart_level_discount_applications.

Koda bloka piemērs rindas vienuma līmeņa atlaižu drukāšanai:

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

Koda bloka piemērs pasūtījuma līmeņa atlaižu drukāšanai:

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

Pārskati tālāk norādīto DiscountAllocation atribūtu sarakstu, kas pieejami Shopify Order Printer:

  • amount
  • discount_application

Atlaide

Pārskati tālāk norādīto atlaides atribūtu sarakstu, kas pieejami Shopify Order Printer:

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

Produkts

Pārskati tālāk norādīto produkta atribūtu sarakstu, kas pieejami 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

Variants

Pārskati tālāk norādīto varianta atribūtu sarakstu, kas ir pieejami 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

Atmaksājums

Pārskati tālāk norādīto atmaksājuma atribūtu sarakstu, kas ir pieejami Shopify Order Printer:

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

Piegādes pozīcija

Pārskati tālāk norādīto piegādes pozīcijas atribūtu sarakstu, kas ir pieejami Shopify Order Printer:

  • handle
  • id
  • original_price
  • price. Novecojis, jo cenā netika iekļautas pasūtījuma līmeņa atlaides. Rekvizīts shipping_line.price ir aizstāts ar shipping_line.price_with_discounts.
  • price_with_discounts
  • tax_lines
  • title

Nodokļa pozīcija

Pārskati tālāk norādīto nodokļa pozīcijas atribūtu sarakstu, kas ir pieejami Shopify Order Printer:

  • price
  • rate
  • rate_percentage
  • title

Darījums

Pārskati tālāk norādīto darījuma atribūtu sarakstu, kas ir pieejami 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

Metalauks

Metalauks, kas piesaistīts vecākobjektam. Lai uzzinātu, kā piekļūt konkrēta objekta metalaukam, skati sadaļu Piekļuve metalaukiem.

Metalauki atbalsta vairākus datu tipus, kas nosaka metalaukā glabātās informācijas veidu. Piekļuves ceļš metalaukiem sastāv no diviem līmeņiem:

  • nosaukumvieta – metalauku grupējums, lai novērstu konfliktus;
  • atslēga – metalauka nosaukums.

Ņemot to vērā, vari piekļūt metalauka objektam, izmantojot šādu sintaksi: {{ resource.metafields.namespace.key }}.

Nosaukumu piešķiršana: <object>.metafields.<namespace>.<key>. Piemēram, order.metafields.shipping.express_delivery_status.

Tipi:

  • String (virkne)
  • Array (masīvs) – izmanto [ ], lai indeksētu. Piemēram, order.metafield.shipping.express_delivery_status[0]
  • Integer (vesels skaitlis)
  • Boolean (Būla vērtība)
  • Date (datums)

Piezīme. Metaobject (metaobjekta) tips netiek atbalstīts.

Objekti, kas atbalsta metalaukus:

  • Order (pasūtījums)
  • Customer (klients)
  • Product (produkts)
  • Variant (variants)
  • Location (atrašanās vieta)

Liquid filtri, kas pieejami Shopify Order Printer

Lietojums

Lai lietotu filtrus izvadei, pievieno filtru un visus filtra parametrus izvades figūriekavās {{ }}, pirms kuriem ir vertikālās svītras rakstzīme |. Tālāk norādītajā piemērā product ir objekts, title ir tā rekvizīts, un upcase ir lietotais filtrs:

{{ product.title | upcase }}

Ja product.title vērtība ir Health potion, izvade no filtra upcase būs HEALTH POTION.

Lai uzzinātu vairāk par Liquid filtru izmantošanu, skati Shopify Tēmu Liquid atsauces sadaļu Filtri.

Filtri, kas lietojami adreses objektu tipam (Address)

  • format_address

Lietošanas piemērus skati Shopify Tēmu Liquid dokumentācijā par format_address.

Filtri, kas lietojami jebkuram tekstam/virknei

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

Lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par virkņu filtriem.

Filtri, kas piemērojami skaitļiem ar naudas vērtību

  • money
  • money_with_currency
  • money_without_currency
  • money_without_trailing_zeros

Naudas summu formatēšanai Shopify Order Printer izmanto e-pasta paziņojumu valūtas formatēšanas opcijas, kas konfigurētas Shopify administrēšanas panelī. Tu vari mainīt valūtas formatējumu. Lai mainītu naudas filtru formatējumu lietotnē Shopify Order Printer, iestati vērtības Email with currency un Email without currency Shopify administrēšanas panelī.

Lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par naudas filtriem.

Filtri, kas piemērojami, lai konvertētu objektus uz json

  • json

Lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par json filtriem.

Filtri, kas piemērojami skaitļiem, kuri norāda svaru

  • weight
  • weight_with_unit

Lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par svaru ar mērvienību.

Filtri, kas piemērojami tagiem

  • highlight_active_tag
  • link_to_add_tag
  • link_to_remove_tag
  • link_to_tag

Lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par tagu filtriem.

Filtri, kas piemērojami vietrāžiem 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

Atbalstīto multivides filtru lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par multivides filtriem.

Filtri, kas piemērojami kolekcijām

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

Lietošanas piemērus skati Shopify tēmu Liquid dokumentācijā par kolekciju filtriem.