Problemen oplossen met geïmporteerde Order Printers templates

Wanneer je je templates migreert van de oude Order Printer app naar de nieuwe Shopify Order Printer app, worden je Liquid variabelen bijgewerkt om compatibiliteit met de nieuwe app te garanderen. In zeldzame gevallen kan het nodig zijn om problemen op te lossen met je geïmporteerde templates.

Als je geïmporteerde templates niet goed worden afgedrukt, dan moet je misschien de code van je template handmatig aanpassen in de nieuwe Shopify Order Printer app. Bekijk de volgende meest voorkomende redenen waarom templates mogelijk niet correct worden geïmporteerd:

  • Templates bevatten aangepaste CSS
  • Template bevat metavelden
  • Liquid variabelen worden mogelijk niet correct bijgewerkt

Op deze pagina vind je gedetailleerde informatie over het oplossen van mogelijke problemen bij het importeren van je eigen templates naar de nieuwe Shopify Order Printer-app.

Veelvoorkomende CSS-ontwerpaanpassingen updaten

Als de templates die je overdraagt aangepaste CSS bevatten, dan moet je mogelijk de CSS-code in je templates handmatig bijwerken om designelementen zoals afbeeldingen, aangepaste lettertypes, logo's of barcodes correct weer te geven.

Metaveldvariabelen bijwerken

Voor toegang tot een metaveld geef je de naamruimte van het metaveld op en hoef je .value niet aan de variabele toe te voegen. Lees meer over metavelddefinities.

Gebruik bijvoorbeeld de variabele product.metafields.custom.manufacturerid in plaats van de variabele product.metafields.custom.manufacturerid.value.

Raadpleeg de pagina Aangepaste gegevens in je Shopify-beheercentrum om naamruimtewaarden voor elk metaveld te identificeren. Metavelddefinities worden gegroepeerd op de objecten die ze gebruiken, zoals producten, varianten of bestellingen.

Gemeenschappelijke Liquid-variabelen bijwerken

In de meeste gevallen worden je Liquid-variabelen automatisch bijgewerkt tijdens het migratieproces. Als je templates echter niet correct migreren en je gebruikt een van de variabelen uit deze sectie, dan moet je misschien je oude variabelen handmatig vervangen door nieuwe variabelen. De Shopify Order Printer-app gebruikt andere variabelen dan de oude Order Printer-app.

Als je bijvoorbeeld de variabele date gebruikt, vervang je deze door de variabele created_at.

Bestellingsvariabelen

Bestellingsvariabelen worden anders gebruikt in de Shopify Order Printer-app. Voeg het voorvoegsel order. toe om bestellingsvariabelen te gebruiken. Gebruik bijvoorbeeld order.billing_address om de variabele billing_address te gebruiken.

De volgende veelgebruikte bestellingsvariabelen zijn bruikbaar zonder het voorvoegsel order.:

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

Als je bijvoorbeeld de orderregelvariabele wil gebruiken, kun je een line_items of order.line_items gebruiken.

Je kunt ook je eigen aliassen maken voor een template. Je kunt bijvoorbeeld de Liquid-syntaxis {% assign fulfillments_count = order.fulfillments | size %} gebruiken en er vervolgens naar verwijzen door {{ fulfillments_count }} te gebruiken in de code.

Bestellingsvariabele
Variabele in de verouderde versie van de Order Printer-appVariabele in de nieuwe Shopify Order Printer-app
line_items
  • Terugbetaalde orderregels zijn niet opgenomen in de variabele line_items. Controleer de volgende gegevens:
    • Je kunt terugbetaalde orderregels gebruiken met behulp van de variabele refunds.<each>.refunded_line_items . Bekijk het volgende voorbeeld.
      {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %}
    • Je kunt de terugbetaalde orderregels toevoegen aan de collectie line_items als je wil. Bekijk het volgende voorbeeld.
      {% assign refunded_line_items = order.refunds | map: "refund_line_items" | map: "line_item" %} {% assign line_items_with_refunded = order.line_items | concat: refunded_line_items | uniq %}
    • Zorg ervoor dat je het filter | uniq gebruikt om duplicatie van de terugbetaalde orderregels te voorkomen.
  • Orderregels voor fooien zijn niet opgenomen in de variabele line_items. Controleer de volgende gegevens:
    • Je kunt orderregels voor fooien gebruiken met behulp van de variabele tip_line_items.
    • Je kunt tip_line_items toevoegen aan de collectie line_items als je wil. Bekijk het volgende voorbeeld.
      {% assign line_items_with_tips = order.line_items | concat: order.tip_line_items %}
  • Je kunt de volgende voorbeeldcode gebruiken om de verouderde versie van de Order Printer-collectie line_items na te bootsen.
    {% assign refunded_line_items = refunds | map: "refund_line_items" | map: "line_item" %} {% assign all_line_items = order.line_items | concat: refunded_line_items | concat: order.tip_line_items | uniq %} {% for line_item in all_line_items %} ... {% endfor %}
credit_cardGebruik betalingsgegevens op basis van elke transactie uit de bestelling met de variabele transactions.<each>.payment_details.
current_shipping_priceshipping_price
dateGebruik de variabele created_at. Gebruik het filter date om de tijdstempel op te maken, bijvoorbeeld met {{ order.created_at | date: "%B %e, %Y" }}.
gateways unique_gateways of transactions.<each>.gateway
order_currencyvaluta;
processed_atGebruik de variabele created_at. Deze bevat de waarde order.processed_at uit de GraphQL API en wijst op de werkelijke tijd dat de bestelling is verwerkt, in plaats van het moment dat de bestelling in Shopify is geïmporteerd. Het is hetzelfde als order.processed_at uit de verouderde versie van de Order Printer-app. Je kunt het filter date gebruiken om de tijdstempel op te maken, bijvoorbeeld met {{ order.created_at | date: "%B %e, %Y" }}.
payment_transactions

Filter door order.transactions voor de status soort in de Liquid-syntaxis met where of met lussen en een if erin. Bekijk de volgende voorbeelden.

{% assign sale_transactions = order.transactions | where: "kind", "sale" %} {% assign capture_transactions = order.transactions | where: "kind", "capture" %} {% for transaction in transactions %} {% if transaction.kind == "sale" or transaction.kind == "capture" %} Transactie-ID: {{ transaction.id }} Soort: {{ transaction.kind }} Bedrag: {{ transaction.amount | money }} {% endif %} {% endfor %}

{% assign sale_transactions = order.transactions | where: "kind", "sale" %} {% assign capture_transactions = order.transactions | where: "kind", "capture" %} {% assign payment_transactions = sale_transactions | concat: capture_transactions %}

refund_transactionsFilter door order.transactions voor de status soort in de Liquid-syntaxis met where of met lussen en een if erin, zoals met het volgende voorbeeld.
{% assign refund_transactions = order.transactions | where: "kind", "refund" %}
shipping_lineshipping_methods | eerste
shipping_linesshipping_methods
show_line_item_taxes tax_lines.size > 0. Je kunt deze aan het begin van de template definiëren als een variabele en er meerdere keren naar verwijzen, zoals met het volgende voorbeeld.
{% if tax_lines.size > 0 %} {% assign show_line_item_taxes = true %} {% else %} {% assign show_line_item_taxes = false %} {% endif %}
total_taxtax_price
total_paidnet_payment

Variabelen voor regelitems

Variabele voor LineItem
Variabele in de verouderde versie van de Order Printer-appVariabele in de nieuwe Shopify Order Printer-app
fulfillable_quantityquantity - successfully_fulfilled_quantity
afgehandeldaantal == successfully_fulfilled_quantity
naamtitel
productnaamproduct.title
unit_discounthoeveelheid ? line_level_total_discount / quantity : 0
variant_titlevariant.title
weightgrams

Afhandelingsvariabelen

fulfilmentvariabele
Variabele in de verouderde versie van de Order Printer-appVariabele in de nieuwe Shopify Order Printer-app
datecreated_at

Winkelvariabelen

Shop-variabele
Variabele in de verouderde versie van de Order Printer-appVariabele in de nieuwe Shopify Order Printer-app
eigenaaraccount_owner.name
addressshop.address.address1
adres2shop.address.address2
stadshop.address.city
landshop.address.country
country_codeshop.address.country_code
provincieshop.address.province
province_codeshop.address.province_code
postcodeshop.address.zip

Adresvariabelen

Adresvariabele
Variabele in de verouderde versie van de Order Printer-appVariabele in de nieuwe Shopify Order Printer-app
breedtegraadAls er naar de address-variabele werd verwezen vanuit het location-attribuut, zijn de breedtegraad en lengtegraad beschikbaar op het locatiion-object zelf.
lengtegraadAls er naar de address-variabele werd verwezen vanuit het location-attribuut, zijn de breedtegraad en lengtegraad beschikbaar op het locatiion-object zelf.

Terugbetalingsvariabelen

Terugbetalingsvariabele
Variabele in de verouderde versie van de Order Printer-appVariabele in de nieuwe Shopify Order Printer-app
dateGebruik de variabele created_at. Gebruik het filter date om de tijdstempel op te maken, bijvoorbeeld met {{ order.created_at | date: "%B %e, %Y" }}.

ShippingLine-variabelen

ShippingLine-variabele
Variabele in de verouderde versie van de Order Printer-appVariabele in de nieuwe Shopify Order Printer-app
current_priceprijs
prijsoriginal_price

Transactievariabelen

De volgende transactievariabelen zijn verwijderd en kun je niet vervangen in de Shopify Order Printer-app:

  • authorization
  • message
  • test

Variantvariabelen

variantvariabele
Variabele in de verouderde versie van de Order Printer-appVariabele in de nieuwe Shopify Order Printer-app
gramsweight

Metaveld-variabelen

Voor toegang tot een metaveld geef je de Naamruimte van het metaveld op en hoef je .value niet aan de variabele toe te voegen. Hier vind je meer informatie over metavelddefinities.

Gebruik bijvoorbeeld de variabele product.metafields.manufacturerid.value in plaats van de variabele product.metafields.custom.manufacturerid.

Raadpleeg de pagina Aangepaste gegevens in je Shopify-beheercentrum om naamruimtewaarden voor elk metaveld te identificeren. Metavelddefinities worden gegroepeerd op de objecten die ze gebruiken, zoals producten, varianten of bestellingen.

Filters toewijzen

Filters toewijzen
Filternaam in de verouderde versie van de Order Printer-appFilternaam in de nieuwe Shopify Order Printer-app
files_urlfile_url
payment_method en payment_methods Gebruik het veld transaction.gateway_display_name voor bestellingstransacties. Betaalmethoden worden niet meer ingedeeld in specifieke typen, zoals creditcard, debetkaart, bankoverschrijving. De verouderde versie van de Order Printer-app wees slechts een kleine subset van momenteel werkende betalingsgateways toe voor deze categorieën. Betalingsgatewayproviders houden de soorten betaalmethoden die klanten gebruiken in eigen beheer.
Zat het antwoord dat je zocht er niet bij? Wij helpen je graag verder.