/
readme.txt
executable file
·257 lines (208 loc) · 15.7 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
=== Plugin Name ===
Contributors: Diego La Monica
Tags: Cookie, Cookie Law, Law Compliance, EU Cookie Law, blocco preventivo, cookie block, cookie consent, cookie policy, cookie banner
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=me%40diegolamonica%2einfo&lc=IT&item_name=EU%20Cookie%20Law&no_note=0¤cy_code=EUR&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest
Requires at least: 4.0
Tested up to: 4.2.4
Stable tag: 2.5.0
License: LGPLv3
License URI: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
A Wordpress solution to the European Cookie Law Issue
== Description ==
EUROPA websites must follow the Commission's guidelines on [privacy and data protection](http://ec.europa.eu/ipg/basics/legal/data_protection/index_en.htm) and inform
users that cookies are not being used to gather information unnecessarily.
The [ePrivacy directive](http://eur-lex.europa.eu/LexUriServ/LexUriServ.do?uri=CELEX:32002L0058:EN:HTML) – more specifically Article 5(3) – requires prior informed consent for storage for access to information stored on a user's terminal equipment.
In other words, you must ask users if they agree to most cookies and similar technologies (e.g. web beacons, Flash cookies, etc.) before the site starts to use them.
For consent to be valid, it must be informed, specific, freely given and must constitute a real indication of the individual's wishes.
In this context this plugin lives.
It simply alters the default `document.cookie` behavior to disallow cookies to be written on the client side,
until the user accept the agreement. The same does for the server side where since the user does not have accepted the agreement,
then it would not store any cookie.
**Note that this plugin blocks any URL you define which generates third-party cookies.**
To get detailed informations about the plugin go to https://github.com/diegolamonica/EUCookieLaw
== Installation ==
For manual installation using WordPress plugin installer:
* download the zip file
* upload via the WordPress plugin installer page
* Activate the plugin
For manual installation via FTP
* extract files in a local directory
* upload through FTP the whole directory contents under `/wp-content/plugins/eucookielaw`.
* Goto plugin administration panel
* Activate the plugin
== Screenshots ==
1. The configuration page
== Changelog ==
= 2.5.0 =
* **NEW**: Now you can define the domain where the cookie will be applied
* **IMPROVEMENTS**: Javascript page reload forces contents from server (ignoring browser cache)
* **IMPROVEMENTS**: Better readability of the header file
* **BUGFIX**: `WP_CONTENT_DIR` defined instead of `EUCL_CONTENT_DIR` causes some problems if site is without cache.
* Minor bugfixes and general improvements
* updated documentation
* updated the version number
= 2.4.0 =
* **NEW**: Now you can set the number of pixels for consent on scroll
* **NEW**: If not configured (as constants) the agree and disagree links will be auto-generated by the server.
* **NEW**: \[WP\] If you type twice a blocked URL or if a rule is already covered from another one then it will be visually noticed.
* **NEW**: \[WP\] You can now analyze your home page to which external URL are called and which ones is producing cookeis.
* **NEW**: \[WP\] If user agent contains the information `EUCookieLaw:<VERSION_NUMBER>` then it will bypass the cookielaw block (used by the site analyzer).
* **IMPROVEMENTS**: If you define an empty rule in disallowed URLS it will be ignored
* **IMPROVEMENTS**: \[WP\] Several improvements on admin page and admin JavaScript
* **IMPROVEMENTS**: On localhost (`127.0.0.1`) the domain defined for the technical cookie must be empty to grand compatibility with some browsers.
* **BUGFIX**: `header_remove` method in PHP prior 5.3 does not exists.
* **BUGFIX**: The non JavaScript version of banner was containing wrong consent/rejection URL
* **BUGFIX**: \[WP\] With some W3 Total Cache configuration, EUCookieLaw was producing invalid output
* **BUGFIX**: \[WP\] Path definition confilcts with NextGenGallery
* **BUGFIX**: \[WP\] On settings page the *Replaced scripts source* assumes the value of *Replaced iframe source* also if the value is correctly saved.
* updated translation files
* updated documentation
* updated the version number
= 2.3.2 =
* **BUGFIX**: \[WP\] JavaScript for the admin interface was corrupted.
* **BUGFIX**: \[WP\] Unable to save settings due to a `1` accidentally placed in the wrong place.
* **IMPROVEMENTS**: \[WP\] Admin interface minor improvements
= 2.3.0 =
* **NEW**: Now there are two parsing engine, one based on regular expressions and one based on DOMDocument.
* **NEW**: \[WP\] Now you can import and export settings to apply the same contents on multiple sites easly.
* **NEW**: Now you can write debug informations on file.
* **NEW**: \[WP\] When the plugin's debug is enabled you will see an alert on every admin page.
* **NEW**: New theme `floating` available.
* **IMPROVEMENTS**: \[WP\] Admin interface improved
* **IMPROVEMENTS**: Improved documentation
* updated translation files
* updated documentation
* updated the version number
= 2.2.2 =
* **IMPROVEMENTS**: Some JavaScript were not detected by the server if formatted in certain formats.
* **BUGFIX**: \[WP\] When W3 Total Cache is enabled and you do not have right permissions on file the message as quite cryptical.
= 2.2.0 =
* **NEW**: \[WP\] On tinyMCE (visual editor) you have the EUCookieLaw helpers
* **NEW**: Now you can define which is the default file replacement for `iframe`s and `script`s.
* **IMPROVEMENT**: \[WP\] Now only administrators can access the settings page
* **BUGFIX**: Due to a typos the client side cookies (generated by JavaScript) are always written
* updated the version number
= 2.1.4 =
* **IMPROVEMENT**: If not defined the `EUCOOKIELAW_BANNER_DISAGREE_BUTTON` the disagree button will not be shown on the page.
* **IMPROVEMENT**: Removed the session/local storage in favor of technical session cookie for storing the user rejection
* **IMPROVEMENT**: Improved the way to detect if the cookie is approved or rejected
* **IMPROVEMENT**: Uniformed the way to write the technical cookie `__eucookielaw`
* **IMPROVEMENT**: Improved the way how the banner is removed
* **IMPROVEMENT**: Updated missing pieces in documentation.
* **IMPROVEMENT**: Optimized behavior when asked reload of contents after consent.
* **BUGFIX**: Resolved an [anicient related firefox issue](https://bugzilla.mozilla.org/show_bug.cgi?id=356558)
* **BUGFIX**: \[WP\] if the disabled option is set to yes, neither the JavaScript and CSS must be loaded on the page.
* **BUGFIX**: Minor bugfixes in JavaScript
* updated the minor version number
* updated documentation
= 2.1.0 =
* **BUGFIX**: when PHP does not have gzdecode the method is implemented on needs.
* **BUGFIX**: Internet Explorer and some mobile Browser does not recognize the `instance` variable as `EUCookieLaw` object causing a bad banner behavior.
* **BUGFIX**: \[WP\] NextGenGallery has some weird behavior sometimes (skipped to load the locker if it is a NGG URL.
* **IMPROVEMENT**: \[WP\] The plugin now tries to write into `wp-config.php` only if there is another cache plugin enabled on the site.
* **IMPROVEMENT**: EUCookieLaw related PHP Warnings threated as required
* updated documentation
* updated the version number
= 2.0.2 =
* **CRITICAL**:
Most of WordPress sites uses a FTP settings for writing files. Used native `file_get_contents` and `file_put_contents`
to write data into some files for a better user experience.
* **BUGFIX**: Changed stable version number in readme
= 2.0 =
* **NEW:** [\WP\] Full compliant with any cache plugin (actually successfully tested with **WP Super Cache**, **W3 Total Cache**, **Zen Cache**)
* **NEW:** The banner is now visible either with and without javascript enabled.
* **NEW:** User consent whenever he clicks on an element of the page (Issue [#12](https://github.com/diegolamonica/EUCookieLaw/issues/12))
* **NEW:** You can list the allowed cookies before consent (aka *Technical Cookies*). This solves the issue [#15](https://github.com/diegolamonica/EUCookieLaw/issues/15)
* **NEW:** Now Google Analytics is able to write cookies via JavaScript (if configured) (Issue [#15](https://github.com/diegolamonica/EUCookieLaw/issues/15))
* **NEW:** \[WP\] You can enable/disable the banner on frontend (Issue [#20](https://github.com/diegolamonica/EUCookieLaw/issues/20))
* **NEW:** \[WP\] You can enable/disable the banner on the login page (Issue [#21](https://github.com/diegolamonica/EUCookieLaw/issues/21))
* **NEW:** You can set the "reload on scroll" (Issue [#26](https://github.com/diegolamonica/EUCookieLaw/issues/26))
* **NEW:** \[WP\] Added the WPML XML Configuration File for a better WPML compatibility.
* **IMPROVEMENT:** \[WP\] Lack of documentation on certain admin fields (Issue [#27](https://github.com/diegolamonica/EUCookieLaw/issues/27))
* **IMPROVEMENT:** Most of PHP Code was completely refactored from the ground to improve performance and readability.
* **BUGFIX:** \[WP\] NextGenGallery conflict resolved (Issue [#31](https://github.com/diegolamonica/EUCookieLaw/issues/31))
* **BUGFIX:** \[WP\] QuickAdsense conflict resolved (Issue [#36](https://github.com/diegolamonica/EUCookieLaw/issues/36) and [#32](https://github.com/diegolamonica/EUCookieLaw/issues/32) )
* **BUGFIX:** \[WP\] Revolution Slider conflict resolved (Issue [#37](https://github.com/diegolamonica/EUCookieLaw/issues/37))
* **BUGFIX:** Page URL changes after reload (Issue [#38](https://github.com/diegolamonica/EUCookieLaw/issues/38))
* **BUGFIX:** Scroll on tablet does not work (Issue [#40](https://github.com/diegolamonica/EUCookieLaw/issues/40))
* **BUGFIX:** Invalid Calling Object in Internet Explorer 9 and Safari was resolved (Issue [#41](https://github.com/diegolamonica/EUCookieLaw/issues/41))
* updated translation files
* updated documentation
* updated the version number
= 1.5 =
This update introduces several improvements, features and bugfixes. For a detailed information about the new release see
the [documentation page](https://github.com/diegolamonica/EUCookieLaw/) and the [Milestone 1.5](https://github.com/diegolamonica/EUCookieLaw/issues?q=milestone%3A1.5+is%3Aclosed)
* **NEW:** Now the plugin is able to detect if the user agent and does not block contents if it is search engine
* **NEW:** All the external contents are loaded after the user consent without page reloading ( Issues [#4](https://github.com/diegolamonica/EUCookieLaw/issues/4) and [#10](https://github.com/diegolamonica/EUCookieLaw/issues/10))
* **NEW:** The script allows to define the consent duration in days (Issue [#7](https://github.com/diegolamonica/EUCookieLaw/issues/7), [#17](https://github.com/diegolamonica/EUCookieLaw/issues/17) and [#23](https://github.com/diegolamonica/EUCookieLaw/issues/23))
* **NEW:** Now is possible to check almost in every HTML element ( Implicitly resolved issue [#6](https://github.com/diegolamonica/EUCookieLaw/issues/6))
* **NEW:** The script remembers the user rejection.
* **NEW:** New JavaScript public method `reconsider` to revoke the consent (and the rejection) showing the banner again (Issue [#7](https://github.com/diegolamonica/EUCookieLaw/issues/7))
* **NEW:** \[WP\] Added shortcode for reconsider button (see documentation for further details) (Issue [#7](https://github.com/diegolamonica/EUCookieLaw/issues/7))
* **NEW:** \[WP\] Added shortcode for wrapping contents (see documentation for further details)
* **NEW:** Now the consent on scroll is fired at least after 100px scroll (up or down)
* **IMPROVEMENT:** \[WP\] Made compliant with **WP Super Cache**, **W3 Total Cache**, **Zen Cache** (Issue [#23](https://github.com/diegolamonica/EUCookieLaw/issues/23))
* **IMPROVEMENT:** Javascript has been refactored to improve performance and maintenability
* **IMPROVEMENT:** \[WP\] Admin interface improved
* **IMPROVEMENT:** Some CSS improvements (Issue (Issue [#8](https://github.com/diegolamonica/EUCookieLaw/issues/8))
* **BUGFIX:** Consent on scroll doesn't work propery
* **BUGFIX:** \[WP\] Custom content path not recognized correctly ( Issue [#9](https://github.com/diegolamonica/EUCookieLaw/issues/9))
* **BUGFIX:** Typos where `script` was written as `srcript` on server script (Issue [#16](https://github.com/diegolamonica/EUCookieLaw/issues/16))
* **BUGFIX:** Only first occourrence of the same/similar URL is blocked (Issue [#19](https://github.com/diegolamonica/EUCookieLaw/issues/19))
* **BUGFIX:** Corrected some IE8 weird behavior
* updated translation files
* updated documentation
* updated the version number
= 1.4.1 =
* **BUGFIX:** fixed the javascript that has wrong characters in the script
* Fixed errors in documentation
= 1.4 =
* **NEW:** when you specify a domain starting with a dot (eg. `.google.com`) all the subdomains are valid (eg. `www.google.com` and `sub.domain.google.com`)
* **NEW:** Improved the banner loading (loaded before the DOM Event `load`)
* **NEW:** Optional implicit user agree on page scrolling ([Issue #4](https://github.com/diegolamonica/EUCookieLaw/issues/4)).
* **NEW:** Debugging options
* **NEW:** You can fix the banner on top or bottom of the page.
* **NEW:** The custom CSS (from `EUCookieLawCustom`) will be loaded in conjunction with the default CSS.
* **BUGFIX:** removed the `<![CDATA[ ... ]]>` envelop on script replacement due to some browser incompatibility.
* **BUGFIX:** Custom translations was never read
* updated translation files
* updated documentation
* updated the version number
= 1.3.1 =
* **BUGFIX:** the default text for disagree button when not given was `Disagree` instead it should be empty.
* **BUGFIX:** whatever is the name of the plugin directory the directory for the customizations (translations and CSS) must be `/wp-content/plugins/EUCookieLawCustom/`.
* updated documentation
* updated the version number
= 1.3 =
* Updated the eucookielaw-header.php,
* **NEW:** now the disallowed domains trims the spaces on each domain. It means that is allowed to write `domain1.com ; domain2.com` and they will be correctly interpreted as `domain1.com` and `domain2.com`
* **NEW:** If not defined the disagee label text then the button is not shown. Useful for informative non-restrictive cookie policy.
* **BUGFIX:** the cookie `__eucookielaw` setted by javascript is defined at root domain level.
* updated documentation
* updated the version number
= 1.2 =
* Updated the eucookielaw-header.php,
* **NEW:** now the search of url is performed in `<script>...</script>` tags too.
* **BUGFIX:** some translations strings were broken.
* updated translation files
* updated documentation
* updated the version number
= 1.1 =
This update introduces several improvements, features and bugfixes. For a detailed information about the new release see:
[Issue #1](https://github.com/diegolamonica/EUCookieLaw/issues/1)
* updated the eucookielaw-header.php,
* **NEW:** now it blocks script tags with `data-eucookielaw="block"` attribute
* **NEW:** now is possible to define a blacklist of domains to block before the user consent the agreement
* **NEW:** the blacklist is related to a set of tags (by default the plugin will scan `iframe`, `link` and `script` tags
* **NEW::** managed title tag, blocked domains and tags to scan
* **NEW:** if the plugin WP Super Cache is installed then the plugin will clear the cache until the user has not approved the agreeement to ensure to show always the right contents
* **NEW::** if there is a CSS file named `eucookielaw.css` in the custom directory `wp-content/plugins/EUCookieLawCustom/` the it will be appliead in place of the default one.
* **BUGFIX:** unescaped post data before saving the admin settings
* updated the version number
* updated translation strings
* updated documentation
= 1.0 =
* First release
== FAQ ==
* **How can I customize the banner style?**
Please visit the [official documentation page on GitHub](https://github.com/diegolamonica/EUCookieLaw)