Přeskočit na obsah
Platformy

Drupal

Jak přidat chat Otta na web v Drupalu 10 a 11 modulem Header and Footer Scripts nebo přes motiv a jak pak vymazat mezipaměť.

Na této stránce

Drupal je redakční systém a v administraci nemá pole pro vlastní kód. Chat přidáte modulem Header and Footer Scripts, který přijme celý řádek kódu, nebo ho vývojář vloží do motivu. S nainstalovaným modulem to zabere 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 Drupal. Je pod dlaždicí Další platformy, najdete ji i vyhledáváním.
  • Účet s rolí správce webu nebo s oprávněním Add Scripts all over the site.
  • Modul Header and Footer Scripts. Pokud ho na webu nemáte, stáhne ho vývojář nebo správce serveru přes Composer.

Kód chatu

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

Modul Header and Footer Scripts

  1. Pokud modul ještě nemáte, vývojář ho stáhne příkazem composer require drupal/header_and_footer_scripts.
  2. V administraci otevřete Extend, zaškrtněte Header and Footer Scripts a klikněte na Install.
  3. Otevřete Konfigurace (Configuration), Development, Header Footer Scripts a kartu Footer Scripts.
  4. Kód chatu vložte do pole Footer Scripts a klikněte na Uložit nastavení (Save configuration).
  5. Vymažte mezipaměť: Konfigurace, Development, Performance, Clear all caches.

Motiv (vývojář)

  1. Vývojář zkopíruje šablonu html.html.twig do vlastního motivu nebo podmotivu a kód chatu vloží těsně před </body>.
  2. Nebo do motivu přidá knihovnu s externím skriptem https://ottoai.sk/widget.js, atributy async: true a data-otto-key s klíčem, a připojí ji v .info.yml motivu přes libraries.
  3. Pak vymaže mezipaměť: Konfigurace, Development, Performance, Clear all caches.
Pole Footer Scripts nepřijímá HTML komentáře. Vložte do něj jen řádek kódu z panelu.

Postup najdete i v oficiální nápovědě platformy Drupal.

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ěží.
Modul vkládá kód na všechny stránky, chat proto uvidíte i v administraci Drupalu.

Co Otto ví o vašem webu

Otto odpovídá ze stránek vašeho webu a ze znalostí, které mu přidáte v panelu. Jakmile chat na webu běží, zapněte v panelu v Nastavení, v části Katalog, přepínač Nemám XML feed, Otto si přečte můj web. Více v části Čtení webu.

Když něco nefunguje

Modul v seznamu Extend není

Modul ještě není stažený. Vývojář ho přidá přes Composer, pak se v seznamu ukáže a zapnete ho.

Po uložení se chat na webu neukazuje

Vymažte mezipaměť tlačítkem Clear all caches. Zkontrolujte, jestli je kód v poli Footer Scripts, ne v poli Footer Styles.

Stránku Header Footer Scripts nevidím

Vaše role nemá oprávnění Add Scripts all over the site. Požádejte správce webu, aby vám ho přidělil.

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 poli Footer Scripts kód smažte, uložte a vymažte mezipaměť. Modul pak můžete odinstalovat v Extend, na kartě Uninstall.