V kostce
- Našeptávač adres Launify se do OpenCartu vkládá přes vestavěný Theme Editor, bez úprav souborů na serveru.
- Kód patří do šablony common/header před uzavírací značku </head>.
- Úprava v Theme Editoru se ukládá jako přepis šablony, takže ji jde kdykoli vypnout přepínačem Status.
- Po uložení je vhodné vyprázdnit cache šablon, jinak se změna nemusí hned projevit.
- Celé nastavení včetně mapování košíku zabere zhruba 15 minut.
Našeptávač adres pro OpenCart od Launify nasadíte bez instalace modulu. 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 OpenCartu vložíte krátký skript do šablony hlavičky přes vestavěný Theme Editor a namapujete pole adresy v košíku. Postup funguje pro OpenCart 3 i 4 a celé nastavení zabere zhruba 15 minut.
Co našeptávač adres přinese e-shopu na OpenCartu
- 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Č.
- Kratší košík. Výchozí košík OpenCartu má několik kroků a polí pro adresu. Po výběru návrhu se adresa vyplní najednou.
- Bez modulu a FTP. Skript vložíte přes Theme Editor a v OpenCartu 4 ho můžete kdykoli vypnout jedním přepínačem.
Co budete potřebovat
- Účet v administraci Launify na app.launify.com.
- Přístup do administrace OpenCartu s oprávněním k sekci Design.
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.
- 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 OpenCart do šablony hlavičky
- V administraci OpenCartu otevřete Design → Theme Editor.
- V OpenCartu 4 klikněte na Add New, vyberte obchod a v nabídce Choose Template zvolte
common/header. V OpenCartu 3 vyberte šablonu vzhledu a souborcommon/header.twig. - V editoru najděte uzavírací značku
</head>a těsně před ni vložte kód zkopírovaný z Launify. - V OpenCartu 4 nastavte Status na Enabled.
- Klikněte na Save.
- Pokud máte zapnuté ukládání šablon do cache, vyprázdněte ji. V OpenCartu 4 je nastavení cache šablon v System → Settings → Server, v OpenCartu 3 v nastavení pro vývojáře (ikona ozubeného kola na nástěnce).
Používáte-li šablonu třetí strany, vyberte v Theme Editoru hlavičku právě této šablony. Pokud šablona hlavičku nepoužívá standardně, obraťte se na jejího autora nebo na nás.
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 OpenCartu používá pro adresu tyto atributy name:
| Údaj | Atribut name ve výchozím košíku |
|---|---|
| Ulice a číslo domu | address_1 |
| Město | city |
| PSČ | postcode |
Fakturační (payment) a doručovací (shipping) adresa jsou v košíku OpenCartu samostatné formuláře se stejnými názvy polí. Pro každou proto přidejte vlastní mapovací skupinu a rozlište je podle id pole. Moduly rychlého košíku mohou názvy přejmenovat, takže si je ověřte 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Č.
- Vyzkoušejte i fakturační adresu, pokud se v košíku vyplňuje zvlášť.
Časté otázky
Potřebuji pro OpenCart instalovat modul?
Ne. Našeptávač adres Launify se do OpenCartu vkládá krátkým skriptem přes vestavěný Theme Editor, takže nemusíte instalovat modul ani nahrávat soubory na server přes FTP. Úprava se uloží jako přepis šablony hlavičky a v OpenCartu 4 ji můžete kdykoli vypnout přepínačem Status bez mazání kódu.
Jak dlouho trvá nasazení našeptávače na OpenCart?
Zhruba 15 minut. Vytvoření API klíče v administraci Launify zabere pár minut, vložení kódu do hlavičky přes Theme Editor a vyprázdnění cache další pár minut a zbytek času připadá na namapování doručovací i fakturační adresy. S modulem rychlého košíku počítejte s delším mapováním.
Přepíše se vložený kód při aktualizaci šablony?
Theme Editor ukládá upravenou šablonu jako samostatný přepis, nikoli přímo do souboru šablony, takže aktualizace souborů ho běžně nepřepíše. Pokud ale přejdete na úplně jinou šablonu vzhledu, je potřeba kód vložit znovu do hlavičky nové šablony. Po každé větší změně vzhledu proto našeptávač v košíku rychle otestujte.
Funguje našeptávač i s moduly rychlého košíku?
Většinou ano, protože skript se načítá v hlavičce všech stránek včetně košíku. Moduly rychlého nebo jednostránkového košíku ale často mění názvy a atributy polí formuláře. V takovém případě stačí upravit mapování v administraci Launify podle skutečných polí. Pokud si nevíte rady, mapování rádi nastavíme za vás.
Zpomalí skript Launify můj e-shop?
Ne výrazně. Skript se načítá asynchronně, takže neblokuje vykreslení stránky, a je optimalizovaný na rychlost. Pokud chcete zátěž minimalizovat úplně, může váš vývojář vložit kód jen do šablony košíku místo do hlavičky všech stránek. Pro zákazníka bude výsledek stejný, jen se skript nenačte jinde.
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ě.