RadarAddress address · data · quality

Integrasjoner · Skjemaet ditt

Autofullføring av adresser i skjemaet ditt, i tre filer.

Ingen plugin, ingen plattform: én JavaScript-fil som kobler seg til feltene du allerede har, en ferdig proxy for serveren din som holder tokenet trygt, tre linjer for å koble dem sammen. Besøkeren skriver, gateadressen fullføres automatisk, postnummer, by og fylke fylles ut av seg selv; en håndskrevet adresse blir verifisert når feltet forlates. Forslag fra registrene i 27 land.

Last ned kittet 1.2.0 · 20 KB Slik gjør du det
RadarAddress-widgeten på et hvilket som helst skjema: gateadressen fullføres mens du skriver

Hva som er i kittet

  • ra-suggerisci.js·widgeten: ingen avhengigheter, samme fil som i WooCommerce- og PrestaShop-pluginene; den foreslår mens du skriver og fordeler, ved valg, den verifiserte adressen ut i feltene
  • ra-proxy.php·proxyen: holder tokenet på serveren, godtar bare ditt eget domene, bremser per besøkende, videresender til RadarAddress; hvis tokenet mangler eller krediten er brukt opp, svarer den med en tom liste og skjemaet fortsetter som normalt
  • esempio.html·et komplett skjema — land, adresse, postnummer, by, fylke — som fungerer så snart tokenet er lagt inn i proxyen: du kopierer det og tilpasser det
  • README·widgetens opsjoner, proxyens kontrakt for deg som ikke bruker PHP, hva den forbruker

Slik gjør du det, i tre trinn

1

Opprett kontoen og tokenet

Kontoen er gratis, krever ikke kort og omfatter hver måned en kvote med operasjoner: tokenet oppretter du med ett klikk, og stegene er forklart der.

2

Legg proxyen på serveren

Kopier ra-proxy.php til samme domene som skjemaet, og skriv inn tokenet på den angitte linjen (enda bedre: i en fil utenfor webmappen, lest derfra). Ikke noe annet å konfigurere.

3

Koble widgeten til feltene

Inkluder ra-suggerisci.js på siden og angi velgerne for feltene dine: adresse, postnummer, by, fylke og, hvis det finnes, land. Resten gjør widgeten.

<script src="ra-suggerisci.js"></script>
<script>
RASuggerisci.attacca({
  url: '/ra-proxy.php',                       // proxyen på din egen server, aldri API-et direkte
  campi: { indirizzo: '#indirizzo', cap: '#cap', localita: '#citta',
           provincia: '#provincia', nazione_iso2: '#nazione' },   // landet er valgfritt
  lingua: 'no',
  modulo: 'contatti/indirizzo'                  // valgfritt: hvilket skjema, for loggen din
});
</script>

campi godtar en hvilken som helst CSS-velger. Ekstra opsjoner: onSeleziona mottar den verifiserte posten (normalisert adresse, utfall, koordinater når de finnes), scriviCampo for React- og Vue-skjemaer, correggiAlBlur for å avgjøre om også håndskrevne adresser skal verifiseres, headers for et CSRF-token mot proxyen. Alt står i kittets README; API-kontrakten finner du i dokumentasjonen.

Krav: en hvilken som helst nettside, og for kittets proxy, PHP 8.0 eller nyere med cURL; ellers seksti linjer i ditt eget språk. Widgeten er publisert under lisensen Academic Free License 3.0.

Hva som skjer i skjemaet

  • Mens du skriver·etter to bokstaver foreslår widgeten gatene, med fullt navn og kommune; flere bokstaver filtrerer det den allerede har mottatt, uten å kalle serveren for hvert tastetrykk; postnummer og by som allerede er fylt ut, snevrer inn søket
  • Ved valg·den verifiserte adressen legges inn i feltene i riktig form — gate skrevet fullt ut, husnummer, riktig postnummer også i store byer med flere postnummersoner, by og fylke — og én adressevalidering telles; husnumrene på gaten fullføres uten ytterligere belastning
  • Skrevet for hånd·den som ignorerer listen og skriver alt selv, blir verifisert når feltet forlates: hvis adressen gjenkjennes, ordnes feltene; hvis ikke, forblir de som de er. Ingenting blokkerer noensinne innsendingen
  • I utlandet·med landet angitt kommer forslagene fra det landets register, og besøkeren skriver slik man skriver der, selv alt i ett felt; kildehenvisningen til registeret står nederst i listen

Vanlige spørsmål

Hvorfor trenger jeg en proxy? Kan jeg ikke kalle API-et direkte fra siden?

API-tokenet gir tilgang til krediten din: hvem som helst kunne lese det på siden. Widgeten snakker bare med en adresse på ditt eget nettsted; der legger en seksti linjer lang fil til tokenet og videresender forespørselen. Kittets PHP-proxy er klar til bruk: du kopierer den, skriver inn tokenet, og er ferdig.

Nettstedet mitt er ikke i PHP.

Proxyen er referansen, ikke et krav: den mottar JSON fra nettleseren, legger til Authorization-headeren med tokenet, videresender til /api/v1/suggest og returnerer svaret. Den kan skrives om i et hvilket som helst språk på noen minutter; README-en beskriver kontrakten.

Fungerer det med React, Vue, Angular?

Ja: widgeten kobler seg til feltene med en hvilken som helst CSS-velger. Kontrollerte skjemaer krever at verdien skrives med den native setteren: det er det opsjonen scriviCampo gjør, og det er den samme WooCommerce-pluginet bruker på blokk-kassen.

Hva forbruker den?

Å skrive er gratis. Én adressevalidering telles når besøkeren velger en adresse fra listen (eller når en håndskrevet adresse blir verifisert ved forlate feltet, hvis du lar correggiAlBlur stå på): én per adresse, ikke per tastetrykk. Hver måned er de første 50 gratis; utover det gjelder pakkene og abonnementene på prissiden.

Hva skjer hvis krediten tar slutt, eller RadarAddress ikke svarer?

Widgeten tier, og skjemaet fungerer som vanlig: ingen melding til besøkeren, ingen blokkert innsending. Proxyen returnerer en tom liste ved 401, 402 og ved enhver nettverksfeil.

Gjelder det i utlandet?

For alle landene i drift: det holder med et felt med landets ISO-kode (en nedtrekksliste med IT, DE, FR … eller et skjult felt) angitt i nazione_iso2. Besøkeren skriver slik man skriver i sitt eget land, selv alt i ett felt; popup-vinduet viser kildehenvisningen til registeret.

Kan jeg endre utseendet på popup-vinduet?

Widgeten har med sine egne stiler, uten noen CSS-fil: variablene --ra-sugg-bg, --ra-sugg-bordo og --ra-sugg-hover på siden din endrer fargene; klassen er .ra-sugg-pop for resten.

Versjoner

  • 1.1.1 — dagens widget: forslagslisten like bred som feltet, «snc» foreslås bare for en italiensk adresse, tekster på de tretten språkene (uten oppgitt språk: engelsk).
  • 1.0.0 — første versjon av kittet: widget, PHP-proxy med bremser og kontroll av opprinnelse, eksempelskjema, README.

De andre integrasjonene: AcyMailing, Community Builder, Contact Form 7, Convert Forms, Drupal Webform, Fluent Forms, Formidable Forms, Gravity Forms, Magento, MailPoet, Make, n8n, Ninja Forms, OpenCart, PrestaShop, Shopify, Shopware, The Newsletter Plugin, VirtueMart, WooCommerce, WPForms og Zapier. Listen.