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).
Vytvořte API klíč v administraci Launify
- Přihlaste se do administrace Launify.
- Klikněte na Integrace → Vytvořit klíč.
- 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.
- 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).
Vložte našeptávač adres pro Magento 2 do HTML hlavičky
- V administraci Magenta otevřete Content → Design → Configuration.
- U store view (případně website), kde chcete našeptávač používat, klikněte ve sloupci Action na Edit.
- Rozbalte sekci HTML Head.
- 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.
- Klikněte na Save Configuration.
- 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.
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:
| Údaj | Atribut name ve výchozím košíku |
|---|---|
| Ulice a číslo popisné | street[0] |
| Město | city |
| 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
- Vložte zboží do košíku a přejděte k vyplňování doručovací adresy.
- Začněte psát ulici do pole adresy. Měly by se objevit návrhy adres.
- Po výběru návrhu zkontrolujte, že se správně doplnilo město a PSČ.
- 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ě.