Cookie Services

A cookie service allows for the management of scripts, cookies, and iframes.

For example: Thirdparty Scripts and Iframe Manager.

Global Settings

name Display Name in Frontend
identifier System Identifier (do not change)
description Service Description
provider Provider URLS seperated by ","
dsgvo_link Link to Service AGB's
category_suggestion Used for simple MM Selection

Iframe Manager

The iframe manager is responsible for blocking third-party content.

In the field, iframe_notice text is stored that the user sees when the content is blocked.

iframe_load_btn Loads the Content of current Div
iframe_load_all_btn Loads all Content from same Service on same site

Since version 1.7.0, the Iframe Manager includes a thumbnail feature that displays a placeholder image for blocked iframe content until the user consents to the service. By default, the thumbnail is autogenerated, but it can be customized by providing a valid URL or by using a JavaScript function in the Backend "Cookie-Service" configuration.

If no custom thumbnail is provided, the Iframe Manager will fallback to a default image, which is stored at /typo3temp/assets/cfthumbnails/*, they are generated automatically and cached for 7 days. Using the Thumbnail-API can be disabled in the Extension Settings.

Advanced Iframe Configuration

iframe_thumbnail_url set valid url for automatic thumbnails or use a Javascript function

iframe_embed_url is called on Successful Accept can also use a Javascript function

Example Iframe Thumbnail function

function(id, callback){
  let parts = id.split("/");
  let videoId = parts[parts.length - 1];
  let videoIdParts = videoId.split("?");
  let videoIds = videoIdParts[0];
  var url = "https://vimeo.com/api/v2/video/"+videoIds +".json";
  var xhttp = new XMLHttpRequest();
  xhttp.onreadystatechange = function() {
    if (this.readyState == 4 && this.status == 200) {
      var src = JSON.parse(this.response)[0].thumbnail_large;
      callback(src);
    }
  };
  xhttp.open("GET", url, true);
  xhttp.send();
}

Script Configuration

OptInCode opt_in_code is executed when the user accepts the service. By default, some services do not have an OptInCode as cookie management happens automatically based on the assigned cookies. This code is only needed to execute additional JavaScript when the user accepts the service.

OptOutCode opt_out_code is executed when the user block the service. By default, some services do not have an OptOutCode as cookie management happens automatically based on the assigned cookies. This code is only needed to execute additional JavaScript when the user block the service.

Fallback Code [fallback_code] is not in use, TODO.

External Script Configuration

External scripts are used for example for Google Analytics. Including these is easy, here is how to create an external script.

Fields:

name Display and lable name
link The external link
async Embed the script tag asynchronous

Tip

You can provide GET parameters like in this Example: https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXX

Variable Provider

Variable providers detect defined variables in the fields opt_in_code opt_out_code fallback_code.

A variable is declared with the [## and closed with ##]. In the Google Analytics service you find this example: [##googleTagManagerID##]

Replace G-XXXXXXXX with your Google Tag manager ID.

Fields:

name Display and lable name
identifier the Variable in the [##myvariable##] like myvariable
value The stored string