Yii 1.1: cookiemonster

Yii extension to manage cookie warning
1 follower

Yii-CookieMonster

Yii extension to manage cookie warning

What is it for?

In 2009, the European Union sought new regulations as part of an "e-privacy" directive, seeing cookies as a potential threat to privacy, because users often don't know they are being tracked. This extension adds the information about cookies for the Yii website.

Requirements

Yii 1.1

Installation

Copy the 'CookieMonster' folder from the zip file to your '/protected/extensions' Yii folder.

Usage

Add this code once inside your template file just before </body>

<?php $this->widget('ext.CookieMonster.CookieMonster'); ?>

This code will render widget with all default options (and 'top' layout). If you want to configure it add options array.

<?php $this->widget('ext.CookieMonster.CookieMonster', array(/* options here */)); ?>

All options (and options' options) are described below. For example if you want to use custom message on the button and use 'bottom' layout set:

<?php $this->widget('ext.CookieMonster.CookieMonster', array(
    'content' => array(
        'buttonMessage' => 'OK', // instead of default 'I understand'
    ),
    'mode' => 'bottom'
)); ?>

Options

  • box - array CSS class and styles and HTML options for div
  • content - array warning and button message
  • cookie - array cookie options
  • mode - string widget layout selection
  • params - mixed user's parameters to pass to the custom widget layout

Box options

  • addButtonStyle - array list of button CSS style options to be added or replaced with new values i.e. 'padding-right' => '20px', 'font-weight' => 'bold'
  • addInnerStyle - array list of inner div CSS style options to be added or replaced with new values
  • addOuterStyle - array list of outer div CSS style options to be added or replaced with new values
  • buttonHtmlOptions - array list of button HTML options to be added (except style and class)
  • classButton - string button class or classes (separated by spaces), default 'CookieMonsterOk'
  • classInner - string inner div class or classes (separated by spaces)
  • classOuter - string outer div class or classes (separated by spaces), default 'CookieMonsterBox'
  • innerHtmlOptions - array list of inner div HTML options to be added (except style and class)
  • outerHtmlOptions - array list of outer div HTML options to be added (except style and class)
  • replaceButtonStyle - array list of button CSS style options to be replaced with new values or removed i.e. 'margin-left' => '10px', 'font-size' => false
  • replaceInnerStyle - array list of inner div CSS style options to be replaced with new values or removed
  • replaceOuterStyle - array list of outer div CSS style options to be replaced with new values or removed
  • setButtonStyle - array list of button CSS style options to be set replacing the default ones
  • setInnerStyle - array list of inner div CSS style options to be set replacing the default ones
  • setOuterStyle - array list of outer div CSS style options to be set replacing the default ones
  • view - string path to the custom view (required if [[mode]] is set to 'custom'), for views outside the widget folder use alias path i.e. 'application.views.cookie'

Content options

  • buttonMessage - string button original message as in Yii::t() $message, default 'I understand'
  • buttonParams - array parameters to be applied to the buttonMessage as in Yii::t() $params, default array()
  • category - string message category as in Yii::t() $category, default 'app'
  • language - string target language as in Yii::t() $language, default null
  • mainMessage - string main original message as in Yii::t() $message, default 'We use cookies on our websites to help us offer you the best online experience. By continuing to use our website, you are agreeing to our use of cookies. Alternatively, you can manage them in your browser settings.'
  • mainParams - array parameters to be applied to the mainMessage as in Yii::t() $params, default array()
  • source - string which message source application component to use as in Yii::t() $source, default null

Cookie options

  • domain - string domain name for the cookie, default host portion of the current document location
  • expires - integer number of days this cookie will be valid for, default 30
  • max-age - integer max cookie age in seconds
  • path - string path for the cookie, default '/'
  • secure - boolean wheter cookie should be transmitted over secure protocol as https, default false

Mode possible values

  • bottom - bottom strip
  • box - bottom right box
  • custom - custom mode defined by user (requires box[view] to be set)
  • top - top strip, default

Default layouts

bottom

<div style="display:none;z-index:10000;position:fixed;background-color:#fff;font-size:12px;color:#000;bottom:0;left:0;width:100%;box-shadow:0 -2px 2px #000" class="CookieMonsterBox">
    <div style="margin:10px" class="">
        We use cookies on our websites to help us offer you the best online experience. By continuing to use our website, you are agreeing to our use of cookies. Alternatively, you can manage them in your browser settings.<button style="margin-left:10px" class="CookieMonsterOk" type="button">I understand</button>
    </div>
</div>

box

<div style="display:none;z-index:10000;position:fixed;background-color:#fff;font-size:12px;color:#000;bottom:20px;right:20px;width:300px;box-shadow:-2px 2px 2px #000;border-radius:10px" class="CookieMonsterBox">
    <div style="margin:10px" class="">
        We use cookies on our websites to help us offer you the best online experience. By continuing to use our website, you are agreeing to our use of cookies. Alternatively, you can manage them in your browser settings.<button style="margin-left:10px" class="CookieMonsterOk" type="button">I understand</button>
    </div>
</div>

top

<div style="display:none;z-index:10000;position:fixed;background-color:#fff;font-size:12px;color:#000;top:0;left:0;width:100%;box-shadow:0 2px 2px #000" class="CookieMonsterBox">
    <div style="margin:10px" class="">
        We use cookies on our websites to help us offer you the best online experience. By continuing to use our website, you are agreeing to our use of cookies. Alternatively, you can manage them in your browser settings.<button style="margin-left:10px" class="CookieMonsterOk" type="button">I understand</button>
    </div>
</div>

GitHub repo

https://github.com/bizley/Yii-CookieMonster

Yii 2 version

https://github.com/bizley/yii2-cookiemonster http://www.yiiframework.com/extension/yii2-cookiemonster/

Be the first person to leave a comment

Please to leave your comment.

Create extension