Evästebanneri- ja evästeasetukset

Evästebanneri tulee näkyviin, kun käyttäjä vierailee Finnassa ensimmäistä kertaa, tai kun käyttäjä on tyhjentänyt selaimessa olevat evästeet. Lisäksi banneri näytetään uudelleen, jos evästekategorioita on lisätty tai poistettu, tai hyväksynnän revisiota on nostettu asetuksissa uusien asetusten myötä. Evästebannerin avulla käyttäjä voi hallita suostumusta evästeiden käyttöön. Käyttäjä voi antaa suostumuksen kaikkien evästeiden käyttöön, välttämättömien evästeiden käyttöön tai tietyn evästekategorian käyttöön. Evästekategoriaan liittyvä suostumus annetaan evästebannerista avautuvassa evästeasetukset-ponnahdusikkunassa.

Evästekategorioita on mahdollista lisätä ja muokata näkymäkohtaisesti. Oletuksena Finnassa on käytössä välttämättömät- ja tilastointievästeet. Välttämättömiä evästeitä käyttäjä ei voi poistaa käytöstä, sillä ilman niitä Finna ei toimi. Tilastointievästeistä käyttäjä voi kieltäytyä, jolloin käyttäjän toimintaa sivuilla ei tallenneta Matomoon (Matomo on Finnan käyttämä käyttäjäseurantaohjelmisto).

Käyttäjän antama suostumus evästeisiin näytetään tietosuojasivulla (Content/privacy).

Evästebannerin käyttöönotto

Evästebannerin käyttöönotto tapahtuu lisäämällä local/config/vufind/config.ini-asetustiedostoon seuraava asetus:

[Cookies]
consent = true

Vanha suostumusilmoitus poistetaan automaattisesti käytöstä, kun uusi banneri otetaan käyttöön. Jos näin ei jostain syystä tapahdu, voi sen kytkeä pois tällä asetuksella (local/config/vufind/config.ini):

[FinnaCookieConsent]
enabled = false

Evästeasetukset

Finnan käyttöliittymässä käyttäjä pääsee evästeasetuksiin evästebannerin kautta, näkymän footerissa olevan "Evästeasetukset"-linkin kautta tai tietosuojasivun kautta (Content/privacy). Evästeasetuksissa käyttäjä voi antaa suostumuksen eri evästekategorioiden näyttämiseen. Evästeasetuksissa käyttäjälle näytetään myös sivustolla käytössä olevat evästeet.

Näkymässä käytössä olevat evästekategoriat määritellään local/config/vufind/config.ini-asetustiedostoon. Oletuksena käytössä on välttämättömät-(essential) ja tilastointievästeet (matomo).

[Cookies]
consent = true
consentCategories = "essential,matomo"

Evästekategorioiden määrittäminen

Näkymäkohtaiset evästekategoriat ja niihin liittyvät evästekategoriat määritellään local/config/vufind/CookieConsent.yaml -tiedostoon. Pohjaksi kannattaa kopioida CookieConsent.yaml.sample -tiedosto, joka sisältää esimerkkimäärityksiä ulkoisille liitännäisille. Eli kopioi CookieConsent.yaml.sample nimelle CookieConsent.yaml, ja tee muutokset tiedostoon CookieConsent.yaml.

Evästekategoriassa määritellään kategorian tunnus (esim. video), otsikko (Title), kuvaus (Description), evästekategorian asettaminen oletuksena päällä (DefaultEnabled) ja evästekategorian määrittäminen välttämättömäksi (Essential). Evästekategoriassa käytetyt evästeet listataan Cookies-määrityksen alle. Yksittäisestä evästeestä pitää määrittää nimi (Name), toimialue (Domain), kuvaus (Description) sekä evästeen erääntyminen (Expiration). Lisäksi evästekategoriaan pitää määrittää evästeiden tyhjentäminen (AutoClearCookies). AutoClearCookies-asetuksen avulla Finna poistaa evästekategoriaan määritelty evästeet käyttäjältä, jos käyttäjä on kieltänyt evästekategorian evästeasetuksissa. Esimerkkejä, oletuskategoriat ja lisätietoa löytyy local/config/finna/CookieConsent.yaml-tiedostosta.

Evästekategorioiden ja evästeiden -kuvaukset sekä otsikot on käänettävissä käännösavainten avulla.

Uuden suostumuksen pyytäminen

Jos evästekategorioihin lisätään uusia evästeitä, tulee käyttäjältä pyytää uusi suostumus. Tämä onnistuu kasvattamalla evästeiden "revisiota" (oletusrevisio on 0) local/config/vufind/config.ini-asetustiedostossa:

[Cookies]
consent = true
consentCategories = "essential,matomo"
consentRevision = 1

Jos muutoksia tulee lisää, vaihdetaan consentRevision-asetukseen 2 jne.

Suostumusdialogi ulkopuolisiin sisältöihin, jotka käyttävät evästeitä

Finnassa on valmiita upokkeita, joiden avulla käyttäjälle kerrotaan, että sisällön näyttämiseen vaaditaan tietyn evästekategorian suostumus. Upokkeita voi käyttää mm. Finnan etu- ja sisältösivuilla. Nykyinen liitännäisen upotuskoodi pitää korvata vastaavalla Finnan upotuskoodilla.

Youtube

Upotuskoodissa määritellään id, tarvittava evästekategoria ja haluttaessa videoelementin leveys ja korkeus css-yksiköissä (esim. px).

<?=$this->iframe()->youtube('5q70TokaSrw', ['video'], '512px', '384px')?>

Ilman koon määritystä:

<?=$this->iframe()->youtube('5q70TokaSrw', ['video'])?>

Vimeo

Upotuskoodissa määritellään id, tarvittava evästekategoria ja haluttaessa videoelementin leveys ja korkeus css-yksiköissä (esim. px).

<?=$this->iframe()->vimeo('255076675', ['video'], '512px', '384px')?>

Ilman koon määritystä:

<?=$this->iframe()->vimeo('255076675', ['vimeo'])?>

Twitter

Upotuskoodissa määritellään seurattava tunnus, tarvittava evästekategoria ja haluttaessa elementin leveys ja korkeus pikseleinä (korkeuden tulee olla vähintään 220):

<?=$this->iframe()->twitterTimeline('eAineistot', ['social'], '480', '320')?>

Ilman koon määritystä:

<?=$this->iframe()->twitterTimeline('eAineistot', ['social'])?>

Muut liitännäiset joille ei ole valmista upoketta

Seuraavan esimerkin mukaisesti voi näyttää liitännäisen ehdollisesti sen perusteella, onko käyttäjä hyväksynyt kategorian.

<?php $cookieConsent = $this->plugin('cookieConsent'); ?>
<?php // Jos cookie consent ei ole käytössä, tai käyttäjä on hyväksynyt video-kategorian, näytetään "supersuper-palvelun" video: ?>
<?php if (!$cookieConsent->isEnabled() || $cookieConsent->isCategoryAccepted('video')): ?>
  <?php // Tähän kohtaan supersuper-palvelun edellyttämä upotuskoodi: ?>
  <iframe width="560" height="315" src="https://supersuper-palvelu/embed/5q70TokaSrw" title="Super Super video player" frameborder="0" allow="fullscreen picture-in-picture"></iframe>
<?php else: ?>    
  <?php // Käyttäjä ei ole hyväksynyt video-kategoriaa, näytetään linkkilaatikko upokkeen sijaan: ?>
  <?=$this->iframe()->renderLinkBox('https://supersuper-palvelu/video/5q70TokaSrw', ['video'])?>
<?php endif; ?>

Linkkilaatikon sijaan voi myös näyttää vaikka vain viestin siitä, ettei tarvittavia evästeitä ole hyväksytty:

<?php $cookieConsent = $this->plugin('cookieConsent'); ?>
<?php // Jos cookie consent ei ole käytössä, tai käyttäjä on hyväksynyt video-kategorian, näytetään "supersuper-palvelun" video: ?>
<?php if (!$cookieConsent->isEnabled() || $cookieConsent->isCategoryAccepted('video')): ?>
  <?php // Tähän kohtaan supersuper-palvelun edellyttämä upotuskoodi: ?>
  <iframe width="560" height="315" src="https://supersuper-palvelu/embed/5q70TokaSrw" title="Super Super video player" frameborder="0" allow="fullscreen picture-in-picture"></iframe>
<?php else: ?>    
  <?php // Käyttäjä ei ole hyväksynyt video-kategoriaa, näytetään viesti: ?>
  <p>
    <?=$this->transEsc('Video cannot be displayed due to missing cookie consent.')?>
<?php endif; ?>

Esimerkki: videokategorian lisäys evästeasetuksiin ja videon upottaminen sisältösivulle (YouTube-video)

Kopioi CookieConsent.yaml.sample nimelle CookieConsent.yaml. Tarkista että video-kategoria on määritelty.

Lisää config.ini:iin video-kategoria:

[Cookies]
consent = true
consentCategories = "essential,matomo,video"

Voit upottaa videon phtml-tiedostoon seuraavalla koodilla. Upotuskoodissa määritellään videon id, käytettävä evästekategoria sekä leveys ja korkeus pikseleinä.

<?=$this->iframe()->youtube('5q70TokaSrw', ['video'], '512px', '384px')?>

Videon katsomiseen sivulla vaaditaan, että käyttäjä on hyväksynyt video-evästeet taikka kaikki sivun evästeet. Jos käyttäjä ei ole hyväksynyt tarvittavia evästeitä, näytetään suostumusikkuna, josta on myös mahdollista siirtyä katsomaan video YouTube-palvelussa.

Lisätietoa aiheesta

https://vufind.org/wiki/configuration:cookie_consent (VuFindin ohje)

https://www.traficom.fi/sites/default/files/media/file/Ev%C3%A4steohjeistus_palveluntarjoajille.pdf (Traficomin evästeohjeistus palveluntarjoajille)