DOCS

Install

/

Installer Hello legacy

Lær hvordan du installerer Hello på din butiks hjemmeside.

Hvis du bruger Shopify, BigCommerce, Magento, Miva eller X-Cart, bedes du læse den tilsvarende plugin integrationsside.

Scriptet nedenfor vil tilføje Zonos Hello flaget til din side, genkende det land, dine kunder besøger fra, hilse på dem og give generel told- og skatteinformation for deres land (grundlæggende).

Yderligere funktioner er tilgængelige med minimal udviklingsarbejde (vist nedenfor).

Tilføj Hello til din side 

1

Tilføj Hello scriptet - grundlæggende

At tilføje dette script til din sides kode vil tilføje Zonos Hello flaget til din hjemmeside, genkende det land, dine kunder besøger fra, hilse på dem og give generel told- og skatteinformation for deres land.

KOMPETENCER NØDVENDIGE: Grundlæggende webfærdigheder

For at installere Hello, anvend det tilpassede script, der indeholder din unikke site-nøgle, på din hjemmeside før den afsluttende body tag.

Hello integrationsscript

1
<script src="https://hello.zonos.com/hello.js?siteKey=YOURSITEKEY"></script>

Zonos Hello skal indlæses, før der tilføjes nogen yderligere funktionalitet. Venligst inkluder eventuelle yderligere funktioner efter ovenstående script.

Har du ikke allerede et script? Klik her for at downloade.

2

Generer estimerede told- og skattebeløb

KOMPETENCER NØDVENDIGE: Grundlæggende udviklerfærdigheder

Når denne funktion er aktiveret, kan Hello give estimater for told og skat, når et produkt vises eller tilføjes til indkøbskurven. Hello kan også vise fulde told- og skatteoverslag for hele indkøbskurven, når siden vises.

Told- og skatteoverslaget kan placeres på hver produktside eller din hovedprodukside, afhængigt af hvordan din platform er opsat.

For at tilføje told- og skatteoverslaget, anvend et script, der ligner det, der vises nedenfor. De to krævede felter er name og price.

Eksempel: Nedenfor er et eksempel på, hvordan scriptet vil se ud og fungere på din side.

Hello integrationsscript

1
2
3
4
5
6
7
8
9
10
11
12
13
zonos.quote({
  items: [
    {
      name: 'The name of the product',
      price: 19.95,
      quantity: 2,
      image: 'https://example.com/product-123.png',
      url: 'https://example.com/product-123',
      sku: '123',
    },
  ],
  currencyCode: 'USD',
});

Scripts, der kan bruges, skal justeres for at få dem til at fungere på dit site. Sørg venligst for, at nogen af de følgende scripts, du bruger, placeres efter den indledende Zonos Hello Script.

Hvis du ikke bruger en platform, kan du bruge følgende til dynamisk at hente dine produktdetaljer. Dette script vil hente det første tilgængelige produkt. Du kan også justere dette script til at blive brugt på din sites indkøbskurvside. Du skal loop igennem alle produkter og deres data og derefter sende det til zonos.quote.

Hello integrationsscript

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
<script>
  var zPrice = '';
  var zName = '';
  var zImg = '';

  try {
    if (document.querySelector('ID OR CLASSNAME') != null) {
      zPrice = document.querySelectorAll('ID OR CLASSNAME').innerText;
    }

    if (document.querySelector('ID OR CLASSNAME') != null) {
      zName = document.querySelector('ID OR CLASSNAME').innerText;
    }

    if (document.querySelector('.ID OR CLASSNAME') != null) {
      zImg = document.querySelector('ID OR CLASSNAME').src;
    }

    zonos.quote({
      items: [
        {
          name: zName,
          price: zPrice,
          image: zImg,
        },
      ],
      currencyCode: 'USD',
    });
  } catch (error) {}
</script>

Du kan tilføje yderligere værdier fra varefelterne nedenfor og også ændre currencyCode til at være din standardvaluta.

Shopify og BigCommerce

Hvis du bruger Shopify eller BigCommerce, skal du bruge koden nedenfor.

Shopify
BigCommerce

Hvis du bruger Shopify som din platform, har vi et script, du kan bruge, som vil hente produktdata fra dine Shopify produktdetaljer.

Den nedenstående kode har en funktion, der vil køre på produkt siderne og indkøbskurv siden.

Hello integrationsscript

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<script>
    function znDutyTaxEstimateOnDetailPage() {
        {% if product and product.price %}
          zonos.quote({
            items: [{ price: "{{ product.price | money_without_currency }}", name: "{{product.title | replace: '"', '\"'}}", url: "{{ shop.secure_url }}{{ product.url }}", image: "https:{{ product.featured_image | product_img_url: 'medium' }}"}],
            currencyCode: '{{ shop.currency }}'

          });

      {% endif %}

  }

  function znDutyTaxEstimateOnCartPage() {
  if (window.location.href.indexOf("cart") > -1) {
  zonos.quote({
  items: [
  {% for item in cart.items %}
  { price: "{{ item.price | money_without_currency }}", quantity: {{item.quantity}}, name: "{{ item.title | replace: '"', '\"'}}", url: "{{ shop.secure_url }}{{item.url}}", image: "https:{{item.image| product_img_url: 'medium'}}"},
  {% endfor %}
  ],currencyCode: '{{ shop.currency }}'});
  }
  }

  znDutyTaxEstimateOnDetailPage();
  znDutyTaxEstimateOnCartPage();
</script>

Citationsfelter 

FeltDatatypeBeskrivelse
itemsarray

PÅKRÆVET

En liste over varer, der skal inkluderes i citatet
currencyCodestringVarepriserne vises i den valuta, der er angivet med den tre-tegns valuta kode. Standard: USD
includedTaxRatenumberVareafgift rate hvis varen inkluderer skat
showDecimalboolTænd/sluk for visning af decimalværdien på konverterede valutaer

Varefelter 

FeltDatatypeBeskrivelse
namestring

PÅKRÆVET

Produktnavn
pricenumber

PÅKRÆVET

Enhedspris for et enkelt produkt
quantityintegerAntallet af produkter i indkøbskurven. Standard: 1
imagestringURL til produktbilledet
urlstringURL til det enkelte produkt
hsCodestringDen harmoniserede kode (HS-kode) for dit produkt
categorystringProduktkategori på din side
countrystringTo-tegns ISO-kode for det land, dette produkt stammer fra
customizationstringProdukttilpasning (f.eks. størrelse, farve)
descriptionstringDen detaljerede beskrivelse af produktet
skustringUPC eller SKU for produktet

Når du giver flere oplysninger til Zonos om dit produkt, vil nøjagtigheden af estimatet normalt blive forbedret.

Tilpas Hello 

Ændre flagets placering

KOMPETENCER NØDVENDIGE: Grundlæggende udviklerfærdigheder

Som standard vil Zonos Hello flaget vises i nederste højre hjørne af din side.

Her finder du nogle oplysninger om, hvordan du ændrer placeringen af flaget samt skjuler visse elementer på din hjemmeside, som du ikke ønsker, at internationale kunder skal se.

Eksempel: Skjule gratis fragt fra internationale kunder; dette vil også gøre det muligt for dig at skjule Zonos Hello fra indenlandske kunder og specifikke lande.

Hvis placeringen efterlades tom, vil koden bruge standardindstillingen.

Hello integrationsscript

1
2
zonos.config({ location: 'right bottom attached' });
zonos.config({ location: '' });

For the bottom-left corner:

zonos.config({location: 'venstre'});

For the top-left corner with a floating information dialog:

zonos.config({location: 'venstre top flydende'});

  • flydende refererer til Hello informationsdialogen, der flyder i midten af siden.
  • vedhæftet refererer til Hello informationsdialogen, der åbner over flaget.
  • flydende foretrækkes, når flaget er placeret i top.

Skjul specifikt indhold

KOMPETENCER NØDVENDIGE: Grundlæggende udviklerfærdigheder

Klassen z-intl er baseret på det nuværende indenlandske land. Hvis Hello er indstillet til et internationalt land, vil klassen z-intl fungere som en skjult klasse, der skjuler det indhold, som .z-intl er knyttet til.

Brug følgende CSS til at skjule indhold. Erstat .dit-indhold med det flydende indhold, du ønsker at skjule.
.z-intl .dit-indhold { display: none; }

Nu kan du skjule Hello for dine indenlandske kunder, så andre dialoger bliver synlige igen.

Hello integrationsscript

1
2
3
4
5
6
#zonos {
  display: none;
}
.z-intl #zonos {
  display: block;
}

Skjul for specifikke lande

Tilføj #zonos id kombineret med landekoden, der fungerer som CSS-klasse for det pågældende land, til funktionen .z-intl { display: none; }.

Linjen skal se sådan ud:

Hello integrationsscript

1
2
3
.z-intl #zonos.US {
  display: none;
}

Tænd/sluk for splash

KOMPETENCER NØDVENDIGE : Grundlæggende udviklerfærdigheder

Splash refererer til pop-up'en og forstørrelsen af Zonos dialogboksen, som indeholder yderligere information om deres lands specifikke told- og skattepolitik.\

Hvis du gerne vil TÆNDE og vise Zonos Hello splash for dine kunders første besøg:

Hello integrationsscript

1
zonos.config({ showSplash: true });

Hvis du ønsker at DEAKTIVERE Zonos Hello splash for dine kunders første besøg:

Hello integrationsscript

1
zonos.config({ showSplash: false });

Bemærk: Enhver Zonos tilpasning skal være inden for et script tag.

Ofte stillede spørgsmål 

Jeg er ikke udvikler og har brug for hjælp. Hvad er mine muligheder?

Hvis du har spørgsmål, bedes du kontakte vores supportteam. Hvis du ikke har ressourcerne til at gennemføre integrationen og har brug for hjælp, bedes du kontakte vores Professionelle Services team.

Var denne side nyttig?