Návod k integraci

Joomla

Našeptávač adres Launify nasadíte do Joomly s VirtueMartem, HikaShopem nebo J2Storem – vložíte skript do hlavičky dětské šablony a namapujete pole košíku.

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

V kostce

  • Našeptávač adres Launify funguje v Joomle 4 i 5 s e-shopovými rozšířeními VirtueMart, HikaShop a J2Store.
  • Kód se vkládá do hlavičky dětské šablony, aby ho nepřepsala aktualizace Joomly.
  • Košík e-shopových rozšíření se vykresluje v aktivní šabloně, takže se skript načte i tam.
  • API klíč funguje jen na doménách, které u něj v administraci Launify povolíte.
  • Celé nastavení včetně mapování polí košíku zabere zhruba 20 minut.

Našeptávač adres pro Joomla od Launify nasadíte vložením krátkého skriptu do hlavičky šablony. 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Č. Postup funguje v Joomle 4 i 5 a nezáleží na tom, jestli e-shop běží na VirtueMartu, HikaShopu nebo J2Storu. V administraci Launify si vytvoříte API klíč, kód vložíte do dětské šablony a namapujete pole adresy v košíku. Celé nastavení zabere zhruba 20 minut.

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

  • 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ší registrace a košík. E-shopová rozšíření Joomly mají pro adresu několik samostatných polí. Po výběru návrhu se doplní najednou.
  • Jedno řešení pro všechna rozšíření. Stejný skript funguje s VirtueMartem, HikaShopem i J2Storem, liší se jen mapování polí.

Co budete potřebovat

  • Účet v administraci Launify na app.launify.com.
  • Přístup do administrace Joomly s oprávněním upravovat šablony.
  • E-shopové rozšíření, například VirtueMart, HikaShop nebo J2Store.
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.
  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

Vytvořte dětskou šablonu

Kód nevkládejte přímo do výchozí šablony Cassiopeia, protože by ho přepsala příští aktualizace Joomly. Pokud už dětskou šablonu používáte, tento krok přeskočte.

  1. V administraci Joomly otevřete Systém → Šablony webu a klikněte na Cassiopeia – detaily a soubory.
  2. Klikněte na Vytvořit dětskou šablonu, zadejte její název a potvrďte.
  3. V Systém → Styly šablon webu nastavte styl dětské šablony jako výchozí.
Krok 3

Vložte našeptávač adres pro Joomla do hlavičky šablony

  1. V Systém → Šablony webu otevřete detaily a soubory své dětské šablony.
  2. Otevřete soubor index.php. Pokud ho dětská šablona ještě nemá, vytvořte jeho přepis (override) z nadřazené šablony.
  3. Najděte uzavírací značku </head> a těsně před ni vložte kód zkopírovaný z Launify.
  4. Klikněte na Uložit a zavřít. Pokud používáte cache, vyprázdněte ji v Systém → Vyčistit cache.

Používáte šablonu třetí strany? Vložte kód do hlavičky jejího index.php stejným způsobem. Mnoho komerčních šablon má v nastavení stylu i vlastní pole pro skripty v hlavičce, které můžete použít místo úpravy souboru.

Krok 4

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.

Každé e-shopové rozšíření pojmenovává pole adresy jinak. Jako výchozí bod poslouží tyto názvy:

RozšířeníUliceMěstoPSČ
J2Storeaddress_1cityzip
HikaShopaddress_streetaddress_cityaddress_post_code
VirtueMartověřte v prohlížeči podle formuláře adresy

Názvy se mohou lišit podle verze rozšíření a vlastních úprav polí, proto je ověřte v prohlížeči: klikněte pravým tlačítkem na pole a zvolte Prozkoumat. HikaShop do atributu name často přidává prefix formuláře, takže se vyplatí mapovat podle id. Když si nebudete vědět rady, napište nám 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Č.

Časté otázky

Funguje našeptávač s VirtueMartem, HikaShopem i J2Storem?

Ano. Všechna tři rozšíření jsou komponenty Joomly a jejich košík se vykresluje uvnitř aktivní šablony webu. Skript vložený do hlavičky šablony se proto načte i na stránkách košíku. Rozdíl je jen v názvech polí adresy, které nastavíte v mapování v administraci Launify.

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

Zhruba 20 minut. Vytvoření API klíče zabere pár minut, založení dětské šablony a vložení kódu do její hlavičky dalších zhruba deset minut a zbytek času připadá na namapování polí košíku. Pokud už dětskou šablonu máte, zvládnete to rychleji.

Proč mám kód vkládat do dětské šablony?

Soubory výchozí šablony Cassiopeia se při aktualizaci Joomly přepisují, takže by se váš kód po aktualizaci ztratil a našeptávač by přestal fungovat. Dětská šablona dědí vzhled i funkce nadřazené šablony, ale vaše úpravy zůstávají zachované. Je to doporučený postup pro veškeré úpravy šablon v Joomle 4 a 5.

Co když používám jednostránkový košík z jiného rozšíření?

Rozšíření pro jednostránkový košík někdy používají vlastní rozložení nebo jiný styl šablony. Zkontrolujte proto ve zdrojovém kódu košíku, že obsahuje skript Launify, a pole adresy namapujte podle skutečných názvů. Pokud se skript na stránce košíku nenačítá, ozvěte se nám a najdeme řešení.

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. Zákazník si jeho načítání na běžných stránkách nevšimne a v košíku mu našeptávač naopak ušetří čas při vyplňování adresy a sníží počet překlepů v doručovacích údajích.

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