Tento návod vás provede kompletní integrací Retino Portálu do vašeho Shoptet e-shopu. Integrace umožní vašim zákazníkům vytvářet reklamace a vracení přímo na vašem webu.
Co budete potřebovat
Přístup do Shoptet adminu s oprávněním upravovat stránky
Přístup do Retino administrace pro zkopírování integračního kódu
Cílovou URL stránky, kde chcete portál zobrazit (např.
/reklamace/)
Krok 1: Získejte integrační kód
Přihlaste se do Retino administrace a přejděte na stránku Nastavení > Integrace. Zde najdete připravený integrační kód pro váš portál.
Integrační kód vypadá takto:
<div id="retino-portal-XXXX"
data-company-id="VÁŠ-COMPANY-ID"
data-language="cs"
data-base-url="https://app.retino.com"
data-form-ids="">
</div>
<script type="text/javascript" id="retino-embedded-form-script">
(function(r,e,t,i,n,o){n=e.createElement(t);n.src=i;n.async=true;o=e.getElementsByTagName(t)[0];o.parentNode.insertBefore(n,o)})(window,document,'script','https://cdn.retino.com/embeddedFormInjector.js')
</script>
Zkopírujte celý kód pomocí tlačítka "Kopírovat". Kód již obsahuje správné data-company-id pro váš účet.
Význam parametrů
Atribut | Význam |
| Libovolný identifikátor, musí být unikátní na stránce |
| Vaše Retino ID (automaticky vyplněno) |
| Kód jazyka ( |
| Ponechte |
| Volitelné; prázdné = výchozí portál se všemi formuláři |
Krok 2: Vytvořte stránku ve Shoptetu
V Shoptet administraci přejděte na Admin → Vzhled a obsah → Stránky
Klikněte na Přidat (nebo otevřete existující stránku, kterou chcete použít)
Vyplňte:
Název: např. "Reklamace a vrácení"
URL adresa (slug): např.
reklamace
Krok 3: Vložte HTML snippet správně
Důležité: Snippet musíte vložit přes zdrojový kód, nikoliv do běžného textového editoru!
V editoru stránky klikněte na Nástroje → Zdrojový kód
Vložte celý integrační kód zkopírovaný z Retino administrace
Klikněte OK pro návrat do editoru
Varování: Nepřidávejte snippet do "normálního" textového režimu. Vždy vložte přes Zdrojový kód, aby se nepřidaly nežádoucí HTML tagy jako <p> , <br> nebo .
Krok 4: Uložte změny
Klikněte na tlačítko ULOŽIT A ODEJÍT pro uložení stránky s integrovaným portálem.
Krok 5: Ověřte funkčnost na frontendu
Otevřete vytvořenou stránku v prohlížeči (např.
www.vas-eshop.cz/reklamace/)Doporučujeme použít anonymní okno prohlížeče pro test bez cache
Zkontrolujte, že se načetl portál s tlačítky pro vrácení a reklamaci
Krok 6: Přidejte odkaz do menu (volitelné)
Pro snadný přístup zákazníků k portálu přidejte odkaz do hlavního menu:
Přejděte na Vzhled a obsah → Menu
Přidejte novou položku menu
Nastavte odkaz na
/reklamace/(nebo vaši zvolenou URL)Pojmenujte položku např. "Reklamace a vrácení"
Nejčastější problémy a jejich řešení
Portál se nezobrazuje
Otevřete znovu Nástroje → Zdrojový kód a ověřte, že snippet není obalen nežádoucími tagy (
<p>,<div>) od WYSIWYG editoruZkontrolujte, že snippet neobsahuje
entityPřípadné obálky a nežádoucí tagy odstraňte
Cache prohlížeče
Vždy testujte v anonymním okně nebo použijte tvrdý refresh (Ctrl+F5 / Cmd+Shift+R)
Vyprázdněte cache prohlížeče
Jiná jazyková verze
V integračním kódu upravte atribut
data-language(např.sk,en)Nebo vytvořte samostatnou stránku pro každou jazykovou mutaci
Jazyk lze nastavit přímo v Nastavení > Integrace před zkopírováním kódu
Testování funkčnosti portálu
Po úspěšné integraci doporučujeme otestovat kompletní funkčnost:
Přejděte na stránku s portálem
Vyberte typ případu (reklamace, vrácení, výměna)
Pro testování použijte:
Číslo objednávky:
TUTORIAL-PORTALE-mail: použijte e-mail vašeho Retino účtu
Dokončete proces vytvoření tiketu
Ověřte, že se tiket objevil v Retino administraci
Potřebujete pomoc?
Pokud narazíte na jakýkoliv problém s integrací, kontaktujte nás na [email protected]. Rádi vám pomůžeme s nastavením nebo vyřešením technických komplikací.