Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/osano/cookieconsent
A free solution to the EU, GDPR, and California Cookie Laws
https://github.com/osano/cookieconsent
ccpa cookie-consent cookies eu-cookie gdpr javascript legal
Last synced: 5 days ago
JSON representation
A free solution to the EU, GDPR, and California Cookie Laws
- Host: GitHub
- URL: https://github.com/osano/cookieconsent
- Owner: osano
- License: mit
- Created: 2015-02-02T17:55:24.000Z (almost 10 years ago)
- Default Branch: dev
- Last Pushed: 2024-06-23T17:22:42.000Z (7 months ago)
- Last Synced: 2024-12-21T09:32:01.416Z (about 1 month ago)
- Topics: ccpa, cookie-consent, cookies, eu-cookie, gdpr, javascript, legal
- Language: JavaScript
- Homepage: https://www.osano.com/cookieconsent
- Size: 3.49 MB
- Stars: 3,417
- Watchers: 91
- Forks: 574
- Open Issues: 93
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-privacy-engineering - Cookie Consent - An opensource, lightweight JavaScript plugin for alerting users about the use of cookies on a website. It is designed to help quickly comply with the European Union Cookie Law, CCPA, GDPR and other privacy laws. (Awesome Privacy Engineering [](https://awesome.re) / Data Deletion, Data Mapping, and Data Subject Access Requests)
README
[![Build Status][bi]][bl]
[![MIT License][li]][ll]
[![Twitter][ti]][tl]
## What is Cookie Consent?
[Cookie Consent][cl] is a lightweight JavaScript plugin for alerting users about the use of cookies on your website.
It is designed to help you quickly comply with the EU Cookie Law, CCPA, GDPR and other privacy laws. We made it fast, free, and relatively painless.
Cookie Consent is seen over 2 BILLION times every month and is used on millions of sites, making this by far the most popular consent project on the internet.
We welcome community contributions and actively review pull requests.
## Hosted Zero Config Consent
Our parent company Osano actively maintains this open source project. Osano is a B-corp and is backed by millions of dollars in venture capital to create data privacy tools for the world. Our mission is to create transparency in data, please consider [joining our team](https://www.osano.com/company/careers).
Ensuring that your website is compliant with various laws can be complicated. To effectively use **any** open source consent manager, you will need to do GeoIP lookups, adjust the consent types based on visitor location, callback and save consents in a database, and create callbacks to load scripts after consent is granted.
Osano offers a completely [free hosted consent management platform][cl], with additional features. If you have a high traffic website or need additional privacy tools, Osano offers paid plans as well. **Unless you specifically need the open source tool, most website owners will be better served by the hosted version.** If you use Osano for your business, please support continued development by purchasing a [paid plan](https://www.osano.com/plans?utm_campaign=Open%20Source%20Cookie%20Consent&utm_source=github).
The hosted version of the cookie consent manager provides additional capabilities such as:
* Multi-lingual, translated into 38 languages and growing. Visitors automatically see the dialog in their browser or OS preferred language.
* Consents are stored automatically on the blockchain. REST API calls are available to developers to search and browse the consent records.
* 3rd party script blocking and loading does not require callbacks but is instead configurable from a dashboard providing developers with control over what the marketing team can enable or disable.
* Hosted on AWS Cloudfront with edges around the globe for
## Basic Use
With version 4.0 you only need to attach the script as we've bundled everything together now. The initialization style has changed as have the callbacks (they're gone). Please see the text below to get started. Then, take a look at updated API via the [docs][dl].
#### Module
```
import CC from "CookieConsent"
// or
const CC = require( "CookieConsent" )
```
#### Classic
```
const CC = window.CookieConsent
```
##### Initialization:
```
const cc = new CC({
//...options,
type : "categories"
})
```
##### Lifecycle hooks, are now events:
```
cc.on( "initialized", ( ...args ) => console.log( args ) )
cc.on( "error", console.error )
cc.on( "popupOpened", () => console.log( "Popup Open" ) )
cc.on( "popupClosed", () => console.log( "Popup Closed" ) )
cc.on( "revokeChoice", () => console.log( "Popup Reset" ) )
cc.on( "statusChanged", ( ...args ) => console.log( args ) )
```
## Version 4.0
Lots of updates & some breaking changes... but they're all for the better, we promise!
## Version 3.1
Reflects the ownership change of the Cookie Consent project. Now actively maintained by:
- @arlogilbert
- @L0key
- @pgoforth
## Version 3.0
Version 3.0 is a complete rewrite from version 2. The most substantial new features are:
- Ability to GeoLocate and only show the add-on to people in the relevant countries
- Callback hooks for showing/accepting/revoking the banner
- Support for different types of compliance, giving you the flexibility to obey even the strictest cookie laws
- Easy no-fuss themes and customisable styles
## Installation
The easiest way to get up and running is to use our [wizard][dll].
You can also install this project through [npm](https://www.npmjs.com/package/cookieconsent):
```sh
npm install cookieconsent
```
Or through [Yarn](https://yarnpkg.com/en/package/cookieconsent):
```sh
yarn add cookieconsent@3
```
Or through [Bower](https://bower.io/):
```sh
bower install cookieconsent
```
Or via a jsDelivr:
```html
```
## Documentation
See our [full documentation][dl].
## Contributing
Feel free to improve the plugin and send us a pull request.
The easiest way to develop is to host the files with a local webserver. e.g.
```sh
python -m SimpleHTTPServer
```
We use Babel, Terser, and PostCSS to compile the SCSS and minify the JavaScript. You can run a build with:
```sh
npm run build
```
or
```sh
yarn run build
```
## Legal Mumbo Jumbo
Osano is a registered trademark of Osano, Inc.
Nothing on the Osano website, platform, services, or software, nor any portion thereof constitutes actual legal or regulatory advice, opinion, or recommendation by Osano, Inc. or Osano International Compliance Services LTD.
**If legal assistance is required, users should seek the services of an attorney.**
## Export Control
This distribution includes cryptographic software. The country in which you
currently reside may have restrictions on the import, possession, use, and/or
re-export to another country, of encryption software. BEFORE using any
encryption software, please check your country's laws, regulations and
policies concerning the import, possession, or use, and re-export of encryption
software, to see if this is permitted. See for more
information.
The U.S. Government Department of Commerce, Bureau of Industry and Security
(BIS), has classified this software as Export Commodity Control Number (ECCN)
5D002.C.1, which includes information security software using or performing
cryptographic functions with asymmetric algorithms. The form and manner of this
Apache Software Foundation distribution makes it eligible for export under the
License Exception ENC Technology Software Unrestricted (TSU) exception (see the
BIS Export Administration Regulations, Section 740.13) for both object code and
source code.
[li]: https://img.shields.io/badge/license-MIT-brightgreen.svg
[ll]: LICENSE
[bl]: https://travis-ci.org/osano/cookieconsent
[bi]: https://travis-ci.org/osano/cookieconsent.svg?branch=master
[dl]: https://www.osano.com/cookieconsent/documentation/
[dll]: https://www.osano.com/features/consent-management?utm_campaign=Open%20Source%20Cookie%20Consent&utm_source=github
[cl]: https://www.osano.com/features/consent-management?utm_campaign=Open%20Source%20Cookie%20Consent&utm_source=github
[ti]: https://img.shields.io/twitter/url/https/osanoatx.svg?style=social
[tl]: https://twitter.com/osano