Preskočiť na obsah
Platformy

Drupal

Ako pridať chat Otta na web v Drupale 10 a 11 modulom Header and Footer Scripts alebo cez tému a ako potom vymazať cache.

Na tejto stránke

Drupal je redakčný systém a v administrácii nemá pole na vlastný kód. Chat pridáte modulom Header and Footer Scripts, ktorý prijme celý riadok kódu, alebo ho vývojár vloží do témy. S nainštalovaným modulom to zaberie 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 Drupal. Je pod dlaždicou Ďalšie platformy, nájdete ju aj vyhľadávaním.
  • Účet s rolou správcu webu alebo s oprávnením Add Scripts all over the site.
  • Modul Header and Footer Scripts. Ak ho na webe nemáte, stiahne ho vývojár alebo správca servera cez Composer.

Kód chatu

Na dlaždici Drupal 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

Modul Header and Footer Scripts

  1. Ak modul ešte nemáte, vývojár ho stiahne príkazom composer require drupal/header_and_footer_scripts.
  2. V administrácii otvorte Rozšíriť (Extend), zaškrtnite Header and Footer Scripts a kliknite na Inštalácia (Install).
  3. Otvorte Konfigurácia (Configuration), Vývoj (Development), Header Footer Scripts a kartu Footer Scripts.
  4. Kód chatu vložte do poľa Footer Scripts a kliknite na Uložiť nastavenia (Save configuration).
  5. Vymažte cache: Konfigurácia, Vývoj, Výkon (Performance), Vyprázdniť celú vyrovnávaciu pamäť (Clear all caches).

Téma (vývojár)

  1. Vývojár skopíruje šablónu html.html.twig do vlastnej témy alebo podtémy a kód chatu vloží tesne pred </body>.
  2. Alebo pridá do témy knižnicu s externým skriptom https://ottoai.sk/widget.js, atribútmi async: true a data-otto-key s kľúčom, a pripojí ju v .info.yml témy cez libraries.
  3. Potom vymaže cache: Konfigurácia, Vývoj, Výkon, Vyprázdniť celú vyrovnávaciu pamäť.
Pole Footer Scripts neprijíma HTML komentáre. Vložte doň len riadok kódu z panela.

Postup nájdete aj v oficiálnej nápovede platformy Drupal.

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ží.
Modul vkladá kód na všetky stránky, chat preto uvidíte aj v administrácii Drupalu.

Čo Otto vie o vašom webe

Otto odpovedá zo stránok vášho webu a zo znalostí, ktoré mu pridáte v paneli. Keď chat na webe beží, zapnite v paneli v Nastaveniach, v časti Katalóg, prepínač Nemám XML feed, Otto si prečíta môj web. Viac v časti Čítanie webu.

Keď niečo nefunguje

Modul v zozname Rozšíriť nie je

Modul ešte nie je stiahnutý. Vývojár ho pridá cez Composer, potom sa v zozname ukáže a zapnete ho.

Po uložení sa chat na webe neukazuje

Vymažte cache tlačidlom Vyprázdniť celú vyrovnávaciu pamäť. Skontrolujte, či je kód v poli Footer Scripts, nie v poli Footer Styles.

Stránku Header Footer Scripts nevidím

Vaša rola nemá oprávnenie Add Scripts all over the site. Požiadajte správcu webu, aby vám ho pridelil.

Ď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 poli Footer Scripts kód zmažte, uložte a vymažte cache. Modul potom môžete odinštalovať v Rozšíriť, na karte Odinštalovať (Uninstall).