Cookies Disclaimer
Inform users about the use of cookies on their wiki |
Type | XAR |
Category | |
Developed by | |
Rating | |
License | GNU Lesser General Public License 2.1 |
Table of contents
Description
About
What are cookies?
Cookies are small text files that are placed on your computer by websites that you visit.
They are widely used in order to make websites work, or work more efficiently, as well as to provide information to the owners of the site.
There are also useful to provide you with more relevant information.
What's all the fuss?
On May 26th, 2011 the European Comission adopted the law which states that you have to get your visitors informed consent before placing a cookie on their machine.
Because cookies are just text files stored on your machine, website authors can store pretty much any information they want about the user which can cause many privacy concerns.
Things like the Facebook 'like' button that can be used by Facebook to track people on other websites than facebook.com have escalated this issue.
What's this app all about?
This app is designed to show a message to the user informing him of the use of cookies on your wiki.
The message is displayed until the user explicitly tells it to hide, thus having acknowledged the fact the site uses cookies to store various information about him.
The app
Examples
There are two types of displaying the message.
The first is a full width bar, either at the top or bottom page.
The second display type is a growl like box on the right side of the page.
Another customizable element is the button which closes the notification.
It can be the standard close symbol like in the examples above or it can be a message, like in the example below.
Configuration
Name | Values | Description |
---|---|---|
active | yes, no | Determines if the cookie disclaimer is shown on the wiki or not |
type | bar, box | The display type of the message, either a full width bar or a growl like nootification box |
position | top, bottom | The position of the element containing the message |
animation | none, slide, fade | Animation of the element containing the message on show/hide |
background color | html color value | Background color of the container |
foreground color | html color value | Color for the text in the container |
opacity | 0.0 - 1.0 | The level of transparency of the container |
button type | close, text | Display mode of the 'hide message' button |
button text | pure text or wiki content | The label of the hide button |
disclaimer | pure text or wiki content | The actual cookies disclaimer which can contain html and wiki content |
Usage
The content which is displayed in the message box can be pute text but also, if you want to add translation to the message you can use a translation key.
To do this you have to click o the macro button from the wysiwyg editor, select velocity macro and display a translation key.
Prerequisites & Installation Instructions
We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.
You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:
- Log in the wiki with a user having Administration rights
- Go to the Administration page and select the Import category
- Follow the on-screen instructions to upload the downloaded XAR
- Click on the uploaded XAR and follow the instructions
- You'll also need to install all dependent Extensions that are not already installed in your wiki