cookiebot
Last commit date
addons
7 years ago
assets
7 years ago
css
7 years ago
documentation
7 years ago
langs
8 years ago
CookiebotAPI.md
7 years ago
LICENSE.txt
8 years ago
README.md
7 years ago
cookiebot-logo.png
8 years ago
cookiebot.php
7 years ago
phpunit.xml
7 years ago
readme.txt
7 years ago
readme.txt
271 lines
| 1 | # Cookiebot | GDPR Compliant Cookie Consent and Notice # |
| 2 | * Contributors: cookiebot,phpgeekdk,aytac |
| 3 | * Tags: cookie, compliance, eu, gdpr, europe, cookie consent, consent |
| 4 | * Requires at least: 4.4 |
| 5 | * Tested up to: 5.1 |
| 6 | * Stable tag: 2.4.1 |
| 7 | * Requires PHP: 5.4 |
| 8 | * License: GPLv2 or later |
| 9 | |
| 10 | Cookiebot is a fully GDPR & ePrivacy compliant cookie consent solution supporting prior consent, cookie declaration, and documentation of consents. Easy to install, implement and configure. |
| 11 | |
| 12 | ## Description ## |
| 13 | |
| 14 | ### What Cookiebot Offers ### |
| 15 | |
| 16 | Cookiebot is a cloud-driven solution that offers: |
| 17 | |
| 18 | * A highly customizable consent banner to handle user consents and give the users the required possibility to opt-in and -out of cookie categories. |
| 19 | * A cookie policy and declaration, with purpose descriptions and automatic categorization of your cookies (strictly necessary, preference, statistics, marketing). |
| 20 | * Full monthly scans to detect all tracking in place on the website as well as detection of where data is being sent to and where in the source code the cookie can be found. |
| 21 | * A scanner that detects various online trackers such as Cookies, HTML5 Local Storage, Flash Local Shared Object, Silverlight Isolated Storage, IndexedDB, ultrasound beacons, pixel tags etc. |
| 22 | * An easy way to allow the users to change or withdraw their consent. |
| 23 | * Translations for 44 languages and the ability to change the text on the banner and declaration for any language. |
| 24 | * Storage of user-consents in our cloud-driven environment, which are downloadable and can be used as proof. |
| 25 | * Execution of cookie-setting scripts without a page reload, if the user gives consent. |
| 26 | |
| 27 | Please read our FAQ at the bottom of the page for more information. |
| 28 | |
| 29 | https://youtube.com/watch?v=t1LJ6i1i9gA |
| 30 | |
| 31 | ### Will my website become compliant once I install Cookiebot? ### |
| 32 | The short answer is; no. |
| 33 | |
| 34 | Although Cookiebot enables your website to become fully compliant, [especially obeying the prior consent rule](https://support.cookiebot.com/hc/en-us/articles/360004104033-What-does-prior-consent-mean-and-how-do-I-implement-it-), some manual work is required to achieve compliance. |
| 35 | |
| 36 | * If you are using plugins that set cookies which require consent (which most do), you have to: |
| 37 | * Ask the plugin developers if they are planning on becoming GDPR compliant, or if they would like to integrate with Cookiebot. |
| 38 | * Check if there already exists an addon for your plugin in the "Prior consent" submenu. |
| 39 | * [Check out our Github repository](https://github.com/CybotAS/CookiebotAddons), where we are developing integrations for Cookiebot, until the plugin developers choose to do this themselves, [or WP Core enables such functionality](https://core.trac.wordpress.org/ticket/44043) |
| 40 | |
| 41 | Once Cookiebot is installed, and we've scanned your site, you can check the [cookie report](https://manage.cookiebot.com/goto/reports), to identify all cookies being set on your website. If the cookies are coming from content that you have inserted manually, then you can mark up that content [as described in our help section step 3](https://www.cookiebot.com/goto/help/). |
| 42 | |
| 43 | Embedded videos and iframes, which set cookies, can be marked up as explain in our [Iframe cookie consent with YouTube example](https://support.cookiebot.com/hc/en-us/articles/360003790854-Iframe-cookie-consent-with-YouTube-example). |
| 44 | |
| 45 | |
| 46 | ### Cookiebot Addons #### |
| 47 | Add-ons are produced by an open-source community of developers. This is done to help make it easier for Wordpress users to implement ‘prior consent’ for cookies and trackers set by plugins that do not offer this as a built-in functionality. |
| 48 | |
| 49 | The add-ons are currently the best alternative to a Wordpress Core framework that can signal the user’s consent state to other plugins (if and when this will be implemented is unknown) and to those plugins who do not yet offer native support for Cookiebot built into the plugin itself. |
| 50 | |
| 51 | We do not assume any responsibility for the use of these add-ons. If one of the plugins that the add-ons hook into makes a ‘breaking change’, there may be a period of time where the add-on will not work properly until it has been updated to accommodate the changes in the plugin. |
| 52 | |
| 53 | If your favourite plugin isn't supported you're welcome to contribute or request on our [Github development page](https://github.com/CybotAS/CookiebotAddons). |
| 54 | |
| 55 | |
| 56 | ## Installation ## |
| 57 | First, install the plugin on your WordPress site. |
| 58 | |
| 59 | Then, go to Settings -> Cookiebot and add your Cookiebot ID. |
| 60 | |
| 61 | If you haven't created one yet - or if you're not sure how to find it - follow the instructions on the page. |
| 62 | |
| 63 | Once your Cookiebot ID is added, the consent dialog will be displayed to the visitors of your site. |
| 64 | |
| 65 | [For more help, visit our support section, that contains various articles on how to set up Cookiebot properly](https://support.cookiebot.com/). |
| 66 | |
| 67 | **Installation video:** |
| 68 | |
| 69 | https://www.youtube.com/watch?v=t1LJ6i1i9gA |
| 70 | |
| 71 | **Implementing the cookie declaration:** |
| 72 | |
| 73 | https://youtu.be/OCXz2bt4H_w |
| 74 | |
| 75 | **Implementing prior consent:** |
| 76 | |
| 77 | https://youtu.be/MeHycvV2QCQ |
| 78 | |
| 79 | ## Frequently Asked Questions ## |
| 80 | |
| 81 | ### Is Cookiebot free? ### |
| 82 | Cookiebot is a freemium plugin, much like [Jetpack](https://wordpress.org/plugins/jetpack/) and [Monsterinsights](https://wordpress.org/plugins/google-analytics-for-wordpress/). |
| 83 | |
| 84 | Whether the free plan can suffice or you need a premium plan, depends on two things: |
| 85 | |
| 86 | **1. The size of your website, i.e. the number of subpages on your website.** |
| 87 | In other words, you cannot choose whether you want a free plan or a premium plan, as this is determined by the amount of subpages on your website. You can [get a quote](https://www.cookiebot.com/en/quote-input/) to see what plan you need for your website. |
| 88 | |
| 89 | **2. Your necessities, as the free plan does not include all features available in the premium plans.** The free plan does not include customization of banner and cookies declaration, multiple languages, e-mail reports, data-export, geo location, bulk consent, consent statistics, internal domain alias for development, test and staging. |
| 90 | |
| 91 | No matter the size of your website, you do have the right to a one month trial of Cookiebot for free. |
| 92 | |
| 93 | See all details of [Cookiebot plans and pricing](https://www.cookiebot.com/en/pricing/). |
| 94 | |
| 95 | ### What does Cookiebot count as pages? |
| 96 | Your pricing plan is dependent on the number of subpages we have detected on your website. |
| 97 | |
| 98 | Some users mistakenly think that Cookiebot counts their **image files** as subpages, thus setting the users on a higher subscription plan. |
| 99 | |
| 100 | Cookiebot does **not count image files as subpages**. Depending on your theme, Wordpress may automatically create real pages for content placed in your media library, called Attachment pages. Because these pages can contain online trackers, Cookiebot includes them in your page count. |
| 101 | |
| 102 | To disable the Attachment page feature in Wordpress, please see the following guides: |
| 103 | |
| 104 | https://themeskills.com/disable-media-attachment-pages-wordpress/ |
| 105 | https://www.wpexplorer.com/disable-image-page/ |
| 106 | |
| 107 | ### Cookie declaration ### |
| 108 | The Cookiebot solution also includes an automatically updated cookie declaration about the cookies in use on your site. |
| 109 | |
| 110 | By implementing it, you ensure that your cookie declaration is specific and accurate at all times, as required by the GDPR. Also, the declaration automatically provides the mandatory options for the user to change or withdraw consent. |
| 111 | |
| 112 | To display your cookie declaration, create a new page on your website - and add the shortcode that the plugin provides to the page: [cookie_declaration]. Alternatively, you can incorporate it into e.g. your existing Privacy Policy. |
| 113 | |
| 114 | By default the cookie declaration is displayed in the chosen Cookiebot language. You are able to override this setting with a "lang" attribute in the shortcode. Eg.: [cookie_declaration lang="de"] for a German version. Remember to add all used languages in the Cookiebot administration tool. |
| 115 | |
| 116 | https://youtu.be/OCXz2bt4H_w |
| 117 | |
| 118 | ### Cookie-checker: What cookies are in use on my site? ### |
| 119 | If you are in doubt about what cookies are in use on our site, you can start by trying our free compliance test: |
| 120 | |
| 121 | **[Test my site](https://www.cookiebot.com/en/)** |
| 122 | |
| 123 | The test scans five pages of your website and sends you a complete report of the cookies and online tracking on these pages, including information on their provenance, purpose and whether or not they are compliant with the EU-regulations. |
| 124 | |
| 125 | If you want a complete overview of the cookies and online tracking going on on all of your website, sign up to the Cookiebot solution. |
| 126 | |
| 127 | ### What is GDPR? ### |
| 128 | The GDPR is the General Data Protection Regulation, a EU-law that is enforced on the 25. May 2018, and affects all organizations and websites that handle data of EU-citizens. |
| 129 | |
| 130 | See the [EU homepage of the GDPR](https://www.eugdpr.org/) for more information, and their infographic for businesses: [Data Protection: Better rules for small businesses](http://ec.europa.eu/justice/smedataprotect/index_en.htm) |
| 131 | |
| 132 | ### How do I make other plugins support Cookiebot? ### |
| 133 | If you favourite plugins doesn't support Cookiebot you always welcome to ask the author to add support for Cookiebot. |
| 134 | |
| 135 | Send an e-mail to the author of the plugin you want to support Cookiebot. Ask for adding support for Cookiebot. Cookiebot provides a helper function to check if there is an active, working version of Cookiebot on the website. |
| 136 | |
| 137 | The easiest way for at developer to implement Cookiebot support is following to add a check for Cookiebot where <script> tags are outputted to the visitor. This can be done following way |
| 138 | |
| 139 | $scriptTag = '<script>'; |
| 140 | if(function_exists('cookiebot_active') && cookiebot_active()) { |
| 141 | $scriptTag = '<script'.cookiebot_assist('statistics').'>'; |
| 142 | } |
| 143 | |
| 144 | The developer of the plugin can see more details on [our Github repository](https://github.com/CybotAS/CookiebotAddons) |
| 145 | |
| 146 | ### Can I use Cookiebot with GTM? ### |
| 147 | Cookiebot works with GTM, however you need to enable the "Hide Cookie Popup" option on the Cookiebot plugin settings page. |
| 148 | |
| 149 | [Please see our article on how to depoloy Cookiebot with GTM](https://support.cookiebot.com/hc/en-us/articles/360003793854-Google-Tag-Manager-deployment). |
| 150 | |
| 151 | |
| 152 | ## Changelog ## |
| 153 | |
| 154 | ### 2.4.1 - 2019-03-19 ### |
| 155 | * Fix jetpack related warning |
| 156 | |
| 157 | ### 2.4.0 - 2019-03-19 ### |
| 158 | * Fixed bug resulting in some tags where not tagged |
| 159 | * Change Piwik addon to use output buffering |
| 160 | * Clean up redundant code in addons |
| 161 | |
| 162 | ### 2.3.0 - 2019-03-13 ### |
| 163 | * Added GADWP addon |
| 164 | * Changes in file structure of plugin |
| 165 | |
| 166 | ### 2.2.2 - 2019-02-12 ### |
| 167 | * Fix warning non-static call to get_cbid |
| 168 | |
| 169 | ### 2.2.1 - 2019-02-12 ### |
| 170 | * Adding support for WPForms |
| 171 | * Add plugin deactivation hook for addons |
| 172 | |
| 173 | ### 2.2.0 - 2019-02-11 ### |
| 174 | * Adding support for network wide settings on Multisite Wordpress setups. |
| 175 | |
| 176 | ### 2.1.5 - 2019-01-17 ### |
| 177 | * New addon: Custom Facebook Feed Pro |
| 178 | * Adding support for setting none, defer or async to Cookiebot script tags |
| 179 | |
| 180 | ### 2.1.3 - 2018-11-18 ### |
| 181 | * New addon: Popups by OptinMonster |
| 182 | * Added support for grouping addons for different versions of same plugin |
| 183 | |
| 184 | ### 2.1.2 - 2018-11-06 ### |
| 185 | * Auto correct addon added support for single quotes in iframe embeds |
| 186 | |
| 187 | ### 2.1.1 - 2018-11-02 ### |
| 188 | * Updated addons with new tests and better plugin integration |
| 189 | |
| 190 | ### 2.1.0 - 2018-10-05 ### |
| 191 | * Updated addons improved handling of tags |
| 192 | * Adding Basque as language option |
| 193 | * Remove .git files in addons |
| 194 | |
| 195 | ### 2.0.6 - 2018-09-26 ### |
| 196 | * Updated addons to support newest version of CAOS |
| 197 | * Minor bugfixes and text adjustments |
| 198 | |
| 199 | ### 2.0.5 - 2018-09-21 ### |
| 200 | * Added "Leave a review" admin notice |
| 201 | |
| 202 | ### 2.0.4 - 2018-09-18 ### |
| 203 | * Added [IAB Consent Framework](https://support.cookiebot.com/hc/en-us/articles/360007652694-Cookiebot-and-the-IAB-Consent-Framework) option |
| 204 | * Update Cookiebot Addons |
| 205 | * Minor bugfixes |
| 206 | |
| 207 | ### 2.0.3 - 2018-08-10 ### |
| 208 | * Removing informative message in admin_notice. Causing parse error for some users. |
| 209 | |
| 210 | ### 2.0.2 - 2018-08-01 ### |
| 211 | * Quickfix - disable Script Config. Made trouble for some users. |
| 212 | |
| 213 | ### 2.0.1 - 2018-08-01 ### |
| 214 | * Disable load of Addons if server runs PHP < 5.4. |
| 215 | * Fix placeholder in addons |
| 216 | |
| 217 | ### 2.0.0 - 2018-07-30 ### |
| 218 | * Merge Cookiebot and Cookiebot Addons plugins. Cookiebot plugin now bundled with addons making other plugins GDPR compliant. |
| 219 | |
| 220 | ### 1.6.2 - 2018-06-21 ### |
| 221 | * Fix check for WP Rocket. |
| 222 | |
| 223 | ### 1.6.1 - 2018-06-11 ### |
| 224 | * Fixing shortcode when using WP Rocket |
| 225 | |
| 226 | ### 1.6.0 - 2018-05-30 ### |
| 227 | * Support for removing cookie consent banner for tag manager users |
| 228 | * Support for multiple consent types in cookie_assist - eg. cookie_assist(['marketing','statistics']); |
| 229 | * Loading Cookiebot JS on admin pages too |
| 230 | * Adjusting help texts and adding links to demonstration videos. |
| 231 | |
| 232 | ### 1.5.1 - 2018-05-25 ### |
| 233 | * Adjusting readme.txt including new video |
| 234 | |
| 235 | ### 1.5.0 - 2018-05-22 ### |
| 236 | * Adding autoupdate for Cookiebot |
| 237 | |
| 238 | ### 1.4.2 - 2018-05-17 ### |
| 239 | * Fix undefined $lang bug in shortcode output |
| 240 | |
| 241 | ### 1.4.1 - 2018-05-11 ### |
| 242 | * Adjusting readme file |
| 243 | |
| 244 | ### 1.4.0 - 2018-05-10 ### |
| 245 | * Adding support for specifying language of cookie banner |
| 246 | * Adding optional "lang" attribute to [cookie_declaration] shortcode |
| 247 | |
| 248 | ### 1.3.0 - 2018-04-29 ### |
| 249 | * Bug fixed: Headers already sent when editing pages using shortcode |
| 250 | |
| 251 | ### 1.2.0 - 2018-03-28 ### |
| 252 | * Updating readme file with more details |
| 253 | * Adding cookiebot_active helper function |
| 254 | |
| 255 | ### 1.1.2 - 2018-02-27 ### |
| 256 | * Removing short array syntax to improve compatibility |
| 257 | |
| 258 | ### 1.1.1 - 2018-02-02 ### |
| 259 | * Adjusting readme.txt |
| 260 | |
| 261 | ### 1.1.0 - 2018-02-02 ### |
| 262 | * Adding data-culture to cookiebot script tags. |
| 263 | |
| 264 | ### 1.0.0 ### |
| 265 | * Initial release of the plugin. |
| 266 | |
| 267 | |
| 268 | ## Copyright and Trademarks ## |
| 269 | |
| 270 | Cookiebot is a registered trademark of Cybot A/S |
| 271 |