Preskočiť na obsah
Platformy

Magento a Adobe Commerce

Ako vložiť kód chatu Otta do pätičky obchodu Magento alebo Adobe Commerce, vymazať cache a čo robiť, keď chat chýba na pokladni.

Na tejto stránke

Magento Open Source a Adobe Commerce sú systémy na väčšie internetové obchody. Kód chatu vložíte v administrácii do pätičky v nastaveniach dizajnu a potom vymažete cache, zaberie to asi 5 minút.

Čo budete potrebovať

  • Účet v Otte. Kód chatu nájdete v paneli v Prehľade, na karte Inštalácia a integrácie, na dlaždici Magento a Adobe Commerce. Je pod dlaždicou Ďalšie platformy, nájdete ju aj vyhľadávaním.
  • Magento Open Source alebo Adobe Commerce na vlastnom serveri alebo v Adobe Commerce v cloude (PaaS), s klasickou témou obchodu.
  • Účet v administrácii s prístupom ku Content, Design, Configuration a ku Cache Management.

Kód chatu

Na dlaždici Magento a Adobe Commerce kliknite na Skopírovať kód. Dostanete jeden riadok s verejným kľúčom vašej firmy:

<script async src="https://ottoai.sk/widget.js" data-otto-key="pk_vas_kluc"></script>
V ukážke je namiesto kľúča pk_vas_kluc, dlaždica vám dá kód s vaším kľúčom. Kľúč nie je heslo, netreba ho tajiť. Kód stačí vložiť raz, platí pre celý web.

Vloženie kódu

  1. V administrácii otvorte Content, Design, Configuration.
  2. V riadku vášho obchodu (store view) kliknite v stĺpci Action na Edit.
  3. V časti Other Settings rozbaľte Footer.
  4. Kód chatu vložte do poľa Miscellaneous HTML. Ak v ňom už nejaký kód je, pridajte riadok pod neho.
  5. Kliknite na Save Configuration.
  6. Otvorte System, Tools, Cache Management a kliknite na Flush Magento Cache.
Od verzie 2.4.7 platí na stránkach platby prísna politika Content-Security-Policy. Chat sa na pokladni ukáže, až keď vývojár pridá https://ottoai.sk do etc/csp_whitelist.xml vlastného modulu. Ostatné stránky majú politiku v predvolenom nastavení len v režime hlásenia a chat tam beží.

Postup nájdete aj v oficiálnej nápovede platformy Magento a Adobe Commerce.

Overenie

  1. Otvorte svoj web v novom okne prehliadača a obnovte stránku. Vpravo dole má naskočiť bublina chatu.
  2. Napíšte do chatu skúšobnú otázku. Otto odpovie o pár sekúnd.
  3. V paneli v Nastaveniach, v časti Prepojenia, riadok Váš web ukáže doménu, na ktorej chat beží.
Pozrite sa aj na pokladňu. Ak je chat všade okrem nej, ide o politiku Content-Security-Policy z upozornenia vyššie.

Katalóg produktov

Feed pre Heureku alebo Google Merchant (XML) vytvorí rozšírenie z Adobe Commerce Marketplace. Adresu feedu nájdete v nastaveniach rozšírenia.

Adresu feedu vložte v paneli v Nastaveniach, v časti Katalóg, a kliknite na Overiť feed. Panel povie, koľko produktov našiel, a Otto si feed potom obnovuje sám. Viac v časti Katalóg produktov.

Keď niečo nefunguje

Chat je všade okrem pokladne

Pokladňa od verzie 2.4.7 púšťa len skripty zo zoznamu povolených zdrojov. Vývojár pridá https://ottoai.sk do etc/csp_whitelist.xml vlastného modulu.

Mám viac obchodov alebo jazykov (store views)

Pole Miscellaneous HTML sa dá nastaviť pre každý store view zvlášť. Kód vložte pri každom, kde má byť chat.

Obchod beží na PWA Studio alebo Edge Delivery Services

Tieto frontendy nastavenia dizajnu z administrácie nepoužívajú a pole Miscellaneous HTML sa na nich neprejaví. Kód vloží vývojár priamo do frontendu, pri Edge Delivery Services do scripts/delayed.js.

Pole Miscellaneous HTML v administrácii nevidím

V Adobe Commerce as a Cloud Service tieto nastavenia dizajnu nie sú a kód vloží vývojár do frontendu. Inak požiadajte správcu o prístup ku Content, Design, Configuration.

Ďalej skontrolujte

  • Obnovte stránku bez cache klávesmi Ctrl+F5 alebo ju otvorte v anonymnom okne.
  • Kód má byť na stránke len raz, druhý sa ignoruje.
  • Lišta súhlasu s cookies môže skripty zablokovať až do súhlasu. Ak sa chat ukáže až po súhlase, pozrite časť Súhlas s cookies.
  • Ak má web hlavičku Content-Security-Policy, povoľte v nej https://ottoai.sk, postup je v časti Content-Security-Policy.
  • V konzole prehliadača (kláves F12) hľadajte správy začínajúce [Otto]. Povedia, čo chatu chýba.
  • Stále nič? Napíšte nám na podpora@ottoai.sk a pošlite adresu webu.

Odstránenie chatu

V Content, Design, Configuration kliknite pri store view na Edit, v Footer zmažte riadok chatu z Miscellaneous HTML a kliknite na Save Configuration. Potom v Cache Management kliknite na Flush Magento Cache.