Siirtyminen Order Printer -sovelluksesta Shopify Order Printeriin

Jos sinulla on mukautettuja malleja vanhassa Order Printer ‑sovelluksessa, sinun on siirrettävä mallisi Shopify Order Printer ‑sovellukseen.

Voit siirtää mallit tuomalla nykyiset mallisi Shopify Order Printer ‑sovellukseen Uudella Shopify Order Printer ‑sovellus kuitenkin poikkeaa Order Printer ‑sovelluksesta hieman. Tämä tarkoittaa, että kaikki olemassa olevat mallisi eivät välttämättä toimi aluksi, ja saatat joutua tekemään joitakin muutoksia mallin koodiin.

Jotta mallit toimivat uudessa sovelluksessa, sinun täytyy korvata vanhat muuttujat uusilla muuttujilla. Jos esimerkiksi käytät date-muuttujaa, sinun täytyy korvata se created_at-muuttujalla.

Tältä sivulta löydät luettelon muuttujista, jotka sinun on ehkä korvattava uusilla muuttujilla Shopify Order Printer ‑sovelluksessa.

Tällä sivulla

Huomioitavaa mallien siirtämisessä

Ennen kuin siirrät mallit Shopify Order Printer ‑sovellukseen, tarkista seuraavat seikat:

Mallien siirtäminen edellyttää, että tunnet HTML:n, CSS:n ja Liquidin. Shopify-teematuki voi auttaa Shopifyn suunnittelukäytännönmukaisissa pienissä mukautuksissa.
Tarkista Shopify Order Printerin Liquid-muuttujien ja suodattimien viitteestä kaikki mallien tuetut mukautukset.
Jos olemassa olevissa malleissasi käytetään mukautettua CSS-koodia, sinun on siirrettävä ja mukautettava koodi manuaalisesti uudessa sovelluksessa.
Jotta voit käyttää tilausmuuttujia Shopify Order Printer ‑sovelluksessa, sinun on lisättävä tilauksen etuliite.
Metakentillä on tärkeä rooli olemassa olevien mallien tuonnissa. Saatat joutua siirtämään metakenttiä sisältävät mallit manuaalisesti.

Mallien siirtäminen Shopify Order Printer ‑sovellukseen

Jos sinulla on jo malleja vanhasta Order Printer -sovelluksesta, voit tuoda ne Shopify Order Printer -sovellukseen. Et voi tuoda valittuja malleja. Voit tuoda vain kaikki mallisi kerralla.

Vaiheet:

Klikkaa Shopify adminissa Asetukset > Sovellukset ja myyntikanavat.
Klikkaa Order Printer.
Klikkaa Avaa sovellus.
Klikkaa Mallit.
Klikkaa Tuo.
Klikkaa valintaikkunassa Tuo.
Tarkista, käyttääkö mallisi jotain vanhoista muuttujista, ja korvaa ne sitten uusilla muuttujilla.
Esikatsele malleja ja varmista, että mallit näkyvät oikein.
Valinnainen: Tulosta testiasiakirjoja.

Tilausmuuttujien käyttäminen Shopify Order Printer ‑sovelluksessa

Tilausmuuttujia käytetään Shopify Order Printer ‑sovelluksessa eri tavalla. Jotta voit käyttää tilausmuuttujia, sinun on lisättävä order.-etuliite. Jos haluat esimerkiksi käyttää billing_address-muuttujaa, sinun on käytettävä koodia order.billing_address.

Seuraavat yleisesti käytetyt tilausten muuttujat ovat käytettävissä ilman order.-etuliitettä:

line_items
tax_lines
fulfillments
transactions
refunds
shipping_methods
customer

Jos esimerkiksi haluat käyttää rivikohtien muuttujaa, voit käyttää line_items- tai order.line_items-koodia.

Voit myös luoda mallin omia aliaksia. Voit esimerkiksi käyttää Liquid-syntaksia {% assign fulfillments_count = order.fulfillments | size %} ja viitata siihen käyttämällä koodissasi syntaksia {{ fulfillments_count }}.

Muuttujien kartta

Shopify Order Printer ‑sovellus käyttää vanhasta Order Printer ‑sovelluksesta poikkeavia muuttujia. Jos olemassa olevissa malleissa käytetään mitä tahansa tässä osiossa lueteltuja muuttujia, sinun on korvattava vanhat muuttujat uusilla muuttujilla.

Jos esimerkiksi käytät date-muuttujaa, sinun täytyy korvata se created_at-muuttujalla.

Tilauksen muuttujat

Tilauksen muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa	Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
`line_items`	Hyvitettyjä rivikohtia ei sisällytetä `line_items`-muuttujaan. Tarkista seuraavat tiedot: Voit käyttää hyvitettyjä rivikohtia `refunds.<each>.refund_line_items` -muuttujan avulla. Katso seuraava esimerkki. `{% assign refunded_line_items = refunds \| map: "refund_line_items" \| map: "line_item" %}` Voit halutessasi liittää hyvitetyt rivikohdat `line_items`-kokoelmaan. Katso seuraava esimerkki. `{% 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 %}` Muista sisällyttää `\| uniq` -suodatin välttääksesi kopion luonnin hyvitetyistä rivikohdista. Tippauksen rivikohtia ei sisällytetä `line_items`-muuttujaan. Tarkista seuraavat tiedot: Voit käyttää tippauksen rivikohtia `tip_line_items`-muuttujan avulla. Voit halutessasi liittää `tip_line_items`-muuttujan `line_items`-kokoelmaan. Katso seuraava esimerkki. `{% assign line_items_with_tips = order.line_items \| concat: order.tip_line_items %}` Jos haluat jäljitellä vanhaa Order Printer `line_items` -kokoelmaa, voit käyttää seuraavaa esimerkkikoodia. `{% 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`	Käytä tilauksen kuhunkin tapahtumaan perustuvia maksutietoja `transactions.<each>.payment_details` -muuttujan avulla.
`current_shipping_price`	`shipping_price`
`päivämäärä`	Käytä `created_at`-muuttujaa. Muotoile aikaleima `date`-suodattimella, esimerkiksi `{{ order.created_at \| date: "%B %e, %Y" }}`.
`portaalit`	`unique_gateways` tai `transactions.<each>.gateway`
`order_currency`	`valuutta`
`processed_at`	Käytä `created_at`-muuttujaa. Sillä on arvo `order.processed_at` GraphQL API:stä, ja se tarkoittaa todellista ajankohtaa, jolloin tilausta käsitellään, eikä ajankohtaa, jolloin tilaus tuodaan Shopifyhin. Se on sama kuin `order.processed_at` vanhassa Order Printer -sovelluksessa. Voit muotoilla aikaleiman `date`-suodattimella, esimerkiksi `{{ order.created_at \| date: "%B %e, %Y" }}`.
`payment_transactions`	Suodata kohdan `order.transactions` läpi where-Liquid-syntaksin `tyyppi`-tilan hakemiseksi tai `if`-syntaksin sisältävän silmukan hakemiseksi. Katso seuraavat esimerkit. `{% 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" %} Tapahtumatunnus: {{ transaction.id }} Tyyppi: {{ transaction.kind }} Määrä: {{ 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`	Suodata kohdan `order.transactions` läpi where-Liquid-syntaksin `tyyppi`-tilan hakemiseksi tai `if`-syntaksin sisältävän silmukan hakemiseksi seuraavan esimerkin mukaisesti. `{% assign refund_transactions = order.transactions \| where: "kind", "refund" %}`
`shipping_lines`	`shipping_methods \| first`
`shipping_lines`	`shipping_methods`
`show_line_item_taxes`	`tax_lines.size > 0`. Voit määrittää sen mallin alussa muuttujaksi ja viitata siihen useaan kertaan, kuten seuraavassa esimerkissä. `{% 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`

LineItem-muuttujat

Lineitem-muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa	Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
`fulfillable_quantity`	`quantity - successfully_fulfilled_quantity`
`jaeltu`	`quantity == successfully_fulfilled_quantity`
`nimi`	`otsikko`
`product_title`	`product.title`
`unit_discount`	`quantity ? line_level_total_discount / quantity : 0`
`variant_title`	`variant.title`
`weight`	`grammat`

Tilauksen käsittelyyn sen saamisesta asiakkaalle toimittamiseen liittyvät muuttujat

tilauksen täyttämisen muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa	Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
`päivämäärä`	`created_at`

Kauppaan liittyvät muuttujat

Shop-muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa	Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
`omistaja`	`account_owner.name`
`osoite`	`shop.address.address1`
`address2`	`shop.address.address2`
`city`	`shop.address.city`
`maa`	`shop.address.country`
`country_code`	`shop.address.country_code`
`province`	`shop.address.province`
`province_code`	`shop.address.province_code`
`postinumero`	`shop.address.zip`

Osoitemuuttujat

Osoitemuuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa	Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
`leveysaste`	Jos muuttujaan `address` viitataan `location`-määritteessä, leveys- ja pituusaste ovat käytettävissä suoraan `location`-objektissa.
`pituusaste`	Jos muuttujaan `address` viitataan `location`-määritteessä, leveys- ja pituusaste ovat käytettävissä suoraan `location`-objektissa.

Maksun palauttamiseen liittyvät muuttujat

Hyvitykseen liittyvä muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa	Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
`päivämäärä`	Käytä `created_at`-muuttujaa. Muotoile aikaleima `date`-suodattimella, esimerkiksi `{{ order.created_at \| date: "%B %e, %Y" }}`.

ShippingLine-muuttujat

ShippingLine-muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa	Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
`current_price`	`hinta`
`hinta`	`original_price`

Tapahtumamuuttujat

Seuraavat tapahtumamuuttujat on poistettu, eikä niitä voi korvata Shopify Order Printer ‑sovelluksessa:

authorization
message
test

Versioiden muuttujat

version muuttuja
Muuttuja vanhassa Order Printer ‑sovelluksessa	Muuttuja uudessa Shopify Order Printer ‑sovelluksessa
`grammat`	`weight`

Metakenttämuuttujat

Jotta voit käyttää metakenttää, sinun on määritettävä metakentän Nimiavaruus, mutta sinun ei tarvitse lisätä .value-arvoa muuttujaan. Lisätietoja metakenttämääritelmistä.

Käytä product.metafields.manufacturerid.value-muuttujan sijaan esimerkiksi product.metafields.custom.manufacturerid -muuttujaa.

Jos haluat tunnistaa kunkin metakentän Nimiavaruuden arvot, katso Shopify Adminin Mukautetut tiedot -sivua. Metakenttämääritelmät ryhmitellään niiden objektien mukaan, joihin ne viittaavat, kuten tuotteet, versiot tai tilaukset.

Suodatinten kartta

Suodatinten kartta
Suodattimen nimi vanhassa Order Printer -sovelluksessa	Suodattimen nimi uudessa Shopify Order Printer -sovelluksessa
`files_url`	`file_url`
`payment_method` ja `payment_methods`	Käytä transaction.gateway_display_name ‑kenttää tilaustapahtumille. Maksutapoja ei enää luokitella eri tyyppeihin, kuten `{luottokortti, maksukortti, pankkisiirto}`. Vanha Order Printer ‑sovellus kartoitti vain pienen alajoukon tällä hetkellä toimivia maksuportaaleja näihin luokkiin. Maksuportaalien tarjoajien on hallinnoitava asiakkaiden käyttämiä maksutapoja omalta puoleltaan.