Automaattinen evästekäytäntö ja tietosuojaseloste

Evästekäytännön kirjoittaminen ei ole kenenkään mielestä hauskaa. Käyt evästeesi läpi käsin, laadit seinällisen juridista tekstiä, käännät sen, liität sen sivulle ja toivot, ettei mikään muutu. Juonipaljastus: jotain muuttuu aina. Kehittäjä lisää uuden analytiikkapikselin, markkinointi pudottaa sivulle uudelleenkohdennustagin, ja huolella hiottu käytäntösi on vanhentunut ennen kuin muste on ehtinyt kuivua.

Katla lähestyy asiaa toisin: käytäntösi luodaan todellisista evästeistäsi, jotka skannataan, luokitellaan ja pidetään automaattisesti ajan tasalla.

Kolme muotoa, yksi totuuden lähde

Jokainen Katla-sivusto saa automaattisesti luodut käytännöt kolmessa muodossa:

Taulukkomuoto on erityisen hyödyllinen, jos sinulla on jo tietosuojaseloste ja tarvitset vain tarkan, aina ajantasaisen listan sivustosi evästeistä.

Upota yhdellä koodinpätkällä

Nopein tapa saada käytäntö sivullesi on JavaScript-upotus. Lisää kaksi riviä HTML:ää:

<div id="katla-policy"></div>
<script src="https://cdn.katla.app/{siteId}/policy.js"></script>

Siinä kaikki. Skripti hakee uusimman käytäntösi ja renderöi sen säiliöön. Kun evästeesi muuttuvat, käytäntö päivittyy automaattisesti, eikä uutta julkaisua tarvita.

Muodon valinta

Lisää format-kyselyparametri määrittääksesi, mitä renderöidään:

<!-- Full privacy + cookie policy (default) -->
<script src="https://cdn.katla.app/{siteId}/policy.js"></script>
 
<!-- Cookie policy only -->
<script src="https://cdn.katla.app/{siteId}/policy.js?format=cookie"></script>
 
<!-- Cookie table only -->
<script src="https://cdn.katla.app/{siteId}/policy.js?format=table"></script>

Kielen valinta

Katla tukee valmiiksi 13 kieliversiota: englanti, saksa, ranska, espanja, italia, hollanti, portugali, ruotsi, norja, tanska, puola ja suomi. Valitse kieli kyselyparametrilla:

<script src="https://cdn.katla.app/{siteId}/policy.js?locale=de-DE"></script>

Jos kieltä ei ole määritetty, skripti tunnistaa kävijän selaimen kielen automaattisesti ja käyttää varalla englantia.

Tyylittele omalla tavallasi

Upotus renderöi pelkkää semanttista HTML:ää: otsikoita, kappaleita, taulukoita ja listoja. Mielipiteitä sisältävää CSS:ää ei lisätä, joten se perii oletuksena sivustosi nykyiset tyylit.

Jos haluat enemmän hallintaa, määritä window.KatlaPolicy ennen kuin skripti latautuu, ja liitä CSS-luokat tai inline-tyylit jokaiseen elementtityyppiin.

Tailwindilla tai apuluokilla

<script>
  window.KatlaPolicy = {
    classes: {
      wrapper: "prose prose-slate max-w-none",
      h1: "text-4xl font-bold mb-6",
      h2: "text-2xl font-semibold mt-8 mb-4",
      p: "text-gray-600 leading-relaxed mb-4",
      table: "w-full border-collapse",
      thead: "bg-gray-100",
      th: "text-left p-2 font-medium",
      td: "p-2 border-b",
      a: "text-blue-600 underline hover:text-blue-800",
    }
  };
</script>
<div id="katla-policy"></div>
<script src="https://cdn.katla.app/{siteId}/policy.js"></script>

Inline-tyyleillä

<script>
  window.KatlaPolicy = {
    styles: {
      h1: "font-size: 2rem; color: #111;",
      h2: "font-size: 1.5rem; margin-top: 2rem;",
      p: "color: #444; line-height: 1.6;",
      table: "width: 100%; border-collapse: collapse;",
      th: "text-align: left; padding: 8px; background: #f5f5f5;",
      td: "padding: 8px; border-bottom: 1px solid #eee;",
    }
  };
</script>
<div id="katla-policy"></div>
<script src="https://cdn.katla.app/{siteId}/policy.js"></script>

Voit myös yhdistää molemmat: classes ja styles otetaan käyttöön yhdessä, kun samalle elementille on asetettu kumpikin.

SDK antaa täyden hallinnan

Jos rakennat Reactilla (tai millä tahansa JavaScript-kehyksellä), SDK antaa käytännön raakana markdownina, jonka voit renderöidä miten haluat:

import { createKatlaClient } from "@katla/sdk";
 
const client = createKatlaClient({ siteId: "your-site-id" });
 
// Get the cookie table as markdown
const { markdown } = await client.getPolicy({
  locale: "en-GB",
  format: "table",
});

React-komponentti

@katla/sdk-paketissa on valmis React-komponentti, joka renderöi markdownin GitHub Flavored Markdown -tuella (taulukot, yliviivaus ja niin edelleen):

import { KatlaPolicy } from "@katla/sdk/react";
 
export function CookiePolicyPage({ markdown }: { markdown: string }) {
  return (
    <KatlaPolicy
      markdown={markdown}
      className="prose max-w-3xl mx-auto"
    />
  );
}

Koska komponentti hyväksyy tavalliset react-markdown-komponenttien ohitukset, voit vaihtaa tilalle oman designjärjestelmäsi komponentit:

<KatlaPolicy
  markdown={markdown}
  components={{
    h1: ({ children }) => <Heading size="xl">{children}</Heading>,
    table: ({ children }) => <Table variant="striped">{children}</Table>,
    a: ({ href, children }) => <Link href={href}>{children}</Link>,
  }}
/>

Suorat URL-osoitteet mihin tahansa työnkulkuun

Jokainen käytäntö on saatavilla myös erillisenä tiedostona, mikä on hyödyllistä linkittämiseen, lataamiseen tai hakemiseen mistä tahansa taustajärjestelmästä:

Kaikki URL-osoitteet hyväksyvät samat locale- ja format-kyselyparametrit. Markdown-osoitteella saat raa’an käytännön sisällönhallintajärjestelmään, dokumentaatiosivustolle tai mobiilisovellukseen. JSON-rajapinnalla voit rakentaa täysin oman renderöintilogiikan.

Aina tarkka, aina ajan tasalla

Suurin etu käsin kirjoitettuihin käytäntöihin verrattuna on, että käytäntösi vastaa todellisuutta. Katla skannaa sivustosi headless-selaimella ja havaitsee myös JavaScriptin asettamat evästeet, ei pelkkiä HTTP-otsakkeita. Kun eväste lisätään tai poistetaan, luotu käytäntösi päivittyy vastaamaan tilannetta.

Ei enää vanhentuneita käytäntöjä. Ei enää puuttuvia evästeitä. Ei enää aukkoja vaatimustenmukaisuudessa.

Näin pääset alkuun

1. Rekisteröidy osoitteessa katla.app ja lisää sivustosi
2. Aja skannaus, joka löytää ja luokittelee jokaisen evästeen
3. Määritä yrityksesi tiedot: nimi, yhteyssähköposti ja halutessasi tietosuojavastaavan sähköposti
4. Upota käytäntö koodinpätkällä, SDK:lla tai suoralla URL-osoitteella
5. Unohda koko asia: käytäntösi pysyy ajan tasalla sivustosi kehittyessä

Valmis lopettamaan evästekäytäntöjen ylläpidon käsin? Aloita maksutta.