Google automatikus címkitöltés

A Google címkitöltés bekapcsolása a pénztáron, a Places API verziói, a kitöltött mezők, az országszűkítés és a korlátozások.

A Google automatikus címkitöltésnél a vásárló az utcacím mezőbe kezd gépelni, a rendszer pedig címjavaslatokat kínál. A javaslat kiválasztása után a pénztár kitölti a többi címmezőt is. A vásárló továbbra is begépelheti a címet kézzel, ha így kényelmesebb, vagy ha a címe nincs a javaslatok között.

A funkció a fizetős csomagokhoz tartozik, érvényes licenccel, és a Google Places könyvtárát használja a saját Google API-kulcsoddal.

Mi kell hozzá?

Fizetős CheckoutWC csomag aktív licenccel. Az ingyenes változat nem tartalmazza.
Google API-kulcs egy olyan Google Cloud projektből, amelyen a számlázás be van kapcsolva. A kulcs beszerzését a Google API-kulcs fejezet írja le.
A projekten engedélyezett Maps JavaScript API, és az a Places API-verzió, amelyet használni fogsz (lásd lent).

Bekapcsolás

Nyisd meg a CheckoutWC → Oldalak → Pénztár fület.
A Cím kitöltése és ellenőrzése szakaszban jelöld be a Google cím automatikus kitöltés engedélyezése kapcsolót.
Kattints a Módosítások mentése gombra.
Nyisd meg a CheckoutWC → Integrációk oldalt, és a Google API szakaszban illeszd be a kulcsot a Google API kulcs mezőbe.
Válaszd ki a Google Places API verziója értékét.
Kattints a Kulcs ellenőrzése gombra, majd mentsd a beállításokat.
Nyisd meg a pénztárat, kezdj gépelni az utcacím mezőbe, és nézd meg, megjelennek-e a javaslatok.

A Cím kitöltése és ellenőrzése szakasz a Pénztár beállításai között

A képen a három címkitöltő beállítás látszik; a Google a legfelső.

A kulcs közös: ugyanaz működteti a köszönőoldal térképét is.

A Google API szakasz az Integrációk oldalon

A képen a kulcs mezője, a Places API verziója és a Kulcs ellenőrzése gomb látszik. A gomb addig szürke, amíg nincs kulcs a mezőben.

Places API (új) vagy (régi)?

A Google Places API verziója mezőben két érték közül választasz: Places API (új) - ajánlott és Places API (régi).

Válaszd az újat, hacsak a boltod nem fut már a régi API-n. A Google 2025. március 1-jén lezárta a régi Places API-t az újonnan létrehozott Google Cloud projektek előtt, ezért egy ennél újabb projekten csak az új verzió engedélyezhető. A kulcs mindkét verzióhoz jó, de a kiválasztott verziónak engedélyezve kell lennie a projekten, és ha korlátoztad a kulcs API-it, a kulcson is.

Az új telepítések az új verzióval indulnak. A korábban beállított boltok a régin maradnak, amíg át nem váltasz, magától semmi sem változik.

A javaslatok megjelenése a verziótól függ:

Régi verzió: a Google saját legördülő listája jelenik meg a mező alatt.
Új verzió: a CheckoutWC maga rajzolja a listát. Legalább három beírt karakter után kér javaslatot, és a lista nyílbillentyűkkel, Enterrel és Esc-cel is kezelhető.

A kulcs kipróbálása

A Kulcs ellenőrzése gomb a böngésződből, ugyanúgy próbálja ki a kulcsot, ahogy a pénztár használja. Menthetsz előtte vagy utána is. Megmondja:

hogy a Google elfogadja-e a kulcsot az oldaladon;
hogy a kulcs eléri-e a Places API (új), a Places API (régi) és a Geocoding API (a köszönőoldal térképe) szolgáltatást;
hogy a kiválasztott verzió működik-e;
mi állítja még meg a címkitöltést a CheckoutWC-ben: ki van kapcsolva a Google címkitöltés, be van kapcsolva a külön házszám és utcanév mező, vagy egyszerre be van kapcsolva a Fetchify.

Ha a próba után megváltoztatod a kulcsot, frissítsd az oldalt, mielőtt újra ellenőrzöd: a Google Maps oldalanként csak egy kulcsot tölt be.

Mely mezőket tölti ki?

A javaslatok az utcacím mezőben jelennek meg. Kiválasztáskor a pénztár kitölti:

az utcacímet,
a várost,
az államot vagy megyét,
az irányítószámot,
az országot.

A Cím 2 (lakás, emelet stb.) mezőt a legtöbb országnál törli, hogy ne maradjon régi lakásszám az új utca mellett. Az Egyesült Királyság, Új-Zéland és Tajvan esetén a Cím 2 a javaslat településrészéből kitöltődhet, és a mező ilyenkor láthatóvá válik. Ha a vásárlónak lakásszám kell, a javaslat kiválasztása után írja be.

A címkitöltés a szállítási címnél (ha a rendeléshez szállítás kell) és a számlázási címnél is működik, ugyanúgy.

Javaslatok szűkítése országokra

Alapból a javaslatok nem szűkülnek országra. Ha csak néhány országba szállítasz, a szállítási és a számlázási javaslatokat külön szűrővel korlátozhatod. A szűrők kétbetűs országkódokat várnak (ISO 3166-1 alpha-2, kisbetűvel). Tedd a kódot egy kódrészlet-bővítménybe vagy a gyermektéma functions.php fájljába (ha a fájlban már van nyitó <?php jel, ne írd le még egyszer):

add_filter( 'cfw_address_autocomplete_shipping_countries', function () {
  return [ 'hu', 'at' ];
} );

add_filter( 'cfw_address_autocomplete_billing_countries', function () {
  return [ 'hu', 'at' ];
} );

Csak azt a szűrőt használd, amelyikre szükséged van.
Az Egyesült Királyság kódja gb, nem uk.
A Places API (új) legfeljebb 15 országot vesz figyelembe, a többit a CheckoutWC elhagyja. A Places API (régi) legfeljebb 5 országot fogad el.
A szűrő csak azt változtatja meg, mit javasol a címkitöltés. A vásárló továbbra is begépelhet bármilyen címet, és kiválaszthat bármilyen országot, ahová a bolt szállít. Fetchify címkitöltésre nem vonatkozik.

Mi nem működik vele együtt?

A Külön házszám és utcanév címmezők és a Google címkitöltés nem használható együtt. A külön mezők bekapcsolása leállítja a címkitöltést. Ennek oka a kezelhetőség: egyik külön mezőbe sem értelmes beírni azt, ami alapján a címet keresni lehetne. Ha mindkettő kellene, a megoldás egy külön címkereső mező lenne, de az nincs a bővítményben, ezért válassz a két funkció közül.
A Google és a Fetchify címkitöltés nem futhat egyszerre. Az egyiket kapcsold ki.
Amíg a Google címkitöltés fut, a CheckoutWC saját irányítószám-kitöltése ki van kapcsolva. A Google javaslatának kiválasztása az irányítószámot és a várost együtt tölti ki.

Gyakori kérdések

Mobilon is működik? Igen. Nincs külön mobilbeállítás vagy eszközellenőrzés: ugyanazokkal a beállításokkal, ugyanazzal a kulccsal és ugyanazokkal a javaslatokkal fut telefonon, mint számítógépen.

Mennyibe kerül? A CheckoutWC nem számít fel érte külön díjat, a fizetős csomagok tartalmazzák. A Google viszont a Google Cloud projektedre számlázza a pénztár kéréseit, ezért kell a projekten bekapcsolt számlázás. Az összeg a címkitöltést használó vásárlók számától és a Google aktuális díjaitól függ. Az új Places API-nál a CheckoutWC csökkenti a kérések számát: megvárja a három karaktert és egy kis szünetet, mielőtt javaslatot kér, és egy keresést egyetlen Google-munkamenetbe csoportosít. Ha a kulcsot a saját webhelyed domainjére korlátozod, azzal azt is megakadályozod, hogy más futtasson kéréseket a kulcsoddal.

Ki kell tölteni kézzel is? Nem. A vásárló figyelmen kívül hagyhatja a javaslatokat, és kézzel is kitöltheti a mezőket.

Miért nem jelennek meg javaslatok? Leggyakrabban a kulcs nincs engedélyezve az oldaladon, egy API nincs bekapcsolva a projekten, ki van kapcsolva a számlázás, vagy nem a projektnek megfelelő Places-verzió van kiválasztva. Először kattints a Kulcs ellenőrzése gombra, aztán nézd meg a hibaelhárítási fejezetet.

Készült: 2026. november 1.