Adresseforslag i PrestaShop-checkout

Opret en offentlig nøgle

Feltet kalder Grundfast direkte fra kundens browser, så det bruger en offentlig nøgle (gf_pub_live_). Den må gerne stå i sidens kildekode, fordi den kun virker fra de domæner, du skriver på den, og kun til adresseopslag. Opret den under Nøgler i dashboardet: vælg Offentlig og skriv dine domæner, fx butik.dk og www.butik.dk.

Byg og test med en offentlig testnøgle (gf_pub_test_), som aldrig faktureres, og skift til live-nøglen, når feltet virker. Reglerne for domæner — www, underdomæner med *. og porte — står i dokumentationen for adressefeltet.

Felterne på adressetrinnet

Adressetrinnet i checkouten bruger den samme adresseformular som kundens konto. I Classic-temaet får hvert felt id’et field- plus feltets navn, og navnene er PrestaShops egne:

Brug navnet frem for id’et i selektoren — så virker det også i temaer, der ikke bygger på Classic, så længe de bruger PrestaShops standardfelter.

Læg scriptet i custom.js

Åbn themes/<dit-tema>/assets/js/custom.js (via FTP eller dit deploy) og indsæt nedenstående. Det opretter script-tagget med de samme indstillinger, som du ellers ville skrive i HTML:

(function () {
  var s = document.createElement('script');
  s.src = 'https://grundfast.dk/widget/v1/grundfast-adresse.js';
  s.dataset.key = 'gf_pub_live_...';
  s.dataset.felt = 'input[name="address1"]';
  s.dataset.postnr = 'input[name="postcode"]';
  s.dataset.by = 'input[name="city"]';
  document.head.appendChild(s);
})();

Tøm derefter cachen under Advanced Parameters → Performance → Clear cache, især hvis du har slået sammenlægning af JavaScript (CCC) til — ellers serveres den gamle, samlede fil.

Hvad der sker i checkouten

• Kunden skriver i Adresse og får forslag fra to tegn. Har bygningen lejligheder, kommer etage og dør som et ekstra trin.
• Adresse får gade, husnummer og evt. etage og dør; Postnummer og By udfyldes. Feltet skriver dem, som om kunden havde tastet, så PrestaShops egen validering kører som normalt.
• Når kunden skifter land eller tilføjer en ny adresse, tegner PrestaShop formularen igen. Feltet hægter sig på det nye inputfelt af sig selv.
• Det samme gælder faktureringsadressen, hvis kunden vælger en anden adresse til faktura — den bruger de samme feltnavne i sin egen formular.

Tjek nøglen fra en terminal

Før du leder i platformens indstillinger, kan du se, om nøglen og domænet passer sammen. Kaldet nedenfor er det samme, feltet laver. Origin er dit domæne, præcis som browseren skriver det:

curl -G "https://api.grundfast.dk/v1/adresse/search" \
  --data-urlencode "q=Vestergade 10" \
  --data-urlencode "token=$GRUNDFAST_PUBLIC_KEY" \
  -H "Origin: https://www.butik.dk"

Svarer det med adresser, er nøglen i orden. Et 403 med origin … is not allowed betyder, at domænet ikke står på nøglen — ret listen i dashboardet; det slår igennem inden for et halvt minut.

Hvis der ikke kommer forslag

• Åbn browserens konsol (F12, fanen Console). Feltet skriver én linje, der begynder med [grundfast-adresse], med årsagen fra API’et.
• no public key — scriptet blev indlæst uden data-key.
• Ingen linje og ingen liste — feltet blev ikke fundet. Tjek at selektoren i data-felt rammer feltet: skriv document.querySelectorAll('…') med den samme selektor i konsollen.
• Listen vises, men felterne udfyldes ikke — selektorerne i data-postnr og data-by rammer ikke noget. De slås op i samme formular som adressefeltet først, derefter på hele siden.

Feltet stopper aldrig formularen: fejler et kald, lukker listen, og kunden kan skrive adressen i hånden som før.