AI chatbot pro WordPress

Postup krok za krokem

1. Připravte podklady. Nechte asistenta načíst obsah webu a doplňte dokumenty, ze kterých má odpovídat — ceník, podmínky, popisy služeb.
2. Zkopírujte skript. V administraci Parťáka najdete krátký skript pro vložení na web.
3. Vložte ho do hlavičky. Podrobnosti ke třem možným cestám jsou níže.
4. Vyprázdněte mezipaměť. Web i síť. Bez tohoto kroku uvidíte starou verzi stránky.
5. Ověřte a zveřejněte. Projděte odpovědi v neveřejném náhledu a ověřte načtení na několika typech stránek.

Kam skript vložit

Vypadá takhle — jeden řádek, žádná knihovna navíc:

<script async src="https://app.partaknaweb.cz/widget.js"
        data-agent-id="vas-identifikator"></script>

Nekopírujte ho odsud. Svůj vlastní, i s vyplněným identifikátorem, najdete v administraci Parťáka — tenhle je tu jen proto, abyste věděli, co hledáte a jak je to velké. Atribut async je podstatný: kvůli němu skript nebrzdí vykreslení stránky.

Přes nastavení šablony

Většina moderních šablon má v nastavení pole pro vlastní kód v hlavičce. Je to nejjednodušší cesta a přežije aktualizaci šablony.

Přes doplněk pro vkládání kódu

Pokud vaše šablona vlastní kód neumožňuje, použijte lehký doplněk určený právě k vkládání skriptů do hlavičky. Je to výrazně méně kódu než plnohodnotný doplněk pro chat.

Přes soubor funkcí potomkovské šablony

Technicky nejčistší cesta: skript se připojí na háček wp_head v souboru functions.php potomkovské šablony. Nikdy neupravujte soubory rodičovské šablony — aktualizace je přepíše.

add_action( 'wp_head', function () {
    ?>
    <script async src="https://app.partaknaweb.cz/widget.js"
            data-agent-id="vas-identifikator"></script>
    <?php
} );

Pokud asistenta nechcete v administraci, obalte výpis podmínkou if ( is_admin() ) { return; }. Na většině webů to nic nemění, protože wp_head se v administraci stejně nevolá, ale u některých šablon a stavitelů stránek ano.

Mezipaměť a slučování skriptů

Tohle je zdaleka nejčastější příčina „nefunguje to".

• Mezipaměť webu. Po vložení skriptu ji vyprázdněte celou, ne jen pro jednu stránku.
• Mezipaměť na síti. Pokud web běží za sítí pro doručování obsahu, vyprázdněte i tu.
• Slučování a odkládání skriptů. Doplňky pro zrychlení webu často skripty slučují do jednoho souboru nebo je odkládají až po interakci. Skript asistenta z tohoto zpracování vyjměte — obvykle jde přidat na seznam výjimek.
• Mezipaměť prohlížeče. Při testování používejte anonymní okno, ať netestujete starou verzi.

Vliv na rychlost webu

Rychlost je u WordPressu oprávněná obava, tak sem místo ujišťování patří přesný výčet. Tohle si stáhne návštěvník vašeho webu, když se stránka načte:

Řekněme to na rovinu: stahuje se celé rozhraní, ne jen ta lištička. Vložený skript je jen malý zavaděč, rozhraní si ale stáhne hned, ne až po kliknutí na lištu. Co ale platí, je to podstatnější: skript je vložený s async, takže neblokuje vykreslení stránky a nevstupuje do doby, za kterou se návštěvníkovi objeví obsah. Stahuje se vedle, ne místo.

Kolik to je kilobajtů, si změřte sami, a to na svém webu, ne podle obecného čísla — u vlastní šablony a sady doplňků se realita liší web od webu. Nejrychlejší cesta je vývojářský panel prohlížeče, záložka Síť: načtěte stránku před vložením a po něm a porovnejte přenesené kilobajty a dobu do vykreslení.

Konflikty se šablonou

Widget běží v izolovaném prostoru stránky, takže si styly nemíchá se šablonou ani naopak. V praxi zbývají dva případy, které stojí za kontrolu:

• Prvky ukotvené u spodního okraje. Lišta se souhlasem s cookies nebo tlačítko zpět nahoru se mohou překrývat s lištou asistenta. Řeší se posunutím jednoho z nich.
• Přísná bezpečnostní pravidla stránky. Pokud má web nastavenou zásadu zabezpečení obsahu, doplňte mezi povolené zdroje app.partaknaweb.cz do script-src i do connect-src (odtud si widget stahuje styly) a api.partaknaweb.cz do connect-src, včetně varianty wss:, kterou asistent používá na živou konverzaci. Bez app.partaknaweb.cz v connect-src se widget vůbec nevykreslí, bez api.partaknaweb.cz se načte a hned zmlkne — v obou případech uvidíte v konzoli prohlížeče zablokované spojení.

Na WordPressu tuhle zásadu obvykle nenastavuje šablona, ale bezpečnostní doplněk. Hledejte v jeho nastavení „Content Security Policy" a upravte řádky script-src a connect-src.

Časté dotazy