Přeskočit na obsah
Platformy

Magento a Adobe Commerce

Jak vložit kód chatu Otto do patičky obchodu Magento nebo Adobe Commerce, vymazat mezipaměť a co dělat, když chat chybí v pokladně.

Na této stránce

Magento Open Source a Adobe Commerce jsou systémy pro větší internetové obchody. Kód chatu vložíte v administraci do patičky v nastavení designu a pak vymažete mezipaměť, zabere to asi 5 minut.

Co budete potřebovat

  • Účet v Ottovi. Kód chatu najdete v panelu v Přehledu, na kartě Instalace a integrace, na dlaždici Magento a Adobe Commerce. Je pod dlaždicí Další platformy, najdete ji i vyhledáváním.
  • Magento Open Source nebo Adobe Commerce na vlastním serveru nebo v Adobe Commerce v cloudu (PaaS), s klasickým motivem obchodu.
  • Účet v administraci s přístupem ke Content, Design, Configuration a ke Cache Management.

Kód chatu

Na dlaždici Magento a Adobe Commerce klikněte na Zkopírovat kód. Dostanete jeden řádek s veřejným klíčem vaší firmy:

<script async src="https://ottoai.sk/widget.js" data-otto-key="pk_vas_kluc"></script>
V ukázce je místo klíče pk_vas_kluc, dlaždice vám dá kód s vaším klíčem. Klíč není heslo, netřeba ho tajit. Kód stačí vložit jednou, platí pro celý web.

Vložení kódu

  1. V administraci otevřete Content, Design, Configuration.
  2. V řádku vašeho obchodu (store view) klikněte ve sloupci Action na Edit.
  3. V části Other Settings rozbalte Footer.
  4. Kód chatu vložte do pole Miscellaneous HTML. Pokud v něm už nějaký kód je, přidejte řádek pod něj.
  5. Klikněte na Save Configuration.
  6. Otevřete System, Tools, Cache Management a klikněte na Flush Magento Cache.
Od verze 2.4.7 platí na stránkách platby přísná politika Content-Security-Policy. Chat se v pokladně ukáže, až když vývojář přidá https://ottoai.sk do etc/csp_whitelist.xml vlastního modulu. Ostatní stránky mají politiku ve výchozím nastavení jen v režimu hlášení a chat tam běží.

Postup najdete i v oficiální nápovědě platformy Magento a Adobe Commerce.

Ověření

  1. Otevřete svůj web v novém okně prohlížeče a obnovte stránku. Vpravo dole má naskočit bublina chatu.
  2. Napište do chatu zkušební otázku. Otto odpoví za pár sekund.
  3. V panelu v Nastavení, v části Propojení, řádek Váš web ukáže doménu, na které chat běží.
Podívejte se i do pokladny. Pokud je chat všude kromě ní, jde o politiku Content-Security-Policy z upozornění výše.

Katalog produktů

Feed pro Heureku nebo Google Merchant (XML) vytvoří rozšíření z Adobe Commerce Marketplace. Adresu feedu najdete v nastavení rozšíření.

Adresu feedu vložte v panelu v Nastavení, v části Katalog, a klikněte na Ověřit feed. Panel řekne, kolik produktů našel, a Otto si feed pak obnovuje sám. Více v části Katalog produktů.

Když něco nefunguje

Chat je všude kromě pokladny

Pokladna od verze 2.4.7 pouští jen skripty ze seznamu povolených zdrojů. Vývojář přidá https://ottoai.sk do etc/csp_whitelist.xml vlastního modulu.

Mám více obchodů nebo jazyků (store views)

Pole Miscellaneous HTML se dá nastavit pro každý store view zvlášť. Kód vložte u každého, kde má být chat.

Obchod běží na PWA Studio nebo Edge Delivery Services

Tyto frontendy nastavení designu z administrace nepoužívají a pole Miscellaneous HTML se na nich neprojeví. Kód vloží vývojář přímo do frontendu, u Edge Delivery Services do scripts/delayed.js.

Pole Miscellaneous HTML v administraci nevidím

V Adobe Commerce as a Cloud Service tato nastavení designu nejsou a kód vloží vývojář do frontendu. Jinak požádejte správce o přístup ke Content, Design, Configuration.

Dále zkontrolujte

  • Obnovte stránku bez mezipaměti klávesami Ctrl+F5 nebo ji otevřete v anonymním okně.
  • Kód má být na stránce jen jednou, druhý se ignoruje.
  • Lišta souhlasu s cookies může skripty zablokovat až do souhlasu. Pokud se chat ukáže až po souhlasu, podívejte se do části Souhlas s cookies.
  • Pokud má web hlavičku Content-Security-Policy, povolte v ní https://ottoai.sk, postup je v části Content-Security-Policy.
  • V konzoli prohlížeče (klávesa F12) hledejte zprávy začínající [Otto]. Řeknou, co chatu chybí.
  • Pořád nic? Napište nám na podpora@ottoai.sk a pošlete adresu webu.

Odstranění chatu

V Content, Design, Configuration klikněte u store view na Edit, ve Footer smažte řádek chatu z Miscellaneous HTML a klikněte na Save Configuration. Pak v Cache Management klikněte na Flush Magento Cache.