fydbek Založit účet

fydbek / Návod k instalaci

Jak přidat fydbek na web

Čisté HTML, WordPress, Astro, Next.js, stavebnice a Google Tag Manager. Přísný režim, CSP a kontrola instalace.

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

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.

  1. Stáhněte plugin: fydbek.zip. Odkaz je i v dashboardu v záložce Instalace.
  2. Ve WordPressu ho nahrajte jako nový plugin (v sekci Pluginy tlačítkem Nahrát plugin) a aktivujte.
  3. V Nastavení, fydbek vložte instalační kód (nebo jen klíč projektu) a uložte.
  4. 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.

  1. V GTM otevřete Tagy, klikněte na Nový a jako typ tagu zvolte Vlastní HTML.
  2. Vložte běžný instalační kód z dashboardu (záložka Google Tag Manager). Nic v něm neměňte, atribut data-project musí zůstat.
  3. 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.
  4. Uložte, v Náhledu ověřte, že se tag spustil, a kontejner publikujte.

Na co dát pozor:

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:

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ěží

  1. Otevřete web a na konec adresy připište ?fydbek, třeba https://web-klienta.cz/?fydbek.
  2. Vpravo dole se má ukázat lišta fydbeku. Když nejste přihlášení, uvidíte jen tlačítko Přihlásit do fydbek.
  3. V dashboardu v záložce Instalace můžete kliknout na Ověřit na webu. Dashboard otevře web s ?fydbek a 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

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.

Co dál