Kodeeditor til udskrevne kvitteringer til din Shopify POS

Du kan tilpasse dine udskrevne kvitteringer ved hjælp af kodeeditoren i din Shopify-administrator. Filerne, som dine kvitteringer består af, indeholder Liquid, der er Shopifys skabelonsprog. Med kodeeditoren kan du oprette mere avancerede tilpasninger ved hjælp af HTML, CSS og Liquid, end du kan med den visuelle editor.

Du kan ændre kvitteringsskabelonen og de sektionsskabeloner, der bruges på dine udskrevne kvitteringer. Skabelonfilerne under Kvitteringer er de typer af kvitteringer, du kan udskrive i din butik. Sektioner er dele af kvitteringerne, f.eks. sidehovedet eller sidefoden. Sektioner kan genbruges på flere kvitteringer.

Overvejelser i forbindelse med brug af kodeeditoren til kvitteringer

Før du bruger kodeeditoren til kvitteringer, skal du gennemgå følgende overvejelser:

Adgangsbegrænsninger

• Du kan kun bruge kodeeditoren fra din Shopify-administrator på en computer.
• Kodeeditoren er ikke tilgængelig for nogen POS-lokationer i Italien.

Hvor ændringerne gælder

• Kodeændringer, du foretager, gælder kun for den valgte lokation.
• Tilpasninger i kodeeditoren gælder kun for POS Pro-lokationer. Hvis du bruger kodeeditoren og har lokationer uden POS Pro, kan du bruge den visuelle editor til at tilpasse sidehoved og sidefod for disse lokationer.
• Du kan tilpasse printede kvitteringer, der har en skabelon i kodeeditoren, f.eks. salgskvitteringer, gavekvitteringer, gavekortkvitteringer og kvitteringer for returneringer og ombytninger.

Kodesprog

• Filerne, som dine kvitteringer består af, indeholder Liquid, der er Shopifys skabelonsprog. Få mere at vide om at bruge Liquid.
• Hvis du vil redigere skabelonerne i kodeeditoren til kvitteringer, skal du have kendskab til HTML, CSS og Liquid. Shopify Tema-support kan hjælpe med mindre justeringer inden for rammerne af Shopifys designpolitik.

Begrænsninger for tilpasning

• Du kan ikke forhåndsvise kvitteringer i forskellige printerstørrelser fra kodeeditoren. Brug det visuelle redigeringsværktøj til at forhåndsvise efter printerstørrelse.
• Produktbeskrivelser er ikke tilgængelige som variabel i kvitteringsskabeloner og kan ikke føjes til udskrevne kvitteringer.

Vedligeholdelse af skabelon

• Hvis du tilpasser en kvittering i editoren til kvitteringskode, mangler den eksisterende skabelon muligvis nye egenskaber som f.eks. selling_plan_name. Hvis du vil føje de nyeste tilgængelige egenskaber til skabelonen, skal du nulstille kvitteringsskabelonen til standard. Hvis du nulstiller kvitteringsskabeloner til standarden, fjernes alle tilpasninger, du har foretaget af dem. Gem en kopi af den tilpassede kode, før du nulstiller. Efter nulstilling af skabelonen skal du genanvende dine tilpasninger manuelt.

Få adgang til kodeeditoren

Du kan redigere dine skabeloner ved hjælp af kodeeditoren. Du skal først skifte til at bruge kodeeditoren fra den visuelle standardeditor, og du kan til enhver tid skifte tilbage til den visuelle editor.

Trinene til at skifte mellem editorerne varierer lidt, afhængigt af om alle dine POS-lokationer er kvalificerede til kodeeditoren, eller om kun nogle af dine POS-lokationer er kvalificerede. Dette kan f.eks. være tilfældet, hvis nogle af dine POS-lokationer ikke bruger POS Pro eller er beliggende i Italien eller Frankrig.

Fremgangsmåde:

Brug tilpassede filer i din kvitteringsskabelon

Du kan bruge filer, f.eks. billedfiler, som du uploader til din Shopify-administrator, til at tilpasse dine printede kvitteringer.

En fil skal uploades til din Shopify-administrator, før den kan bruges i en udskrevet kvittering. Få mere at vide om filuploads.

Fremgangsmåde:

1. Gå til Indhold > Filer i din Shopify-administrator.

2. Klik på ud for den fil, du vil inkludere i koden til din printede kvittering, for at kopiere linket.

3. Gå til kodeeditoren.

4. Inkluder linket til filen i din skabelon.

Nulstil din kvitteringsskabelon til standard

Du kan nulstille en kvitteringsskabelon til standardversionen ved hjælp af kodeeditoren.

Fremgangsmåde:

Liquid-variabler, der er tilgængelige i kodeeditoren til kvitteringer

Du kan bruge Liquid til at tilpasse din skabelon til udskrevne kvitteringer og dine kvitteringstyper.

Følgende dataobjekter er tilgængelige for kodeeditoren til kvitteringer:

Kvitteringsobjekter

shop

location

order

return

gift_card

Ordreobjekt

id

created_at

source_identifier

change_due

balance_due

name

note

line_items

subtotal_price

total_price

total_tip_received

discounts

transactions

taxes_included

tax_lines

customer

shipping_address

shipping_groups

Returneringsobjekt

name

created_at

is_unverified

is_exchange

exchange_type

return_discount

return_subtotal

return_total

exchange_subtotal

exchange_total

total_cash_rounding_adjustment

total_adjusted_amount

net_total

return_line_items

exchange_line_items

return_tax_lines

exchange_tax_lines

shipping_refund_amount

tip_refund_amount

transactions

Forsendelsesgruppeobjekt

destination

products

Varelinjeobjekt

id

name

variant_title

price

is_gift_card

discount

total_price

selling_plan_name

tax_rates

custom_attributes

variant_title

variant_id

variant_metafields

staff_member_description

product_metafields

Objekt for varelinje for returnering

Indeholder alt i varelinjeobjektet samt følgende egenskaber:

return_reason

return_reason_note

Liquid-filtre, der er tilgængelige i kodeeditoren til kvitteringer

Du kan bruge Liquid-filtre til at justere oplysninger i dine kvitteringsskabeloner. Du kan f.eks. ændre formateringen af valuta eller brugen af store og små bogstaver i specifik tekst, f.eks. en afgiftskode.

Du anvender et filter ved at tilføje et pipe-tegn | og derefter filteret i den blok af Liquid-kode, der er mellem dobbelte krøllede parenteser {{ }}. Filtre kan kun anvendes på blokke af Liquid-kode.

I det følgende eksempel justerer filteret afgiftskoden fra små til store bogstaver.

{{ tax_line.title | upcase }}

I kodeblokken i eksemplet er product objektet, title er dets egenskab, og upcase er det anvendte filter. Filteret upcase ændrer værdien for tax_line.title til store bogstaver. Hvis f.eks. tax_line.title har værdien Hst, så ændrer filteret upcase værdien til HST.

Se afsnittet Filtre i Shopify Themes Liquid-referencen for at få oplysninger om, hvordan du bruger Liquid-filtre.

Følgende filtre er tilgængelige i kodeeditoren til kvitteringer:

t

money

escape

barcode

qrcode

Eksempel på tilpasning af kode i skabelonen til udskrevne kvitteringer

Du kan bruge Liquid til at tilføje betingede meddelelser. Denne funktion svarer til at gemme på en enkelt lokation med den visuelle editor. Din virksomhed startede f.eks. med en enkelt lokation, og nu har du flere nye lokationer. Du vil gerne fremhæve din oprindelige butik på dine udskrevne kvitteringer.

Du kan tilføje en tilpasset meddelelse til skabelonen header.liquid i mappen Afsnit i kodeeditoren og bruge Liquid til kun at vise meddelelsen for din primære lokation.

Følgende kode tjekker navnet på lokationen, i dette tilfælde din oprindelige lokation med navnet “Home”, og viser meddelelsen “Velkommen til vores oprindelige butik, åbnet i 1972.”, hvis lokationen matcher navnet. Kvitteringer, der udskrives fra dine andre lokationer, viser i stedet meddelelsen “Velkommen til vores butik.”.

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}

Se forhåndsvisning af dine kodeændringer i kodeeditoren

Du kan se en forhåndsvisning af ændringerne af dine udskrevne kvitteringer i POS-kodeeditoren i Shopify-administratoren.

Afhængigt af hvilken Liquid-fil der er valgt, fremhæver forhåndsvisningsvinduet designet eller afsnittet på den kvittering, der er påvirket af filen. Som standard viser forhåndsvisningsvinduet indholdet for din seneste POS-ordre. Du kan vælge en bestemt ordre, som skal bruges som kvitteringsindhold i forhåndsvisningsvinduet for alle Liquid-filer undtagen filen gift-card.liquid, som kun viser de forskellige lokationer som valgbare forhåndsvisningsmuligheder.

Fremgangsmåde: