Návod · Shoptet

Našeptávač adres do Shoptetu za minutu

Přidejte do pokladny vašeho e-shopu na Shoptetu našeptávač českých adres z registru RÚIAN — zákazník napíše ulici, vybere z nabídky a vyplní se ulice s číslem popisným i orientačním, PSČ i město. Jeden řádek kódu, zdarma, bez poplatku za dotaz.

1 Vložte snippet do Editoru

V administraci Shoptetu jděte do Vzhled a obsah → Editor → záložka „HTML kód" a do pole „Záhlaví (před koncovým tagem HEAD)" vložte tento řádek a dejte Uložit:

<script src="https://adresy.shikula.cz/adresy/v1/widget.js" data-preset="shoptet"></script>

A je hotovo. Našeptávač se objeví v pokladně u pole ulice a po výběru vyplní i doručovací i fakturační adresu.

2 Co snippet vyplňuje

data-preset="shoptet" cílí na standardní pole pokladny Shoptetu (fakturační i doručovací adresa):

Pokladna Shoptetu se dokresluje přes AJAX — widget má vlastní MutationObserver, takže pole chytí, jakmile se krok pokladny objeví. Snippet proto může klidně být v globálním záhlaví.

3 Když šablona pole přejmenovala

Pokud váš motiv pole přejmenoval, přepněte z presetu na explicitní selektory (najdete je za 30 sekund: v pokladně F12 → Elements, klikněte na pole a opište jeho name nebo id):

<script src="https://adresy.shikula.cz/adresy/v1/widget.js"
        data-street='input[name="billStreet"]'
        data-zip='input[name="billZip"]'
        data-city='input[name="billCity"]'></script>

4 Volitelně: API klíč zdarma

Funguje i bez klíče. S klíčem dostanete vyšší limity, statistiky a zámek na doménu — vyzvedněte si ho zdarma na portálu a přidejte data-key="pk_…". Atribuce „Shikula" zůstává v patičce našeptávače.