fydbek je widget, přes který klienti, grafici, copywriteři a testeři píšou připomínky přímo na stránce. Na web se přidává jedním řádkem kódu v hlavičce. Lištu uvidí jen lidé, které pozvete e-mailem nebo jim pošlete odkaz pro připomínky. Běžným návštěvníkům se nic neukáže.
Na stránce:
- Než začnete
- Čisté HTML a PHP šablony
- WordPress
- Astro
- Next.js a React
- Webflow, Shoptet a další stavebnice
- Google Tag Manager
- Instalace přes AI agenta
- Přísný režim
- Content-Security-Policy
- Jak ověřit, že widget běží
- Lišta se neukázala
Než začnete
Přihlaste se na app.fydbek.com (magic linkem nebo přes Google) a založte organizaci a první projekt. Projekt odpovídá jednomu webu. Instalační kód najdete v nastavení projektu v záložce Instalace. Ukáže se i hned v onboardingu.
Povolené weby
Widget poběží jen na adresách, které má projekt v záložce Povolené weby. Přidejte všechny, kde chcete sbírat připomínky, třeba produkci i staging. Pro subdomény vlastní domény jde použít hvězdičku, například https://*.staging.web-klienta.cz. U sdílených hostingů jako vercel.app nebo netlify.app zadejte konkrétní adresu, hvězdička tam povolená není. Bez https jde jen lokální vývoj: localhost, *.test a *.ddev.site.
Čisté HTML a PHP šablony
Vložte kód do hlavičky (<head>) každé stránky. Ve fydbeku zkopírujete přesně ten svůj, tady je jen ukázka s vymyšleným klíčem:
<script src="https://cdn.fydbek.com/loader.js" data-project="fyd_pk_..." async></script>
Klíč fyd_pk_ je veřejný. Jen říká, ke kterému projektu web patří, a sám nic neopravňuje. Skript se načítá asynchronně a stránku neblokuje. Běžný návštěvník stáhne jen malý loader. Samotný widget se stáhne až člověku, který je do fydbeku přihlášený nebo přišel z pozvánky či odkazu pro připomínky.
Když má web společnou šablonu hlavičky (třeba header.php), stačí kód vložit jednou tam.
WordPress
Na WordPressu nemusíte sahat do šablony. Stačí plugin fydbek.
- Stáhněte plugin: fydbek.zip. Odkaz je i v dashboardu v záložce Instalace.
- Ve WordPressu ho nahrajte jako nový plugin (v sekci Pluginy tlačítkem Nahrát plugin) a aktivujte.
- V Nastavení, fydbek vložte instalační kód (nebo jen klíč projektu) a uložte.
- Ověřte, že adresa webu je mezi povolenými weby projektu.
Plugin vkládá loader do hlavičky stránek, ne do RSS feedů ani embedů. V nastavení vyberete, komu se má načítat: všem (doporučeno, klienti pak nepotřebují účet ve WordPressu), nebo jen uživatelům přihlášeným do WordPressu. V horní liště WordPressu přibude položka fydbek, která otevře lištu na stránce, kde zrovna jste.
V multisite má každý web vlastní nastavení, takže každý může patřit k jinému projektu. Nové verze pluginu se ukážou ve WordPressu mezi aktualizacemi jako u jiných pluginů. Plugin potřebuje WordPress 6.3 a PHP 7.4 nebo novější.
Přísný režim plugin neumí. Kdo ho na WordPressu chce, vloží přísný kód přes plugin pro vlastní kód v hlavičce (třeba WPCode), nebo do header.php šablony.
Astro
Vložte kód do <head> ve společném layoutu (obvykle src/layouts/*.astro). Přidejte is:inline, ať ho Astro nechá být a nezpracovává ho jako svůj skript:
<script is:inline src="https://cdn.fydbek.com/loader.js" data-project="fyd_pk_..." async></script>
U přísného kódu je is:inline nutnost. Bez něj Astro skript zabalí a změní, a hash v CSP pak nesedí. Přímo nad tag dejte <!-- prettier-ignore -->, aby ho nepřeformátoval Prettier. Když CSP generuje Astro (security.csp), hash patří do scriptDirective.hashes a https://cdn.fydbek.com do scriptDirective.resources.
Next.js a React
Nejjednodušší je npm balíček fydbek. Vloží stejný loader jako HTML kód, nic víc.
npm install fydbek
// app/layout.tsx
import { Fydbek } from 'fydbek/react';
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="cs">
<body>
{children}
<Fydbek projectKey="fyd_pk_..." />
</body>
</html>
);
}
Komponenta nic nevykresluje a loader přidá jen jednou, i pod StrictMode. Když chcete fydbek jen na stagingu, použijte prop disabled, třeba s proměnnou prostředí. Bez Reactu je tu funkce loadFydbek({ projectKey: 'fyd_pk_...' }) z balíčku fydbek.
Bez balíčku jde v Next.js použít next/script se strategy="afterInteractive". Atributy data-* nechte, jak jsou.
Přísný kód do Next.js patří jinak: do <head> kořenového layoutu (nebo pages/_document) jako <script dangerouslySetInnerHTML={{ __html: '...' }} />. Přes next/script ho nevkládejte.
Webflow, Shoptet a další stavebnice
Stavebnice mají v nastavení webu pole pro vlastní kód v hlavičce. Vložte do něj instalační kód celý a uložte, případně web znovu publikujte. Když stavebnice vlastní kód v hlavičce nedovolí, widget na ní nerozjedete.
Google Tag Manager
Když web klienta už má Google Tag Manager, přidáte fydbek bez vývojáře a bez zásahu do kódu webu. Stačí přístup do kontejneru GTM.
- V GTM otevřete Tagy, klikněte na Nový a jako typ tagu zvolte Vlastní HTML.
- Vložte běžný instalační kód z dashboardu (záložka Google Tag Manager). Nic v něm neměňte, atribut
data-projectmusí zůstat. - Jako spouštěč vyberte Initialization - All Pages. Tag se spustí co nejdřív a fydbek zachytí víc chyb z načítání stránky. Stačí i běžné All Pages.
- Uložte, v Náhledu ověřte, že se tag spustil, a kontejner publikujte.
Na co dát pozor:
- Přes GTM vkládejte jen běžný kód. Přísný režim patří přímo do hlavičky webu, GTM by jeho inline skript vložil po svém a hash v CSP by neseděl.
- Pokud kontejner používá nastavení souhlasu (Consent Mode), nastavte u tagu Nevyžaduje další souhlas. fydbek běžné návštěvníky nesleduje a nic jim nestahuje kromě malého loaderu.
- Chyby, které vzniknou dřív, než se GTM načte, fydbek nezachytí. Když na nich záleží, dejte kód přímo do hlavičky.
- Web s CSP musí povolit adresy fydbeku stejně jako u běžné instalace, viz Content-Security-Policy. S
'strict-dynamic'se loader načtený přes GTM povolí sám,connect-srcje potřeba přidat i tak.
Instalace přes AI agenta
Máte web v repozitáři? Pod instalačním kódem v dashboardu je záložka AI agent s hotovým promptem pro Claude Code, Cursor nebo Codex. Zkopírujte ho do agenta otevřeného v projektu webu. Agent najde společný layout, vloží kód do <head> beze změn a do CSP přidá jen to, co widget potřebuje. 'unsafe-inline' nepřidává. Nakonec napíše, který soubor upravil a jestli web má CSP. Prompt existuje i pro přísný režim.
Přísný režim
Přísný režim je pro web, který už běží naostro. Návštěvníci si od fydbeku nestáhnou vůbec nic, ani loader. Místo odkazu na skript vložíte malý inline skript, který loader přidá jen tehdy, když na stránku přijde někdo pozvaný: s kódem z odkazu fydbeku v adrese (pozvánka, tlačítko Otevřít na webu), s ?fydbek v adrese, s uloženým přihlášením do fydbeku nebo s rozšířením fydbek pro Chrome.
Zapíná se přepínačem Přísný režim v záložce Instalace. Když si nejste jistí, nechte ho vypnutý. Ani běžný kód návštěvníkům nic neukáže.
Na co dát pozor:
- Kód vložte celý a nic v něm neměňte, ani mezery. Web na něj může mít hash v CSP a ten sedí jen na přesný text.
- Pozor na formátovače a minifikaci HTML (Prettier, Biome a podobně). Když by obsah skriptu přepsaly, přidejte výjimku.
- Po vygenerování nového klíče se změní kód i hash. Vyměňte obojí.
- Přísný kód se sám neaktualizuje. Má ho web u sebe, dokud ho nevyměníte.
Content-Security-Policy
Když web žádnou CSP nenastavuje, tuhle část přeskočte.
Pro běžný kód přidejte:
script-src https://cdn.fydbek.com
connect-src https://api.fydbek.com wss://api.fydbek.com
Pro přísný kód přidejte do script-src i hash. Přesnou hodnotu ukáže dashboard pod přísným kódem v části Pro vývojáře:
script-src 'sha256-...' https://cdn.fydbek.com
connect-src https://api.fydbek.com wss://api.fydbek.com
'unsafe-inline' ve script-src widget nepotřebuje. Nepoužívá eval ani inline skripty a styly si vkládá do Shadow DOM přes adoptedStyleSheets, na které se style-src nevztahuje.
Jedna výjimka jsou screenshoty. Widget je bez rozšíření pořizuje z kopie stránky a to pod style-src bez 'unsafe-inline' nejde. Připomínka se pak uloží bez snímku, s důvodem. Přesný snímek obrazovky pořídí rozšíření fydbek pro Chrome. Jestli 'unsafe-inline' do style-src přidat, je na majiteli webu.
Hlasové komentáře potřebují mikrofon. Když ho web zakáže v hlavičce Permissions-Policy, widget tlačítko mikrofonu skryje.
Jak ověřit, že widget běží
- Otevřete web a na konec adresy připište
?fydbek, třebahttps://web-klienta.cz/?fydbek. - Vpravo dole se má ukázat lišta fydbeku. Když nejste přihlášení, uvidíte jen tlačítko Přihlásit do fydbek.
- V dashboardu v záložce Instalace můžete kliknout na Ověřit na webu. Dashboard otevře web s
?fydbeka počká, až se widget ozve. Pak ukáže, na jakém webu běží a kdy se ozval naposledy.
U přísného režimu zkontrolujte i opačný případ. Bez ?fydbek web vypadá jako dřív a v záložce Network vývojářských nástrojů není žádný request na cdn.fydbek.com.
Lišta se neukázala
- Adresa není mezi povolenými weby. Widget běží jen tam, kde to projekt dovolí. Pozor na rozdíl mezi
wwwa bezwww. - Někdo kód při vkládání upravil. Hlavně u přísného kódu stačí jedna mezera a hash v CSP přestane sedět. Prohlížeč pak skript potichu zablokuje.
- Web má CSP bez adres fydbeku. Doplňte hodnoty z části Content-Security-Policy. Chybu najdete v konzoli prohlížeče.
- Cache. Po vložení kódu promažte cache webu nebo CDN, ať se nová hlavička opravdu dostane ven.
Když si nevíte rady, pošlete vývojáři část Pro vývojáře z dashboardu, nebo prompt ze záložky AI agent. Případně napište na hello@fydbek.com.