Iubenda logo
Aan de slag

Documentatie

Inhoud

Privacy Controls and Cookie Solution – Joomla! plug-in Installatiegids

Met de Joomla! plug-in van iubenda kun je de implementatie van de cookiewetgevingsregels automatiseren, waardoor de noodzaak voor directe ingrepen in de code van de site drastisch wordt verminderd.

Let op
  • De plug-in is rechtstreeks te downloaden van de officiële Joomla! Extensions Directory
  • De plug-in vereist Joomla! 2.5 of hoger
  • De plug-in werkt beter met versies van PHP 5.3 of hoger
iubenda Cookie Solution voor Joomla!

Functionaliteit

  • De plug-in voegt automatisch de iubenda-code toe aan alle pagina’s van een site (aan het onderdeel HEAD).
  • Hiermee kun je scripts die cookies kunnen installeren automatisch of handmatig blokkeren voordat hiervoor toestemming is gegeven, zonder dat je direct de code hoeft te wijzigen.
  • Activeert cookiescripts asynchroon opnieuw zodra toestemming is verkregen.
  • Regelt de weergave van de cookiebanner/toestemmingsbanner en het cookiebeleid, zodat je de banner volledig kunt aanpassen aan het uiterlijk en de kleuren van je site.
  • Slaat gebruikersvoorkeuren over het gebruik van cookies op en toont een schone pagina (zonder banner) aan gebruikers die al toestemming hebben gegeven.
  • Integreert met het Transparency and Consent Framework van het IAB.
  • Functies met een gebruiksvriendelijke interface voor het invoeren van aangepaste scripts en iframes.
  • Detecteert bots/spiders en geeft ze een schone pagina zodat je SEO-inspanningen nooit in gevaar komen.
  • Ondersteunt de automatische toewijzing van categorieën bij het blokkeren van scripts.
  • Met de functie voor externe configuratie kunnen de meeste wijzigingen die je in de configurator maakt, direct op je website worden toegepast zonder dat je de code opnieuw hoeft in te sluiten.
  • AdRoll
  • AddThis widgets
  • Bing
  • CodePen
  • Criteo
  • Disqus
  • Elevio
  • Reacties op Facebook
  • Facebook-widgets
  • Freshchat
  • Google AdSense
  • Google Analytics
  • Google Maps
  • Google ReCaptcha
  • Google Site Search
  • Google Tag Manager
  • Google oAuth
  • Google+ widgets
  • Headway
  • Instagram-widgets
  • Kissmetrics
  • LinkedIn-widgets
  • Mixpanel
  • Neodata
  • Olark
  • Optimizely
  • Outbrain
  • PayPal-widgets
  • Pingdom
  • Pinterest-widgets
  • Segment
  • ShareThis-widgets
  • Twitter-widgets
  • UserVoice
  • Vimeo
  • YouTube

Instructies

Als je de plug-in voor de eerste keer installeert, ga dan direct naar de installatie-instructies hier.

Als je eerder een oudere versie van de plug-in rechtstreeks vanaf deze site hebt geïnstalleerd, kun je de plug-in bijwerken naar de nieuwste versie door de onderstaande stappen te volgen.

  1. Verwijder eerst de oude versie van de plug-in – Klik op Extensions > Manage, selecteer de plug-in en klik op de knop Uninstall bovenaan het onderdeel.
  2. Ga naar de officiële Joomla! Extension Directory hier en download de plug-in.
  3. Installeer door de onderstaande installatiestappen te volgen.

Installatie

  • Download de gratis plug-in hier.
  • Ga naar je beheerpaneel (http://example.com/admin123/) en log in.
  • Ga naar je menu met Extensions bovenaan het scherm in het beheerpaneel en klik op Manage > Install
  • Sleep en zet hier het gezipte bestand met de iubenda-plug-in of klik op Browse for file en selecteer het iubenda-bestand van je computer.

Activering

  • Klik op Extensions > Manage > Manage;
  • Zoek naar “iubenda” en activeer de plug-in.

De cookiebanner/toestemmingsbanner toevoegen en instellingen wijzigen

  • Klik op het item Extensions > Plugins;

  • Zoek naar “iubenda” en klik op de naam van de plug-in (je ziet hieronder hoe de interface eruit ziet):

    Cookie Solution - Joomla! plugin

  • Kopieer je Privacy Controls and Cookie Solution code uit het insluitonderdeel voor de Privacy Controls and Cookie Solution in je iubenda-account Cookie Solution insluiten (Als je nog niet je code voor de Privacy Controls and Cookie Solution hebt gegenereerd binnen je iubenda-account, kun je hier meer lezen over hoe je dat doet: inleiding tot de iubenda Privacy Controls and Cookie Solution).

  • Klik op Instellingen, plak je code in het plug-informulier en sla op: Cookie Solution - Joomla! plugin (Omdat het een PHP-plug-in is, raden we de primaire, snellere optie aan voor de parsing engine. Als dit niet lukt, probeer dan het alternatief op basis van een aangepaste HTML DOM-klasse)

Selecteer in je Joomla-dashboard het pictogram System aan de linkerkant van je scherm.

Ga vervolgens naar het menu “Manage” en selecteer Extensions.

Typ in de zoekbalk bovenaan je scherm “iubenda” en druk op de enter-toets van je toetsenbord.

Klik daarna op de X links van “iubenda Privacy Controls and Cookie Solution”.

Dat is alles! Je hebt je iubenda Privacy Controls and Cookie Solution geactiveerd op Joomla! 

De cookiebanner/toestemmingsbanner toevoegen en instellingen wijzigen

Laten we beginnen met het kopiëren van je code voor de Privacy Controls and Cookie Solution uit het onderdeel Insluiten in je iubenda account. Selecteer onder de titel ‘Privacy Controls and Cookie Solution’ in je dashboard de knop <> INSLUITEN .

Klik vervolgens onder het kopje ‘De banner insluiten’ op de knop KOPIËREN aan de rechterkant van je code.

(Als je de code voor je Privacy Controls and Cookie Solution nog niet hebt gegenereerd in je iubenda-account, kun je hier meer lezen over hoe je dat doet: Inleiding tot de iubenda Privacy Controls and Cookie Solution).

Ga dan naar je Joomla-dashboard en selecteer het pictogram System aan de linkerkant van je scherm. 

Ga vervolgens naar het menu “Manage” en selecteer Plugins.

Zoek met de zoekbalk bovenaan naar “iubenda” en druk op de enter-toets van je toetsenbord. Klik daarna op de naam van de plug-in “iubenda Privacy Controls and Cookie Solution”.

Klik vervolgens op het menu Settings (instellingen) naast het plug-in-menu bovenaan je scherm.

Scroll omlaag tot ‘iubenda code’ en plak de code voor je Privacy Controls and Cookie Solution uit je iubenda-dashboard in het tekstvak.

Omdat het een PHP-plug-in is, raden we de primaire, snellere optie aan voor de parsing-engine. Als dit niet lukt, probeer dan het alternatief op basis van een aangepaste HTML DOM-klasse)

Klik dan linksboven in je scherm op Save & Close en je bent klaar! 

Gebruiken

Na de configuratie toont de plug-in de banner met de link naar of de weergave van je cookiebeleid aan gebruikers die je site voor de eerste keer bezoeken, zonder dat verdere configuraties nodig zijn. De plug-in herkent en blokkeert ook automatisch de cookies die in de bovenstaande blokkadelijst worden genoemd en die aanwezig zijn op je site.

Belangrijk

Onze Joomla!-extensies blokkeren automatisch scripts die aan de serverkant worden gegenereerd (en dus door Joomla worden teruggestuurd via PHP). Scripts die via JavaScript in de pagina worden ingevoegd nadat de pagina is geladen, worden en kunnen niet automatisch worden geblokkeerd.

Deze scripts kunnen worden geblokkeerd door de broncode in te voeren in de vakken voor aangepaste scripts in de plug-inconsole of door de handmatige inpakmethode te gebruiken die wordt uitgelegd in het onderstaande voorbeeld en (meer in detail) in dit help-artikel

Aangepaste scripts blokkeren vanuit de console

Met het veld voor aangepaste scripts kun je eenvoudig scripts blokkeren die direct vanuit de plug-inconsole op de pagina worden ingevoegd. Hierdoor zijn er veel minder directe wijzigingen in de code van de site nodig.

Zo doe je dat:

  • Ga in je beheerpaneel naar Extensions > Plugins.
  • Zoek vervolgens op “iubenda“, klik op de naam van de plug-in en vervolgens op het tabblad Settings bovenaan.
  • Scroll omlaag naar de velden Custom scripts en Custom iframes onderaan de pagina.Velden voor Custom en iframe scripts in Joomla
  • Voer indien nodig je script- of iframe-bronnen in, wijs de categorie toe (optioneel) en klik op de knop Save & Close bovenaan de pagina.

Voorbeelden

Het gebruik van deze velden is vrij eenvoudig. Voer het src-attribuut van het script of iframe in dat je wilt blokkeren.

Script

Als je een socialemediaknop (die via JavaScript scripts invoegt opn de pagina) wilt blokkeren, hoef je alleen maar de scriptbron, bijvoorbeeld connect.socialwebsite.net/nl_US/track.js, in te voeren in het scriptveld.

iframe

Stel dat je scripts wilt blokkeren die via het volgende iframe op de pagina worden ingevoegd

<iframe width="1280" height="720" src="https://www.videowebsite.com/embed/xxFhMChxx" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Wat je in het iframe veld moet invoeren is videowebsite.com/embed/ omdat dit de werkelijke bron van de scripts is. Zorg ervoor dat je de component-id NIET invoert (videowebsite.com/embed/com/embed/xxFhMChxx) om ervoor te zorgen dat alle scripts die van de werkelijke bron komen worden geblokkeerd.

Handmatig gebruik (wrappingmethode)

Deze methode vereist dat je de zelf code van je site aanpast. Ga naar het relevante gedeelte van de code van je site en voeg de te blokkeren scripts toe zoals hieronder wordt uitgelegd.

Hier is een voorbeeld van hoe je de plug-in handmatig kunt laten werken voor een socialemediaknop (die scripts invoegt op de pagina via JavaScript).

<!--IUB-COOKIE-BLOCK-START-->
<script>
    (function(d, s, id) {
        var js, fjs = d.getElementsByTagName(s)[0];
        if (d.getElementById(id)) return;
        js = d.createElement(s);
        js.id = id;
        js.src = "//connect.socialwebsite.net/en_US/sdk.js#xfbml=1&version=v2.3&appId=808061959224601";
        fjs.parentNode.insertBefore(js, fjs);
    }(document, 'script', 'socialwebsite-jssdk'));
</script>
<!--IUB-COOKIE-BLOCK-END-->

Als er HTML / IMG / IFRAME elementen zijn, moet je het op deze manier doen:

<!--IUB-COOKIE-BLOCK-START-->
      <iframe src="...
      <img src="...
<!--IUB-COOKIE-BLOCK-END-->

Als je de toestemmingsfunctie per categorie hebt ingeschakeld, moet je het doel toewijzen. Om terug te komen op het voorbeeld van de socialemediaknop, die deel uitmaakt van het doel “Ervaring” (id 3):

<!--IUB-COOKIE-BLOCK-START-PURPOSE-3-->
<script>
    ...
</script>
<!--IUB-COOKIE-BLOCK-END-PURPOSE-3-->

Om het automatisch parseren/vervangen van iframes/scripts die een gedefinieerde src bevatten te stoppen:

<!--IUB-COOKIE-BLOCK-SKIP-START-->
      <script type="text/javascript">...</script>
<!--IUB-COOKIE-BLOCK-SKIP-END-->
⚠️ Let op

Zorg ervoor dat je na de installatie de voorafgaande blokkering instelt, omdat dit wettelijk verplicht is volgens de EU-wetgeving. In deze gids vind je verschillende methoden om vooraf te blokkeren, samen met volledige instructies.

Zie ook