Overstappen van de Order Printer-app naar Shopify Order Printer

Als je aangepaste templates in de verouderde versie van de Order Printer-app hebt, migreer je ze naar de Shopify Order Printer-app.

Importeer je bestaande templates naar de Shopify Order Printer-app om je templates te migreren. De nieuwe Shopify Order Printer-app heeft echter een iets andere implementatie dan de verouderde versie van de Order Printer-app. Dit betekent dat sommige van de bestaande templates in eerste instantie misschien niet werken en dat er mogelijk enkele aanpassingen aan de code van de template nodig zijn.

Vervang de oudere variabelen door de nieuwe zodat de templates in de nieuwe app werken. Als je bijvoorbeeld de variabele date gebruikt, vervang je deze door de variabele created_at.

Op deze pagina vind je een lijst met variabelen waarvoor het mogelijk nodig is om ze te vervangen door nieuwe variabelen in de Shopify Order Printer-app.

Op deze pagina

Aandachtspunten bij het migreren van bestaande templates

Controleer de volgende aandachtspunten voordat je bestaande templates migreert naar de Shopify Order Printer-app:

Het is essentieel dat je bekend bent met HTML, CSS en Liquid om bestaande templates te migreren. Shopify Theme Support kan helpen met kleine aanpassingen binnen het kader van het ontwerpbeleid van Shopify.
Controleer de naslag over Liquid-variabelen en filters voor Shopify Order Printer voor alle ondersteunde templateaanpassingen.
Als je aangepaste CSS gebruikt voor de bestaande templates, draag je de code handmatig over en pas je deze aan in de nieuwe app.
Voeg het bestellingsvoorvoegsel toe om bestellingsvariabelen te gebruiken in de Shopify Order Printer-app.
Wanneer je bestaande templates importeert, worden metavelden niet meegenomen. Mogelijk moet je templates met metavelden handmatig migreren.

Bestaande templates migreren naar de Shopify Order Printer-app

Als je bestaande templates uit de oude Order Printer-app hebt, kun je ze importeren in de Shopify Order Printer-app. Je kunt geen losse templates importeren; je kunt ze alleen allemaal tegelijk importeren.

Stappen:

Ga in het Shopify-beheercentrum naar Instellingen > Apps en verkoopkanalen.
Klik op Order Printer.
Klik op App openen.
Klik op Templates.
Klik op Importeren.
Klik in het dialoogvenster op Importeren.
Controleer of de templates een van de verouderde variabelen gebruikt en vervang ze door de nieuwe variabelen.
Bekijk een voorbeeld van de templates en ga na of deze correct worden weergegeven.
Optioneel: Druk testdocumenten af.

Bestellingsvariabelen gebruiken in de Shopify Order Printer-app

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.

Variabelen toewijzen

De Shopify Order Printer-app gebruikt andere variabelen dan de verouderde versie van de Order Printer-app. Als je voor de bestaande templates een van de variabelen in deze sectie gebruikt, vervang je de oude variabelen door nieuwe.

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

Bestellingsvariabelen

Bestellingsvariabele
Variabele in de verouderde versie van de Order Printer-app	Variabele 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_card`	Gebruik betalingsgegevens op basis van elke transactie uit de bestelling met de variabele `transactions.<each>.payment_details`.
`current_shipping_price`	`shipping_price`
`date`	Gebruik 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_currency`	`valuta;`
`processed_at`	Gebruik 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_transactions`	Filter 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_line`	`shipping_methods \| eerste`
`shipping_lines`	`shipping_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_tax`	`tax_price`
`total_paid`	`net_payment`

Variabelen voor regelitems

Variabele voor LineItem
Variabele in de verouderde versie van de Order Printer-app	Variabele in de nieuwe Shopify Order Printer-app
`fulfillable_quantity`	`quantity - successfully_fulfilled_quantity`
`afgehandeld`	`aantal == successfully_fulfilled_quantity`
`naam`	`titel`
`productnaam`	`product.title`
`unit_discount`	`hoeveelheid ? line_level_total_discount / quantity : 0`
`variant_title`	`variant.title`
`weight`	`grams`

Afhandelingsvariabelen

fulfilmentvariabele
Variabele in de verouderde versie van de Order Printer-app	Variabele in de nieuwe Shopify Order Printer-app
`date`	`created_at`

Winkelvariabelen

Shop-variabele
Variabele in de verouderde versie van de Order Printer-app	Variabele in de nieuwe Shopify Order Printer-app
`eigenaar`	`account_owner.name`
`address`	`shop.address.address1`
`adres2`	`shop.address.address2`
`stad`	`shop.address.city`
`land`	`shop.address.country`
`country_code`	`shop.address.country_code`
`provincie`	`shop.address.province`
`province_code`	`shop.address.province_code`
`postcode`	`shop.address.zip`

Adresvariabelen

Adresvariabele
Variabele in de verouderde versie van de Order Printer-app	Variabele in de nieuwe Shopify Order Printer-app
`breedtegraad`	Als er naar de `address`-variabele werd verwezen vanuit het `location`-attribuut, zijn de breedtegraad en lengtegraad beschikbaar op het `locatiion`-object zelf.
`lengtegraad`	Als 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-app	Variabele in de nieuwe Shopify Order Printer-app
`date`	Gebruik 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-app	Variabele in de nieuwe Shopify Order Printer-app
`current_price`	`prijs`
`prijs`	`original_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-app	Variabele in de nieuwe Shopify Order Printer-app
`grams`	`weight`

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-app	Filternaam in de nieuwe Shopify Order Printer-app
`files_url`	`file_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.