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ří čísla. 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 v rohu. Parťák je jeden soubor a rozdělit ho na „nejdřív lišta, zbytek po kliknutí" dnes neumí. 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.

Pro srovnání: 78 kB je řádově jedna fotka na stránce. Přesto si to změřte sami, a to na svém webu, ne podle téhle tabulky — 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 pro skript a api.partaknaweb.cz pro spojení, včetně varianty wss:, kterou asistent používá na živou konverzaci. Bez toho se widget načte a hned zmlkne — v konzoli prohlížeče uvidíte 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