Samþættingar · Formið þitt
Sjálfvirk útfylling heimilisfanga í forminu þínu, í þremur skrám.
Engin viðbót, enginn vettvangur: ein JavaScript-skrá sem tengist reitunum sem þú átt nú þegar, proxy sem er tilbúinn fyrir netþjóninn þinn og geymir token-ið öruggt, þrjár línur til að tengja þau saman. Gesturinn skrifar, gatan fyllist sjálfkrafa út, póstnúmer, borg og hérað fyllast sjálf; handskrifað heimilisfang er sannprófað þegar það fer úr reitnum. Tillögur úr skrám 26 landa.
Hvað er í pakkanum
- ra-suggerisci.js·widget-ið: engar háðar skrár, sama skrá og WooCommerce- og PrestaShop-viðbæturnar nota; það stingur upp á meðan skrifað er og setur sannprófaða heimilisfangið í reitina við valið
- ra-proxy.php·proxy-inn: geymir token-ið á netþjóninum, tekur aðeins við frá þínu léni, takmarkar fjölda fyrirspurna á hvern gest, sendir áfram til RadarAddress; ef token-ið vantar eða inneignin er búin svarar hann með tómum lista og formið heldur bara áfram
- esempio.html·heilt form — land, heimilisfang, póstnúmer, borg, hérað — sem virkar um leið og token-ið er komið í proxy-inn: þú afritar það og aðlagar
- README·valkosti widget-sins, samninginn fyrir proxy-inn ef þú notar ekki PHP, og hvað það eyðir
Svona er það gert, í þremur skrefum
Búðu til aðgang og token
Aðgangurinn er ókeypis, biður ekki um greiðslukort og inniheldur kvóta af vinnslum í hverjum mánuði: táknið er búið til með einum smelli og skrefunum er lýst þar.
Settu proxy-inn á netþjóninn
Afritaðu ra-proxy.php á sama lén og formið og skrifaðu token-ið í tilgreindu línuna (best er þó: í skrá utan vefmöppunnar, lesin þaðan). Ekkert annað þarf að stilla.
Tengdu widget-ið við reitina
Settu ra-suggerisci.js inn á síðuna og tilgreindu valin fyrir reitina þína: heimilisfang, póstnúmer, borg, hérað og, ef til er, landið. Widget-ið sér um restina.
<script src="ra-suggerisci.js"></script>
<script>
RASuggerisci.attacca({
url: '/ra-proxy.php', // proxy-inn á þínum eigin netþjóni, aldrei API-ið beint
campi: { indirizzo: '#indirizzo', cap: '#cap', localita: '#citta',
provincia: '#provincia', nazione_iso2: '#nazione' }, // landið er valfrjálst
lingua: 'is'
});
</script>
campi tekur við hvaða CSS-vali sem er. Aukavalkostir: onSeleziona fær sannprófaða færslu (samræmt heimilisfang, niðurstöðu, hnit þegar þau eru til), scriviCampo fyrir React- og Vue-form, correggiAlBlur til að ákveða hvort handskrifuð heimilisföng séu líka sannprófuð, headers fyrir CSRF-token til proxy-sins. Allt er í README-skrá pakkans; samningur API-sins er í skjölunum.
Kröfur: hvaða vefsíða sem er og, fyrir proxy-inn í pakkanum, PHP 8.0 eða nýrra með cURL; annars sextíu línur á þínu tungumáli. Widget-ið er gefið út undir Academic Free License 3.0.
Hvað gerist í forminu
- Á meðan skrifað er·eftir tvo stafi stingur widget-ið upp á götum, með fullu nafni og sveitarfélagi; fleiri stafir sía það sem það hefur þegar fengið, án þess að kalla á netþjóninn í hvert sinn sem ýtt er á staf; póstnúmer og borg sem þegar eru fyllt út þrengja leitina
- Við valið·sannprófaða heimilisfangið fer í reitina í réttu formi — gatan í fullri lengd, húsnúmer, rétt póstnúmer líka í stórum borgum með mörg póstnúmer, borg og hérað — og ein sannprófun tengiliða telst; húsnúmer götunnar fyllast sjálfkrafa út án frekari gjalda
- Handskrifað·sá sem hunsar listann og skrifar allt sjálfur er sannprófaður þegar hann fer úr reitnum: ef heimilisfangið þekkist, lagast reitirnir; ef ekki, helst það óbreytt. Ekkert stöðvar nokkurn tíma innsendinguna
- Erlendis·þegar landið er tilgreint koma tillögurnar úr skrá þess lands og gesturinn skrifar eins og skrifað er þar, jafnvel allt í einum reit; heimild skrárinnar er neðst í listanum
Algengar spurningar
Af hverju þarf proxy? Get ég ekki kallað á API-ið beint frá síðunni?
API-token-ið veitir aðgang að inneigninni þinni: hver sem er gæti lesið það á síðunni. Widget-ið talar aðeins við vistfang á þinni eigin síðu; þar bætir sextíu lína skrá token-inu við og sendir áfram. PHP-proxy-inn í pakkanum er tilbúinn: þú afritar hann, skrifar token-ið, og þá er það komið.
Síðan mín er ekki í PHP.
Proxy-inn er viðmiðunin, ekki skylda: hann tekur á móti JSON frá vafranum, bætir við Authorization-hausnum með token-inu, sendir áfram á /api/v1/suggest og skilar svarinu. Hægt er að endurskrifa hann á hvaða tungumáli sem er á fáeinum mínútum; README-skráin lýsir samningnum.
Virkar það með React, Vue, Angular?
Já: widget-ið tengist reitunum með hvaða CSS-vali sem er. Stýrð form vilja að gildið sé skrifað með innbyggða setter-num: valkosturinn scriviCampo er einmitt til þess, og hann er sá sem WooCommerce-viðbótin notar í Checkout Block.
Hvað eyðir það?
Að skrifa er ókeypis. Ein sannprófun tengiliða telst þegar gesturinn velur heimilisfang úr listanum (eða þegar handskrifað heimilisfang er sannprófað við það að fara úr reitnum, ef þú lætur correggiAlBlur vera á): ein fyrir hvert heimilisfang, ekki fyrir hvern staf. Fyrstu 50 í hverjum mánuði eru ókeypis; umfram það gilda pakkarnir og áskriftirnar á verðsíðunni.
Hvað ef inneignin klárast, eða RadarAddress svarar ekki?
Widget-ið þegir og formið virkar eins og venjulega: engin skilaboð til gestsins, engin innsending stöðvuð. Proxy-inn skilar tómum lista við 401, 402 og hvaða netvillu sem er.
Virkar það erlendis?
Fyrir öll lönd í þjónustu: það nægir að hafa reit með ISO-kóða landsins (val með IT, DE, FR… eða falinn reitur) tilgreindan í nazione_iso2. Gesturinn skrifar eins og skrifað er í hans landi, jafnvel allt í einum reit; popup-ið sýnir heimild skrárinnar.
Get ég breytt útliti popup-sins?
Widget-ið kemur með sína eigin stíla, án CSS-skrár: breyturnar --ra-sugg-bg, --ra-sugg-bordo og --ra-sugg-hover á síðunni þinni breyta litunum; klasinn er .ra-sugg-pop fyrir allt hitt.
Útgáfur
- 1.0.0 — fyrsta útgáfa pakkans: widget, PHP-proxy með takmörkunum og upprunaeftirliti, dæmaform, README.
Aðrar tengingar: WooCommerce, PrestaShop, AcyMailing, Convert Forms og Community Builder. Listinn.