Návod k integraci

Magento 2

Našeptávač adres Launify nasadíte do Magento 2 bez rozšíření – stačí vložit krátký skript do HTML hlavičky a namapovat pole košíku.

Doba implementace
15 min
Způsob nasazení
JS Snippet
Aktualizováno
4. listopadu 2026

V kostce

  • Našeptávač adres Launify se do Magento 2 vkládá bez rozšíření, jen skriptem v nastavení HTML hlavičky.
  • Kód patří do pole Scripts and Style Sheets v sekci Content > Design > Configuration > HTML Head.
  • Po uložení je potřeba vyprázdnit cache v System > Cache Management, jinak se skript nemusí hned projevit.
  • Výchozí košík Magenta používá pro adresu pole street[0], city a postcode; fakturační adresa potřebuje vlastní mapovací skupinu.
  • Celé nastavení včetně mapování košíku zabere zhruba 15 minut.

Našeptávač adres pro Magento 2 (Adobe Commerce) od Launify nasadíte bez instalace rozšíření, jen vložením krátkého skriptu do HTML hlavičky. Launify je našeptávač adres pro e-shopy: zákazník v košíku začne psát ulici, vybere adresu z návrhů a Launify doplní město a PSČ. V Magentu stačí vytvořit API klíč, vložit kód do pole Scripts and Style Sheets, vyprázdnit cache a namapovat pole adresy. Celé nastavení zabere zhruba 15 minut a zvládnete ho bez programátora.

Co našeptávač adres přinese e-shopu na Magentu

  • Méně chybných adres. Zákazník vybírá z existujících adres místo ručního psaní, takže ubude překlepů v ulici, čísle domu i PSČ.
  • Rychlejší vyplnění košíku. Výchozí košík Magenta má pro adresu několik samostatných polí. Po výběru návrhu se doplní najednou, což ocení hlavně zákazníci na mobilu.
  • Čistší data pro dopravce. Správně vyplněné město a PSČ znamenají méně vrácených zásilek a méně ručních oprav objednávek.

Co budete potřebovat

  • Účet v administraci Launify na app.launify.com.
  • Přístup do administrace Magento 2 s oprávněním upravovat nastavení vzhledu (Content > Design).
  • Přístup ke správě cache (System > Cache Management).
Krok 1

Vytvořte API klíč v administraci Launify

  1. Přihlaste se do administrace Launify.
  2. Klikněte na Integrace → Vytvořit klíč.
  3. Vyplňte název klíče a domény vašeho e-shopu, na kterých má klíč fungovat, a klikněte na Uložit. Máte-li více store views na různých doménách, přidejte všechny.
  4. Na řádku s klíčem klikněte na symbol </> a zkopírujte kód z vyskakovacího okna.

Zkopírovaný kód už obsahuje váš API klíč. Vypadá zhruba takto:

<script>
(function(){
  function init() {
    if(window.Launify) return;
    var s = document.createElement("script");
    s.src = "https://cdn.launify.com/launify.min.js?t=" + Date.now();
    s.async = true;
    s.onload = function() {
      try {
        var launifyInstance = new Launify('YOUR_API_KEY_HERE');
        launifyInstance.updateCountry('CZ');
        launifyInstance.init();
      } catch(e) { console.error(e); }
    };
    document.head.appendChild(s);
  }
  if(document.readyState === "loading") {
    document.addEventListener("DOMContentLoaded", init);
  } else {
    init();
  }
})();
</script>

Pokud kód kopírujete odsud, nahraďte YOUR_API_KEY_HERE svým klíčem a v updateCountry('CZ') nastavte cílovou zemi e-shopu (ISO kód, např. SK, PL, HU, DE).

Krok 2

Vložte našeptávač adres pro Magento 2 do HTML hlavičky

  1. V administraci Magenta otevřete Content → Design → Configuration.
  2. U store view (případně website), kde chcete našeptávač používat, klikněte ve sloupci Action na Edit.
  3. Rozbalte sekci HTML Head.
  4. Do pole Scripts and Style Sheets vložte kód zkopírovaný z Launify. Pokud pole už obsahuje jiné skripty, přidejte ho na konec.
  5. Klikněte na Save Configuration.
  6. Otevřete System → Cache Management a klikněte na Flush Magento Cache, aby se změna projevila na webu.

Máte-li více jazykových mutací nebo store views pro různé trhy, vložte kód do každého z nich zvlášť a v updateCountry nastavte odpovídající zemi.

Krok 3

Namapujte pole košíku

V administraci Launify klikněte na Integrace a sjeďte k části Mapování vstupů a výstupů. První mapovací skupina je už připravená, upravte ji podle polí vašeho košíku nebo přidejte další. Pole můžete zadat podle atributu id, name, class nebo data atributu.

Výchozí košík Magento 2 (šablona Luma) používá pro adresu tato pole:

ÚdajAtribut name ve výchozím košíku
Ulice a číslo popisnéstreet[0]
Městocity
PSČpostcode

Doručovací adresa se vyplňuje v prvním kroku košíku. Fakturační adresu Magento zobrazí v kroku platby, když zákazník odškrtne, že je shodná s doručovací. Pole tam mají stejné názvy, proto pro fakturační adresu přidejte druhou mapovací skupinu a rozlište ji podle id nebo nadřazeného formuláře.

Používáte šablonu Hyvä nebo rozšíření pro jednokrokový košík? Názvy polí se mohou lišit, ověřte je v prohlížeči (pravým tlačítkem na pole → Prozkoumat). Když si nebudete vědět rady, napište nám na chat nebo e-mail a mapování nastavíme za vás.

Jak ověřit, že našeptávač funguje

  1. Vložte zboží do košíku a přejděte k vyplňování doručovací adresy.
  2. Začněte psát ulici do pole adresy. Měly by se objevit návrhy adres.
  3. Po výběru návrhu zkontrolujte, že se správně doplnilo město a PSČ.
  4. Pokud používáte odlišnou fakturační adresu, vyzkoušejte i ji v kroku platby.

Časté otázky

Potřebuji pro Magento 2 instalovat nějaké rozšíření?

Ne. Našeptávač adres Launify se do Magento 2 vkládá jen krátkým skriptem v nastavení HTML hlavičky, takže nemusíte instalovat žádné rozšíření, spouštět Composer ani zasahovat do souborů na serveru. Stačí přístup do administrace s oprávněním upravovat nastavení vzhledu a vyprázdnit cache, aby se změna projevila na webu.

Jak dlouho trvá nasazení našeptávače na Magento?

Zhruba 15 minut. Vytvoření API klíče v administraci Launify zabere pár minut, vložení kódu do HTML Head a vyprázdnění cache další pár minut a zbytek času připadá na namapování polí košíku a otestování. U upraveného košíku nebo více store views počítejte s delší dobou na mapování.

Funguje našeptávač i se šablonou Hyvä nebo jednokrokovým košíkem?

Skript se vkládá do hlavičky, takže se načte bez ohledu na použitou šablonu nebo rozšíření košíku. Rozdíl bývá v názvech polí adresy, které nastavíte v mapování v administraci Launify. Pokud se návrhy v upraveném košíku nezobrazí ani po namapování, ozvěte se nám a integraci projdeme společně.

Proč se našeptávač po vložení kódu nezobrazuje?

Nejčastěji jde o nevyprázdněnou cache, doménu e-shopu, která není povolená u API klíče, nebo nenamapovaná pole košíku. Vyprázdněte cache v System, Cache Management, zkontrolujte domény u klíče v administraci Launify a ověřte názvy polí. Pokud to nepomůže, ozvěte se nám a problém projdeme společně.

Zpomalí skript Launify můj e-shop?

Ne výrazně. Skript se načítá asynchronně, takže neblokuje vykreslení stránky. Pokud chcete zátěž minimalizovat úplně, může váš vývojář vložit kód jen na stránku košíku přes layout handle checkout_index_index místo do hlavičky všech stránek. Výsledek pro zákazníka bude stejný a ostatní stránky se skriptem vůbec nezatíží.

Funguje našeptávač i pro jiné země než Českou republiku?

Ano. Cílovou zemi nastavíte v kódu přes funkci updateCountry pomocí dvoupísmenného ISO kódu, například SK pro Slovensko nebo PL pro Polsko. Pokud máte v Magentu více store views pro různé trhy, vložte kód do každého z nich zvlášť a u každého nastavte odpovídající zemi.

Hledáte obecný postup pro jinou platformu? Podívejte se na návod Vlastní integrace nebo na nasazení přes Google Tag Manager. Přehled všech podporovaných platforem najdete v článku Launify teď funguje na více než 20 e-shopových platformách.

Nebudete si vědět rady?

Napište nám a integraci nastavíme společně.

Napsat podpoře

Zdroje