Documentazione

Indice dei contenuti

I canali di rilascio della Cookie Solution

Questo articolo si riferisce all’ultima versione della Cookie Solution. Se non l’hai già fatto, ti consigliamo di aggiornare la tua Cookie Solution copiando il nuovo codice che trovi in Dashboard > [Il tuo sito/app] > Cookie Solution > Integra per evitare possibili conflitti CSS e accedere a tutte le funzionalità dell’ultima versione. In alternativa, trovi la guida alla versione legacy qui.

La iubenda Cookie Solution è disponibile in tre differenti versioni che consentono ad ogni utente di scegliere il ciclo di rilascio degli aggiornamenti che più si addice alle sue esigenze:

  1. Current – Il canale Current è quello su cui si basa la versione di default della iubenda Cookie Solution. Tale versione riceve aggiornamenti ogni due o tre settimane; eventuali fix vengono applicate su questo canale non appena disponibili.
  2. Beta – Il canale Beta è quello su cui vengono rilasciate tutte le ultime feature una volta che sono state testate internamente. Anche in questo caso le eventuali fix vengono applicate non appena disponibili.
  3. Stable – Il canale Stable viene aggiornato solo se è passato almeno un mese dal rilascio delle nuove feature sul canale Current. Le date di rilascio sono stabilite con almeno due settimane di anticipo e, salvo casi eccezionali e di particolare rilevanza, le fix vengono applicate su questo canale solo secondo il piano di rilascio programmato.
Canali di rilascio della Cookie Solution

In ogni momento è possibile specificare la versione che si desidera utilizzare agendo sull’apposito menu a discesa, copiando il codice risultante e incollandolo nel tag HEAD in sostituzione di quello di default, riportato qui in basso:

<head>
...

<script type="text/javascript">
    var _iub = _iub || [];
    _iub.csConfiguration = {
        "siteId": XXXXXX, //usa il tuo siteId
        "cookiePolicyId": YYYYYY, //usa il tuo cookiePolicyId
        //altre opzioni di configurazione
    };
</script>
<script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

...
</head>

Come modificare il canale di rilascio

Il canale Current è quello al quale la Cookie Solution si collega di default. Se desideri utilizzare questo canale, non devi apportare alcuna modifica al codice della Cookie Solution generato in automatico da iubenda nel momento in cui la cookie policy viene attivata.

Il canale Beta è collegato al seguente URL:

cdn.iubenda.com/cs/beta/iubenda_cs.js

Per selezionare il canale Beta è sufficiente scegliere Beta dal menu a discesa alla destra di “Integra il banner” (per arrivarci: Dashboard > [Il tuo sito] > Cookie Solution > Integra), copiare il codice risultante e incollarlo nel tag HEAD del tuo sito in sostituzione di quello di default, come mostrato nell’esempio in basso.

Cookie Solution - Canale Beta

Prima:


  <head>
  ...

  <script type="text/javascript">
      var _iub = _iub || [];
      _iub.csConfiguration = {
          "siteId": XXXXXX, //usa il tuo siteId
          "cookiePolicyId": YYYYYY, //usa il tuo cookiePolicyId
          //altre opzioni di configurazione
      };
  </script>
  <script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

  ...
  </head>

Dopo:


  <head>
  ...

  <script type="text/javascript">
      var _iub = _iub || [];
      _iub.csConfiguration = {
          "siteId": XXXXXX, //usa il tuo siteId
          "cookiePolicyId": YYYYYY, //usa il tuo cookiePolicyId
          //altre opzioni di configurazione
      };
  </script>
  <script type="text/javascript" src="//cdn.iubenda.com/cs/beta/iubenda_cs.js" charset="UTF-8" async></script>

  ...
  </head>

Il canale Stable è collegato al seguente URL:

cdn.iubenda.com/cs/stable/iubenda_cs.js

Per selezionare il canale Stable è sufficiente scegliere Stable dal menu a discesa alla destra di “Integra il banner” (per arrivarci: Dashboard > [Il tuo sito] > Cookie Solution > Integra), copiare il codice risultante e incollarlo nel tag HEAD del tuo sito in sostituzione di quello di default, come mostrato nell’esempio in basso.

Cookie Solution - Canale Stable

Prima:


  <head>
  ...

  <script type="text/javascript">
      var _iub = _iub || [];
      _iub.csConfiguration = {
          "siteId": XXXXXX, //usa il tuo siteId
          "cookiePolicyId": YYYYYY, //usa il tuo cookiePolicyId
          //altre opzioni di configurazione
      };
  </script>
  <script type="text/javascript" src="//cdn.iubenda.com/cs/iubenda_cs.js" charset="UTF-8" async></script>

  ...
  </head>

Dopo:


  <head>
  ...

  <script type="text/javascript">
      var _iub = _iub || [];
      _iub.csConfiguration = {
          "siteId": XXXXXX, //usa il tuo siteId
          "cookiePolicyId": YYYYYY, //usa il tuo cookiePolicyId
          //altre opzioni di configurazione
      };
  </script>
  <script type="text/javascript" src="//cdn.iubenda.com/cs/stable/iubenda_cs.js" charset="UTF-8" async></script>

  ...
  </head>

Esempio

Ecco l’esempio di uno scenario tipico utile ad una maggiore comprensione del meccanismo sul quale si basano gli aggiornamenti a seconda del canale di rilascio selezionato:

  • Al giorno 0 la versione 0.11.36 è disponibile su tutti i canali
  • Al giorno 1 la versione 0.12.0 viene rilasciata sul canale Beta
  • Al giorno 2 la versione 0.12.1 viene rilasciata sul canale Beta
  • Al giorno 4 la versione 0.12.2 viene rilasciata sul canale Beta
  • Al giorno 1 + 2 settimane la versione 0.12.2 viene rilasciata sul canale Current
  • Al giorno 1 + 3 settimane gli utenti del canale Stable vengono notificati dell’imminente release della versione 0.12.2
  • Al giorno 1 + 4 settimane la versione 0.12.2 viene rilasciata sul canale Stable

Nel caso in cui un fix debba essere rilasciato al giorno 4, i canali Beta e Current verranno aggiornati subito mentre il canale Stable non lo sarà (a meno di fix di particolare rilevanza):

  • Al giorno 3 la versione 0.12.2 viene rilasciata sul canale Beta
  • Al giorno 3 la versione 0.11.37 viene rilasciata sul canale Current

Il processo di release riprende quindi come al solito:

  • Al giorno 4 la versione 0.12.3 viene rilasciata sul canale Beta
  • Al giorno 1 + 2 settimane la versione 0.12.3 viene rilasciata sul canale Current
  • Al giorno 1 + 3 settimane gli utenti del canale Stable vengono notificati dell’imminente release della versione 0.12.3
  • Al giorno 1 + 4 settimane la versione 0.12.3 viene rilasciata sul canale Stable

Come scegliere una specifica versione della Cookie Solution

Se vuoi utilizzare una particolare versione della Cookie Solution, è sufficiente modificarne il codice inserendo un URL come quello dell’esempio in basso:

cdn.iubenda.com/cs/versions/0.11.36.4/iubenda_cs.js

“0.11.36.4” è in questo caso la versione utilizzata. Per scegliere una versione differente, basta indicarla al posto di “0.11.36.4”.

Nota: le versioni disponibili sono unicamente quelle rilasciate sui canali Current e Stable.

Changelog

Il changelog completo dei vari canali di release è disponibile a questo link.