Adresní našeptávač Mapy.com

WordPress plugin, který do adresních polí doplní našeptávač adres z Mapy.cz (Seznam.cz suggest API). Po výběru z nabídky se kromě ulice předvyplní i město, PSČ a země.

Podporuje:

• WooCommerce - klasickou pokladnu (shortcode [woocommerce_checkout]) i blokovou (blok woocommerce/checkout), fakturační i doručovací adresu,
• Contact Form 7 - libovolný formulář, s nastavitelným mapováním polí.

Požadavky

• WordPress 6.0+, PHP 7.4+
• API klíč z developer.mapy.com (bezplatný tarif stačí)

Instalace

1. Stáhněte ZIP z posledního vydání.
2. Nahrajte přes Pluginy → Přidat plugin → Nahrát plugin a aktivujte.
3. V Nastavení → Adresní našeptávač Mapy.com vyplňte API klíč.

Plugin lze nainstalovat i přímým klonem repozitáře do wp-content/plugins/ - složka vendor/ je součástí repa, takže není potřeba spouštět Composer.

Nastavení

Nastavení → Adresní našeptávač Mapy.com

Skripty pluginu se načtou jen tam, kde je našeptávač zapnutý.

Země pro našeptávání

Mapy.cz mají adresní data pro Česko, Slovensko, Polsko, Německo, Rakousko a Maďarsko. Ve výchozím stavu se našeptává z Česka a Slovenska. Když nezaškrtnete žádnou zemi, hledá se ve všech podporovaných.

Pole u Contact Form 7

Globálně se mapování zadává jako name z CF7 tagu, tedy např. your-street u tagu [text your-street]. Pole ulice je povinné - spouští našeptávání. Ostatní pole jsou volitelná, prázdné se nevyplňuje.

Pro jednotlivý formulář jde mapování přepsat přímo v jeho editoru na záložce Mapy.cz našeptávač. Nabídka obsahuje pole, která formulář opravdu má, plus volby Globální default a — nepoužívat —. Našeptávač se tu dá také zapnout nebo vypnout nezávisle na globálním nastavení.

Vyplňování pole země

Do pole země se zapisuje:

• u <select> (typicky pokladna) ISO kód, který je hodnotou <option> - např. CZ,
• u obyčejného textového pole čitelný název země - např. Česko,
• skrytá pole se nechávají být (aby nevznikl nesoulad mezi UI a odeslanými daty).

V blokové pokladně se adresa zapisuje do datového storu WooCommerce (wc/store/cart), takže se rovnou přepočte i doprava.

Zabezpečení API klíče

API klíč Mapy.cz se používá přímo v prohlížeči, takže je v HTML stránky viditelný - to tak Mapy.cz mají navržené. Aby ho nemohl někdo zneužít na jiném webu, omezte ho ve svém účtu na developer.mapy.com:

• podle referreru (HTTP referer) na doménu vašeho webu, nebo
• podle IP adresy serveru.

Bez omezení může klíč použít kdokoli, kdo ho ze stránky opíše, a vyčerpat vám kredit.

Aktualizace

Plugin není na wordpress.org. Nové verze se hlásí přes Plugin Update Checker, který čte GitHub Releases tohoto repozitáře. Aktualizace se pak nabízí standardně v Nástěnka → Aktualizace.

Licence

GPL-2.0+ - viz gnu.org/licenses/gpl-2.0.txt.