From 8d8af5fd92b14183285320b5fee42ddea74ff94b Mon Sep 17 00:00:00 2001 From: Brendan Taylor Date: Thu, 23 Dec 2010 21:12:16 -0700 Subject: add WHITELIST_COOKIE event to README.uzbl-event-manager --- docs/README.uzbl-event-manager | 26 +++++++++++++++++++------- 1 file changed, 19 insertions(+), 7 deletions(-) (limited to 'docs') diff --git a/docs/README.uzbl-event-manager b/docs/README.uzbl-event-manager index 58e9e9b..074811e 100644 --- a/docs/README.uzbl-event-manager +++ b/docs/README.uzbl-event-manager @@ -66,15 +66,22 @@ EXEC_BIND ### cookies.py ### - Cookie synchronization and persistence -- Connects To: ADD_COOKIE, DELETE_COOKIE, (BLACKLIST_COOKIE) +- Connects To: ADD_COOKIE, DELETE_COOKIE, (BLACKLIST_COOKIE, WHITELIST_COOKIE) This plugin acts on the (ADD|DELETE)_COOKIE events by issuing add_cookie or -delete_cookie commands as appropriate to other connected instances. However if -the cookie is matched by any of the filters configured by BLACKLIST_COOKIE the -cookie will not be forwarded and instead delete_cookie will be sent to the -source. -It will also maintain a mozilla cookies.txt compatible file with all your -cookies in $XDG_DATA_HOME/uzbl/cookies.txt +delete_cookie commands as appropriate to other connected uzbl instances. +However if the cookie is blacklisted (see below) the cookie will not be +forwarded and instead delete_cookie will be sent to the source so that the +cookie will not be included in future HTTP requests. + +This plugin also maintains a mozilla cookies.txt compatible file with all your +persistent cookies in $XDG_DATA_HOME/uzbl/cookies.txt and all your session +cookies in $XDG_DATA_HOME/uzbl/session-cookies.txt. + +The blacklist is configured using the BLACKLIST_COOKIE and WHITELIST_COOKIE +events. If any whitelist is set, then any cookie that is not whitelisted will +be rejected. Otherwise, only cookies that have been blacklisted will be +rejected. BLACKLIST_COOKIE Adds a new blacklist filter. cookies where the component specified by @@ -85,3 +92,8 @@ BLACKLIST_COOKIE for example to block all cookies which name is "__utm" followed by a single character (google analytics cookies) do. request BLACKLIST_COOKIE name '^__utm.$' + +WHITELIST_COOKIE + Adds a new whitelist filter. cookies where the component specified by + `part` matches the regular expression `re` will be allowed. part can be any + of the parts allowed for the BLACKLIST_COOKIE event -- cgit v1.2.3