README

Hur man använder Region Hallands plugin "RHAcfCookieNotice"

Nedan följer instruktioner hur du kan använda pluginet "RhAcfCookieNotice".

Användningsområde

Denna plugin skapar funktionalitet för en "cookie notice", dvs:

A) Lägger till två fält i databasen. Ett fält för informationstext + ett fält för knapptext
B) Skapar ett formulär under "Temainställningar" i Wp-admin där man kan editera texterna
C) En funktion för att hämta ut respektive text som en array
D) En funktion för att kontrollera om en cookie är satt eller inte

OBS! Denna plugin förutsätter att du har installerat och aktiverat Advanced Custom Fields Pro (https://www.advancedcustomfields.com/pro/)

Licensmodell

Denna plugin använder licensmodell GPL-3.0. Du kan läsa mer om denna licensmodell via den medföljande filen:

LICENSE (https://regionhalland.visualstudio.com/public.RhWpPlugIns/_git/RhAcfCookieNotice?path=%2FLICENSE&version=GBmaster)

Installation och aktivering

A) Hämta pluginen via Git eller läs in det med Composer
B) Installera Region Hallands plugin i Wordpress plugin folder
C) Aktivera pluginet inifrån Wordpress admin

Hämta hem pluginet via Git

git clone https://regionhalland.visualstudio.com/public.RhWpPlugIns/_git/RhAcfCookieNotice

Läs in pluginen via composer

OBS! Justera så att du hämtar aktuell version.

"require": {
  "regionhalland/region-halland-plugin-acf-cookie-notice": "1.0.0"
},

Visa "cookie notice" på en sida via "Blade"

@if(function_exists('check_region_halland_cookie_notice'))
  @php($checkCookieNotice = check_region_halland_cookie_notice())
  @if ($checkCookieNotice == false)
    @php($myCookieNotice = get_region_halland_cookie_notice())  
    <span class="h5">{!! $myCookieNotice['message'] !!}</span>
    <button id="cookie-consent" class="btn btn-primary">
      {!! $myCookieNotice['button'] !!}
    </button>
  @endif
@endif

Exempel på hur arrayen kan se ut

array (size=7)
  'message' => string 'På den här webbplatsen använder vi cookies (kakor) för att webbplatsen ska fungera på ett bra sätt för dig. Genom att klicka vidare eller på ”Jag förstår” godkänner du att vi använder cookies.x' (length=209)
  'button_yes' => string 'Jag förstårx' (length=14)
  'button_no' => string 'Nej till kakor' (length=14)
  'link_title' => string 'Kalle läser sig till framgång' (length=31)
  'link_url' => string 'http://dev-template.local/berattelse/kalle-laser-sig-till-framgang/' (length=67)
  'link_target' => string '' (length=0)
  'has_link' => int 1

Jquery för att kontrollera ifall användaren klickar på knappen

$("#cookie-consent").on( "click", function() {
    
    // set cookie with javascript function
    setCookie('rh_cookie_notice_status','1',365);
    
    // Hide div with cookie notice text + button
    $("#cookie-notice").hide();

});

Javascript för att skapa cookien

function setCookie(name,value,days) {
    
    // Set variables
    var expires = "";
    if (days) {
        var date = new Date();
        date.setTime(date.getTime() + (days*24*60*60*1000));
        expires = "; expires=" + date.toUTCString();
    }
    
    // Set cookie
    document.cookie = name + "=" + (value || "")  + expires + "; path=/";

}

Versionhistorik

1.8.0

ACF fälten visas nu i WP-JSONs REST API

1.7.3

Nu returneras även cookiens värde och inte bara om den är satt eller ej

1.7.2

Bytt namn på cookie

1.7.1

Tagit bort oönskade tecken

1.7.0

Lagt till nej-knapp
Lagt till länk

1.6.0

Nya namn på acf-fät för att matcha struktur

1.5.1

Uppdaterat readme

1.5.0

Bytat composer-namn

1.4.0

Även publicerat till Packagist för enklare inläsning

1.3.2

Korrigerat länk till licens-fil

1.3.1

Korrigerat versionsnummer

1.3.0

Bifogat fil med licensmodell

1.2.0

Uppdaterat readme med nya länkar

1.1.0

Lagt till information om licensmodell

1.0.0

Första version

regionhalland / region-halland-plugin-acf-cookie-notice

Maintainers

Details