as-ideas / oil

191 stars 56 forks source link

POI? #128

Closed TimothyDigitalOyster closed 6 years ago

TimothyDigitalOyster commented 6 years ago

Been trying to work out how this works. Documentation is sparse.

I have two pages on different domains is it possible to generate consent for both pages using this?

e.g. abc.com/index.html First pages leads to xyz.com/index.html

Is it possible to get consent from the first page with the second pages listed on it so that the second page doesn't additionally require a permission...

phogel commented 6 years ago

Yes, you can store a user's consent across different domains:

TimothyDigitalOyster commented 6 years ago

Where do I change the names of the "companies" within the group?

phogel commented 6 years ago

Adding to the above: You want to upload not only hub.html but also hub.js.

These are available labels http://oil.axelspringer.com/docs/#label-configuration-parameters I think you're looking for the label label_poi_group_list_heading?

TimothyDigitalOyster commented 6 years ago

There are two different settings related to POI.. "label_poi_group_list_heading" : "Your consent for sites related to this site", "label_poi_group_list_text" : "Here is a list of related sites:",

Which generates something like:

Your consent for sites related to this site Here is a list of related sites: XXX XXX

What I was after is where to modify the sections that are XXX'd out..

Waschnick commented 6 years ago

You need any domain, where the central cookie is stored. For example any.domain.com. On this domain you need the hub.html from the release folder (in the released versions, the hub.js is inlined in the hub.html)

You need to configure this setup: “poi_activate_poi”: true "poi_hub_origin": "//any.domain.com" "poi_hub_path": "/hub.html", "poi_group_name": "MyGroupName"

The group name is kind of a prefix - you can have multiple groups on the same domain. The cookie is shared per group

For the group you will legally need to list all websites/companies belonging to it. We call this the poi-list and you can add a JSON file. --> In the release folders (1.1.2) the is a folder name poi-list and you can add a json-file with the name of your poi_group_name

You can have all the files from one release in one folder and configure it accordingly, look at oil.axelspringer.com/demos/open-source-example.html

phogel commented 6 years ago

There's section in the Readme now on this matter https://github.com/as-ideas/oil#poi-and-soi

132