Reference til notifikationsvariabler
Meddelelser, der sendes fra din butik, gengives via Liquid. Liquid er Shopifys enkle og brugervenlige programmeringssprog. Det er det samme programmeringssprog, som temaerne fra Temabutikken er baseret på.
Hvis du vil redigere meddelelserne, der sendes fra din butik, kan du foretage grundlæggende tilpasninger af dine skabeloner til meddelelser.
Du kan få hjælp til mere avancerede ændringer eller til at ændre tilpassede skabeloner til meddelelser ved at kontakte fællesskabet i vores forummer, eller du kan få en Shopify-ekspert til at foretage dine tilpasninger for dig.
Her er en liste med skabeloner til meddelelser til Liquid, som du kan tilpasse i din Shopify-administrator:
- Forladt betaling
- Kontakt kunden
- Invitation til kundekonto
- Velkomst til kundekonto
- Nulstilling af adgangskode til kundekonto
- Faktura for ordrekladde
- Anmodning om behandling
- Gavekort er oprettet
- Ny ordre
- Ny ordre (mobil)
- Ordre annulleret
- Ordrebekræftelse
- POS- og mobilkvittering
- Tilbagebetaling af ordre
- Leveringsbekræftelse
- Opdatering vedrørende levering
Alle skabeloner i Shopify-administratoren har adgang til egenskaberne for deres tilsvarende ordre.
Ordreegenskaber
Mange af egenskaberne for en ordre er tilgængelige direkte via Liquid, i skabeloner og i yderligere scripts.
En ordres egenskaber er tilgængelig i følgende skabeloner:
- Ordrebekræftelse
- Ny ordre
- Ny ordre (mobil)
- Leveringsbekræftelse
- Opdatering vedrørende levering
- Yderligere scripts
- Anmodning om behandling
Bemærk: I modsætning til de fleste andre Liquid-objekter refereres der ikke til ordreobjektets navn i e-mailskabeloner. Dette betyder, at du i stedet for at bruge
{{ order.shipping_method.title }}
i f.eks. din mailskabelon til ordrebekræftelse kan bruge{{ shipping_method.title }}
. I forbindelse med sms-beskeder skal ordreegenskaber dog have en foranstilletorder
som sædvanligt.
Egenskab | Beskrivelse |
---|---|
id |
Et entydigt id for ordren til intern brug, og som anvendes i hele systemet. Brug følgende eksempel til at oprette et link til ordren i administratorafsnittet i din butik. I skabelonen Ny ordre kan du f.eks. tilføje følgende kode: <a href="{{ shop.url }}/admin/orders/{{ id }}">View order</a> |
E-mailen, der er knyttet til denne ordre. | |
name |
Dette er almindeligvis et pund-symbol efterfulgt af Eksempel: #1004 |
order_name |
Samme som navn. |
order_number |
Butiksunikt nummer for ordren uden præfikset med antal pund eller noget præfiks eller suffiks, der føjes til ordre-id'et af butiksejeren i dennes butikspræferencer. Eksempel: 1004 |
created_at |
Datoen og klokkeslættet, hvor kunden oprettede ordren. Du kan formatere dette ved hjælp af datofilteret. Eksempel: 2009-05-30T17:43:51+02:00 |
tags | Returnerer en matrix af alle ordrens tags. Tags returneres i alfabetisk rækkefølge. Du kan få flere oplysninger i Referencedokumentationen til Liquid. |
transactions | Returnerer en matrix af transaktioner fra ordren. |
tax_price |
De kombinerede skatter for alle varer i ordren. |
tax_lines |
Skatter, som opdeles efter beskatningstype:
|
tax_line.title |
Navnet på skatten. Eksempler: QST eller moms |
tax_line.price |
Beløbet. |
tax_line.rate |
Procenten. Der returneres 0,175, hvis det er 17,5 %. |
tax_line.rate_percentage |
Skatteprocenten i læselig form. Der returneres 17,5, hvis procenten er 0,175. |
customer |
Kundeobjekt, der indeholder attributterne for kundens output. |
billing_address |
Faktureringsadressen. |
billing_address.first_name |
Kundens fornavn. |
billing_address.last_name |
Kundens efternavn. |
billing_address.company |
Firmanavn til fakturering. |
billing_address.phone |
Telefonnummeret fra faktureringsadressen. |
shop.name |
Navnet på din butik. |
shop.phone |
Din butiks telefonnummer. |
subtotal_price |
Summen af ordrens varelinjepriser, efter en eventuel varelinjerabat eller rabat på indkøbskurven er fratrukket. Subtotalen omfatter ikke skatter (medmindre skatter er inkluderet i priserne), leveringsomkostninger eller drikkepenge. |
discounts |
En liste med rabatter. |
discounts_amount |
Rabatbeløbet for alle rabatter. Eksempel: +5,00 USD |
discounts_savings |
Størrelsen af besparelserne, der er resultatet af alle rabatter. Eksempel: -5,00 USD |
total_price |
Ordren i alt (subtotal + leveringsomkostninger – leveringsrabat + skat). |
financial_status |
Den aktuelle betalingsstatus. En af følgende: nil, pending , authorized , paid , voided , refunded . |
requires_shipping |
(boolesk) Returnerer sand, hvis mindst én vare i ordren kræver levering. |
shipping_method.title |
Navnet på leveringsprisen. Eksempel: Standardlevering |
shipping_method.price |
Leveringsprisen, inklusive eventuel leveringsrabat. Eksempel: |
shipping_price |
Leveringsprisen. Eksempel: |
shipping_address |
Leveringsadressen. |
shipping_address.first_name |
Fornavn for leveringsadressen. |
shipping_address.company |
Firmanavn for leveringsadressen. |
shipping_address.phone |
Telefonnummer fra leveringsadressen. |
line_items |
Liste med alle Varelinjer i ordren. |
item_count |
Sum af alle mængder af varen. |
fulfillment_status |
Ordrens aktuelle behandlingsstatus. En af følgende: unfulfilled , partial , fulfilled . |
note |
Bemærkningen, der er knyttet til ordren. Bemærkningen kan hentes fra kunden og/eller redigeres på siden med ordreoplysninger i din administratorgrænseflade. |
attributes |
Eventuelle attributter , som er knyttet til ordren. Eksempel: |
referring_site |
Indeholder webadressen for henviseren, der førte kunden til din butik. Eksempel: |
landing_site |
Indeholder stien til det landingssted, som kunden brugte. Dette er den første side, som kunden så, da vedkommende kom til butikken. Eksempel: |
landing_site_ref |
Ser på landingsstedet og udtrækker en referenceparameter fra det. Referenceparametre kan være: Hvis {% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %} |
cancelled |
(boolesk) Returnerer sand, hvis ordren er blevet annulleret. |
cancelled_at |
Tidspunktet, hvor ordren blev annulleret. |
cancel_reason |
Den årsag, der blev valgt ved annullering af ordren. En af følgende: inventory , customer , declined , fraud eller other . |
has_high_risks? |
Returnerer sand, hvis ordren har høj risiko |
translate="no"unique_gateways |
Returnerer en liste med unikke betalingsudbydere for en ordre. Hvis nogen f.eks. har betalt med Visa, MasterCard og kontanter, vil den returnerede liste være |
location (POS only) |
Viser ordrens fysiske placering. Der er flere tilgængelige lokationsegenskaber, som vises her. Du kan konfigurere lokationer i området Lokationer i administratoren. |
order_status_url |
Returnerer linket til ordrestatussiden for denne ordre. |
|
Liste med Varelinjer, der er behandlet. |
|
Liste med Varelinjer, der ikke er behandlet fuldt ud. |
Egenskaber for ordrekladde
Ordrekladdens egenskaber er tilgængelige i mailskabelonen til Faktura for ordrekladde, som giver dine kunder besked om udestående fakturaer.
Bemærk: Du kan ikke sende meddelelser om ordrekladder via sms.
Egenskab | Beskrivelse |
---|---|
id |
Et entydigt id for ordrekladden til intern brug. |
invoice_url |
Et link, som kunden kan følge for at betale fakturaen ved hjælp af sikker betaling i Shopify. |
reserve_inventory_until |
Dato og klokkeslæt, som kladdens varelinjer er reserveret frem til, f.eks. Du kan formatere datoer ved hjælp af Liquid-datofilteret. |
user |
Den sidste medarbejder, der ændrede ordrekladden. |
user.name |
Navnet på den sidste medarbejder, der ændrede ordrekladden. |
user.email |
Mailadressen til den sidste medarbejder, der ændrede ordrekladden. |
Mailadressen, der er knyttet til ordrekladden. | |
name |
Den unikke number i ordrekladden med et foranstillet nummertegn# . |
number |
Det unikke nummer for ordrekladden uden ordrepræfiks eller -suffiks. |
created_at |
Datoen og klokkeslættet, hvor kunden oprettede ordrekladden, f.eks. Du kan formatere datoer ved hjælp af Liquid-datofilteret. |
tags | Returnerer en matrix af alle ordrens tags. Tags returneres i alfabetisk rækkefølge. Du kan få flere oplysninger i Referencedokumentationen til Liquid. |
tax_price |
De kombinerede skatter for alle varer i ordrekladden. |
tax_lines |
Skatter, som opdeles efter skattetype: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %} |
tax_line.title |
Navnet på skatten. Eksempler: QST eller moms |
tax_line.price |
Skattebeløbet. |
tax_line.rate |
Skatteprocenten i decimalform. En skatteprocent på 17,5 % vil f.eks. returnere 0,175 . |
tax_line.rate_percentage |
Skatteprocenten i procentform. En procent på 0,175 vil f.eks. returnere 17,5 . |
customer |
Kundeobjekt, der indeholder attributterne for kundens output. |
billing_address |
Faktureringsadressen for ordrekladden. |
billing_address.first_name |
Kundens fornavn. |
billing_address.last_name |
Kundens efternavn. |
billing_address.company |
Firmanavnet i faktureringsadressen. |
billing_address.phone |
Telefonnummeret i faktureringsadressen. |
shop.name |
Navnet på din butik. |
shop.phone |
Din butiks telefonnummer. |
subtotal_price |
Summen af ordrekladdens varelinjepriser, efter en eventuel varelinjerabat eller rabat på indkøbskurven er fratrukket. Subtotalen omfatter ikke skatter (medmindre skatter er inkluderet i priserne) eller leveringsomkostninger. |
discounts |
En liste med rabatter. |
discounts_amount |
Rabatbeløbet for alle rabatter. Eksempel: +5,00 USD |
discounts_savings |
Størrelsen af besparelserne, der er resultatet af alle rabatter. Eksempel: -5,00 USD |
total_price |
Den samlede pris for ordren (subtotal + leveringsomkostninger – leveringsrabat + skat). |
requires_shipping |
Returnerer true , hvis der er mindst én vare i ordrekladden, som kræver levering. Returnerer false , hvis ingen varer i ordrekladden kræver levering. |
shipping_method.title |
Navnet på leveringsprisen. Eksempel: Standardlevering |
shipping_method.price |
Prisen på leveringsmetoden. Returnerer de samme oplysninger som shipping_price . |
shipping_price |
Leveringsprisen. Du kan formatere dette beløb ved hjælp af Liquid-pengefiltrene. |
shipping_address |
Bemærk: I modsætning til almindelige ordrer kan leveringsadressen for en ordrekladde være ufuldstændig. |
shipping_address.first_name |
Fornavn for leveringsadressen. |
shipping_address.company |
Firmanavnet i leveringsadressen. |
shipping_address.phone |
Telefonnummeret i leveringsadressen. |
line_items |
En liste med alle varelinjer i ordrekladden. |
item_count |
Summen af alle mængder af varen i ordrekladden. |
note |
Bemærkningen, der er knyttet til ordrekladden. Bemærkningen kan hentes fra kunden, og kan også redigeres på siden med ordrekladdeoplysninger i din Shopify-administrator. |
location |
Ordrens fysiske placering. Der er flere tilgængelige lokationsegenskaber. Du kan konfigurere lokationer på siden Lokationer i din Shopify-administrator. |
Varelinjeegenskaber
Hver line
på listen med line_items
eller subtotal_line_items
har følgende egenskaber.
Drikkepenge:
subtotal_line_items
returnerer de varelinjer, der bruges til at beregne subtotal_price for en ordre.subtotal_line_items
ekskluderer varelinjerne for drikkepenge.
Egenskab | Beskrivelse |
---|---|
|
Liste med rabatter, der er anvendt på denne vare (alle rabatter har egenskaberne titel , kode , beløb , besparelser og type ). |
|
(Boolesk) Returnerer sand, hvis varen er en tilpasset varelinje for en ordrekladde. |
line.grams |
Vægten for en enkelt vare. |
line.image |
Returnerer webadressen for det billede, der er knyttet til denne varelinje. Du kan også bruge img_url filter til at få specifikke billedstørrelser, som f.eks. {{ line.image | img_url: 'small' }}
|
line.line_price |
Prisen ganget med antallet af den pågældende vare. |
line.original_line_price |
Den samlede pris for det antal varer, der er inkluderet i linjen, før der blev anvendt rabatter. |
line.final_line_price |
Den samlede pris for alle varer i varelinjen, herunder alle rabatbeløb på linjeniveau. |
line.price |
Prisen for en enkelt vare. |
line.product.title |
Navnet på produktet. |
line.product.vendor |
Forhandler af varen. |
line.properties |
Returnerer en matrix af tilpassede oplysninger for en vare. Egenskaber for varelinjer angives af kunden på produktsiden, før der lægges et produkt i indkøbskurven. |
line.quantity |
Antal af den pågældende vare. |
line.requires_shipping |
(Boolesk) Returnerer sand, hvis varianten for varen har afkrydsningsfeltet Dette er et fysisk produkt markeret på produktsiden. |
line.selling_plan_allocation |
Returnerer et selling_plan_allocation -objekt, der beskriver, hvordan en salgsplan, som f.eks. et abonnement påvirker varelinjen. |
line.taxable |
(Boolesk) Returnerer sand, hvis varianten for varen har afkrydsningsfeltet "Opkræv skatter for dette produkt" markeret på produktsiden. |
line.title |
Navnet på produktet efterfulgt af en bindestreg efterfulgt af navnet på varianten. Navnet på varianten er ikke inkluderet, når det er "standardtitel". |
line.url |
Den relative webadresse for varelinjens variant. Den relative webadresse indeholder ikke din butiks rodwebadresse (mystore.myshopify.com ). |
line.variant.barcode |
Den stregkode, som er knyttet til produktvarianten. |
line.variant.compare_at_price |
Den sammenligningspris, der er knyttet til produktvarianten. |
line.variant.image |
Billedet til produktvarianten. Returnerer kun et billede, hvis varianten er tildelt et bestemt billede på varelinjen. |
line.variant.sku |
Den SKU, der er knyttet til produktvarianten. |
line.variant.title |
Værdierne for variantens valgmuligheder forbundet med Eksempel: lille/rød |
Egenskaber for tilbagebetaling
Disse yderligere egenskaber er tilgængelige i mailskabelonen Tilbagebetalinger. Denne mailskabelon bruges til at give dine kunder besked om, at der er anvendt tilbagebetaling (helt eller delvist) til deres ordre. Du kan bruge alle tilgængelige variabler til skabelonen Ordremail ud over følgende variabler:
Egenskab | Beskrivelse |
---|---|
amount |
Det tilbagebetalte beløb. |
refund_line_items |
En liste med tilbagebetalingsvarelinjer, der skal tilbagebetales. |
Egenskaber for Refund_line_item
Alle refund_line
på listen refund_line_items
har følgende egenskaber:
Egenskab | Beskrivelse |
---|---|
refund_line.line_item |
Den line_item, der tilbagebetales. Dette giver adgang til alle egenskaber for line_items. |
refund_line.quantity |
Antallet af varelinjer, der skal tilbagebetales. |
Egenskaber for behandling
Disse yderligere egenskaber er mailskabelonerne Leveringsbekræftelse, Opdatering vedrørende levering og Behandlingsanmodning.
Leveringsbekræftelse og Opdatering vedrørende levering bruges til at give dine kunder besked om, at nogle af eller alle varer i deres ordre er blevet behandlet, eller at de er opdateret med nye leveringsoplysninger.
Mailskabelonen Anmod om behandling bruges til alle tilpassede distributionstjenester, som er defineret i din butiksadministrator. Hvis du vil tilføje en tilpasset distributionstjeneste, skal du gå til Indstillinger > Levering, og rul ned til Behandling/dropshipping.
Egenskab | Beskrivelse |
---|---|
service_name |
Navnet på den tilpassede tjeneste, som er defineret i Indstillinger > Levering side. (Kun behandlingsanmodning) |
fulfillment.estimated_delivery_at |
En forventet leveringsdato baseret på det trackingnummer (hvis det er tilgængeligt), som leveres af ét af følgende transportfirmaer: USPS, FedEx, UPS, Canada Post (kun i Canada). Denne egenskab er kun tilgængelig, når der anvendespriser beregnet af transportfirma. |
fulfillment.fulfillment_line_items |
En liste med behandlingsvarelinjer, der skal behandles. |
fulfillment.item_count |
Summen af alle varer. Det samlede antal varer, der er blevet behandlet. |
fulfillment.requires_shipping |
(boolesk) Returnerer sand, hvis denne behandlingsanmodning kræver levering. |
fulfillment.tracking_company |
Firmaet, der foretager sporingen. |
fulfillment.tracking_numbers |
En liste med trackingnumre. |
fulfillment.tracking_urls |
En liste med webadresser til sporing. |
|
En liste med varelinjer, som skal behandles af denne specifikke tilpassede distributionstjeneste. (Kun behandlingsanmodning) |
|
Det samlede antal varer, som denne anmodning skal behandle. (Kun behandlingsanmodning) |
Egenskaber for Fulfillment_line_item
Hver fulfillment_line
på listen med fulfillment_line_items
har følgende egenskaber.
Egenskab | Beskrivelse |
---|---|
fulfillment_line.line_item |
Den line_item, der behandles. Dette giver adgang til alle egenskaber for line_item. |
fulfillment_line.quantity |
Antallet fra varelinjen, der behandles. |
Leveringsegenskaber
Egenskab | Beskrivelse |
---|---|
delivery_instructions |
Lokale leveringsoplysninger, som du kan dele med kunden. Disse oplysninger styres af feltet Leveringsoplysninger i dine lokale leveringsindstillinger. |
Rabategenskaber
Der er to typer af rabategenskaber.
discount_applications
beskriver, hvorfor og hvordan der blev givet rabat på en vare.
discount_allocations
beskriver, hvordan en bestemt rabat påvirker en varelinje, og hvordan den nedsætter prisen. Du skal bruge denne egenskab på varelinjeniveau.
Du kan kombinere disse egenskaber for at få vist rabatoplysninger på varelinje- eller ordreniveau.
Eksempel
I dette eksempel kontrolleres det, om en rabat er blevet anvendt på varelinjen. Hvis rabatten ikke blev anvendt på ordreniveau (all
), vises rabatnavnet og -beløbet.
{% if line.discount_allocations %}
{% for discount_allocation in line.discount_allocations %}
{% if discount_allocation.discount_application.target_selection != 'all' %}
{{ discount_allocation.discount_application.title | upcase }}
(-{{ discount_allocation.amount | money }})
{% endif %}
{% endfor %}
{% endif %}
Resultatet kan se nogenlunde sådan ud:
SPRING5 (-$5.00)
Discount_allocation-egenskaber
Hver discount_allocation
på listen med discount_allocations
har følgende egenskaber.
Egenskab | Beskrivelse |
---|---|
discount_allocation.amount |
Det pengebeløb, som kunden har sparet på en varelinje. Skal angives i en løkke, hvis du vil tillade flere rabatkoder. |
discount_allocation.discount_application |
Den rabattildeling, der tildeler beløbet på varelinjen. |
Discount_application-egenskaber
Hver discount_application
på listen med discount_applications
har følgende egenskaber.
Egenskab | Beskrivelse |
---|---|
discount_application.target_selection |
Beskriver, hvordan en rabat vælger varelinjer i indkøbskurven, som der skal trækkes rabat fra. En af følgende:
|
discount_application.target_type |
Den type vare, som en rabat gælder for (line_item eller shipping_line ). |
discount_application.title |
Det navn på rabatten, som kunderne kan se. Eksempler: Welcome10 eller CBBWQQAKYBYY |
discount_application.total_allocated_amount |
Det samlede beløb, som prisen for en ordre er nedsat med rabatten. |
discount_application.type |
Rabattypen. En af følgende: automatic , discount_code , manual eller script . |
discount_application.value |
Værdien af rabatten. |
discount_application.value_type |
Værditypen for rabatten. En af følgende: fixed_amount eller percentage . |
Egenskaber for e-mailnotifikationer
Egenskab | Beskrivelse |
---|---|
shop.email_logo_url |
Webadressen for det logo, der er angivet i afsnittet Tilpas mailskabeloner i administratoren. |
shop.email_logo_width |
Logoets bredde (i pixel), der er angivet i afsnittet Tilpas mailskabeloner i administratoren. |
shop.email_accent_color |
HEX-koden for den markeringsfarve, der er angivet i afsnittet Tilpas mailskabeloner i administratoren. |