=================
Website Cookiebot
=================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:ac3198e9e153575161d66cb4028f1f14c2a162e32c2fa2d39fbf9f719fd52e08
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fwebsite-lightgray.png?logo=github
    :target: https://github.com/OCA/website/tree/16.0/website_cookiebot
    :alt: OCA/website
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/website-16-0/website-16-0-website_cookiebot
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/website&target_branch=16.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module integrates Odoo website with `Cookiebot <https://www.cookiebot.com/>`__,
to ask for consent before installing cookies on users' browsers.

**Table of contents**

.. contents::
   :local:

Configuration
=============

To configure this module, you need to:

#. Go to *Website > Configuration > Settings*
#. Under *Select the Website to Configure*, choose a website.
#. In the privacy section enable *Cookiebot* option.
#. Click on *`How to configure Cookiebot <https://cookiebot.com/goto/help>`__*.
#. Follow the instructions, except step 3 (do not insert the ``<script>`` tags, the module will do it for you).
#. Fill in your *Domain Group ID* (e.g. ``00000000-0000-0000-0000-000000000000``)
#. Click on the *Save* button.

⚠️ **This module will do nothing unless configured and linked with Cookiebot.**

Usage
=====

To use this module, once configured for your website, you just need to browse
that website. You will see the Cookiebot consent banner, and a *Cookies Policy*
link in the footer.

.. figure:: https://raw.githubusercontent.com/OCA/website/16.0/website_cookiebot/static/description/screenshot.png
   :alt: Cookiebot consent banner

Remember that, if your browser is configured to block 3rd party cookies,
trackers or consent banners, you won't notice the change. Disable any of those
protections to experiment the benefits.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/website/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/website/issues/new?body=module:%20website_cookiebot%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
~~~~~~~

* Trey (www.trey.es)
* Tecnativa

Contributors
~~~~~~~~~~~~

* `Trey <https://www.trey.es>`__:
    * Jorge Camacho <jorge@trey.es>
    * Antonio González <antonio@trey.es>

* `Tecnativa <https://www.tecnativa.com/>`__:
    * Jairo Llopis
    * Stefan Ungureanu
    * Pilar Vargas

Maintainers
~~~~~~~~~~~

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

This module is part of the `OCA/website <https://github.com/OCA/website/tree/16.0/website_cookiebot>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.