PHPackages                             gmazzap/gm-cookie-policy - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. gmazzap/gm-cookie-policy

ActiveWordpress-plugin

gmazzap/gm-cookie-policy
========================

A simple plugin to show a message for compliance with EU cookie law.

0.2.2(9y ago)12845MITPHPPHP >=5.4

Since Apr 20Pushed 9y ago2 watchersCompare

[ Source](https://github.com/gmazzap/gm-cookie-policy)[ Packagist](https://packagist.org/packages/gmazzap/gm-cookie-policy)[ RSS](/packages/gmazzap-gm-cookie-policy/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (1)Versions (5)Used By (0)

EU Cookie Policy
================

[](#eu-cookie-policy)

A simple plugin to show a message for compliance with EU cookie law.

Support Composer, but does not require it. Requires PHP 5.4+.

Mainly developer-oriented, for basic needs can also be used by non-devs: basic configuration are available via UI, but advanced customization only via hooks.

Why yet another "cookie policy" plugin?
---------------------------------------

[](#why-yet-another-cookie-policy-plugin)

There're a few plugins that aim to do same thing, but I needed a plugin that:

- supports Composer natively
- works with javascript disabled
- provides a PHP API to be informed if current user accepted the policy
- provides a javascript API to be informed if current user accepted the policy, and also capable to notify other scripts in the moment the user accepts the policy
- doesn't do too much
- doesn't have dozen of options
- is not too "promotional"

And I could not found one that meets all the above requirements. So I wrote it.

Usage
-----

[](#usage)

After activation, a sub-menu will be added under the "Tools" main menu.

In the setting page accessible from there is possible to set the cookie policy notice message and few other basic options.

Many other customizations can be done via hooks.

PHP API
-------

[](#php-api)

When the plugin is active you can be informed if user accepted the policy via a filter:

```
$accepted = apply_filters('cookie-policy-accepted', false);
```

This way, anything that make use of "profiling cookies" can be disabled / not loaded when `$accepted`is false, fully applying EU law.

Since it is a filter, it does not lock-in to the plugin. Even if the plugin is disabled any code that relies on the filter above will not crash if plugin is not there.

However, PHP can reload page components (e.g. ads) when the user clicks the link to accept the policy (at least not without making another request), this is why there's also a javascript API.

javascript API
--------------

[](#javascript-api)

Making it short, the variable `window.cookiePolicy.accepted` is a boolean that is set to `true` when the user accepted the policy.

There are two custom events that scripts can listen to check that variable and acting accordingly.

The first event is `cookie-policy-loaded`, it happens right after the document is fully loaded.

```
jQuery(document).on('cookie-policy-loaded', function() {
    var cookiePolicy = window.cookiePolicy || { accepted: false };
    if (cookiePolicy.accepted) {
      // page just loaded, this is a returning user that already accepted policy before
    } else {
      // this user has not accepted policy yet, they might be just landed to website
    }
});
```

The other event is `cookie-policy-accepted`, that is triggered after the user accepted the policy:

```
jQuery(document).on('cookie-policy-accepted', function() {
    var cookiePolicy = window.cookiePolicy || { accepted: false };
    if (cookiePolicy.accepted) {
      // user just accepted policy, excellent, release the hounds :)
    } else {
      // this should never happen, if it does, something went wrong with javascript
    }
});
```

Just like PHP API, neither javascript API lock-in to the plugin. It is possible to disable the plugin without breaking anything and also replace the plugin with some other script that may trigger same events and set same variable for 100% backward compatibility.

Translations
------------

[](#translations)

The plugin comes with some translation:

- Italian
- Romanian (by @rmdiaconu)

PRs with more translations are welcome.

License
-------

[](#license)

MIT.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 96.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~9 days

Total

4

Last Release

3645d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2208282?v=4)[Giuseppe Mazzapica](/maintainers/gmazzap)[@gmazzap](https://github.com/gmazzap)

---

Top Contributors

[![gmazzap](https://avatars.githubusercontent.com/u/2208282?v=4)](https://github.com/gmazzap "gmazzap (25 commits)")[![rmdiaconu](https://avatars.githubusercontent.com/u/3409952?v=4)](https://github.com/rmdiaconu "rmdiaconu (1 commits)")

---

Tags

wordpresscookiecookie policy

### Embed Badge

![Health badge](/badges/gmazzap-gm-cookie-policy/health.svg)

```
[![Health](https://phpackages.com/badges/gmazzap-gm-cookie-policy/health.svg)](https://phpackages.com/packages/gmazzap-gm-cookie-policy)
```

###  Alternatives

[wp-media/wp-rocket

Performance optimization plugin for WordPress

7431.3M3](/packages/wp-media-wp-rocket)[roots/wp-stage-switcher

WordPress plugin that allows you to switch between different environments from the admin bar

382435.0k3](/packages/roots-wp-stage-switcher)[vinkla/wordplate

The WordPlate boilerplate

2.2k5.1k](/packages/vinkla-wordplate)[pods-framework/pods

Pods is a development framework for creating, extending, managing, and deploying customized content types in WordPress.

1.1k1.7k](/packages/pods-framework-pods)[mindkomm/timmy

Advanced image manipulation for Timber.

17735.6k](/packages/mindkomm-timmy)[wp-pay-extensions/gravityforms

Gravity Forms driver for the WordPress payment processing library.

1133.3k2](/packages/wp-pay-extensions-gravityforms)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)