Micoo

Gem Version GEM Downloads MIT License

Micoo (minimal Cookie) is a Rails Engine handling the Cookie consent. Besides installing the gem just a minimal code is required (see Usage).

Micoo display a styled text including buttons for accepting or rejecting usage of cookies.

Clicking Accept set the cookie "cookiesOK" to "x", clicking *Reject" will delete the cookie.

Optional Parameters

Optional parameters for CookiesComponent.new(...) are:

text

Default is:

You may delete and block all cookies from this site, but parts of the site will not work.

Click Accept if you consent usage of cookies, otherwise click Reject.

text2

text2 may be used to add additional text and links for further description.

url

Redirection to url will be triggered by clicking Accept or Reject. Default is "/".

Usage

# app/controllers/application_controller.rb (recommended)
  ...
  before_action :always

  def always
    unless cookies[:cookiesOK] == "x"
      render CookiesComponent.new(url: root_path)
    end
  end
  ...

I18n

You may provide an "internationalized" text via the text parameter.

Micoo buttons uses the I18n.translate method for the legend. A configuration file (a sample) may be:

# config/locales/en.yml
en:
  micoo:
    button:
      accept: Accept
      reject: Reject

Installation

As usual:

# Gemfile
gem "micoo"

and run "bundle install".

License

Copyright (c) 2024 Dittmar Krall (www.matiq.com), released under the MIT license.