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 26 land.
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
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.
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.
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'
});
</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 kontaktverifisering 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 kontaktverifisering 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.0.0 — første versjon av kittet: widget, PHP-proxy med bremser og kontroll av opprinnelse, eksempelskjema, README.
De andre integrasjonene: WooCommerce, PrestaShop, AcyMailing, Convert Forms og Community Builder. Listen.