lw-cookie-consent-integration

LW Cookie 1.8: consent integration and operations

Use LW Cookie's public hooks, browser API, REST routes, CLI, and abilities. Do not patch the plugin or infer legal compliance from a technical setting. Consent requirements depend on the site's processing, jurisdiction, vendor behavior, and legal basis.

Binding requirements and storage

Read the plugin header rather than old README badges:

Contract	Version 1.8.3
WordPress	6.6 or newer
PHP	8.2 or newer
Main option	lw_cookie_options
Categories	necessary, functional, analytics, marketing
Site Manager namespace	lw-cookie/*
Public shortcode	[lw_cookie_declaration]

necessary is always required. The three optional categories default to denied until consent is saved.

Do not write lw_cookie_options directly. The admin REST settings controller and the 1.8.3 lw-cookie/set-options ability both use the sanitized partial-update path for field types, enums, colors, IDs, multilingual locks, and declared-cookie rows.

Read consent through the public filters

$categories = apply_filters( 'lw_cookie_consent_categories', [] );
$has_choice = apply_filters( 'lw_cookie_has_consent', false );
$analytics  = apply_filters( 'lw_cookie_is_category_allowed', false, 'analytics' );
$consent_id = apply_filters( 'lw_cookie_consent_id', null );

Pass both documented arguments to lw_cookie_is_category_allowed. Treat an unknown category as denied.

These filters read the visitor's consent cookie. Do not let a full-page cache share consent-dependent HTML between visitors. A cache-safe integration renders the blocked form for everyone and lets the browser restore content after consent.

Browser API and event

Use the global API after the plugin's frontend assets load:

window.LWCookie.openPreferences();
window.LWCookie.acceptCategory( 'marketing' );

const state = window.LWCookie.getConsent();
const analyticsAllowed = window.LWCookie.isAllowed( 'analytics' );

window.addEventListener( 'lwCookieConsent', ( event ) => {
	const categories = event.detail.categories;
	const action = event.detail.action;
} );