1 ######################################################################
3 # File : $Source: /cvsroot/ijbswa/current/user.action,v $
5 # $Id: user.action,v 1.5 2006/08/29 00:39:54 david__schmidt Exp $
7 # Purpose : User-maintained actions file, see
8 # http://www.privoxy.org/user-manual/actions-file.html
10 ######################################################################
12 # This is the place to add your personal exceptions and additions to
13 # the general policies as defined in default.action. (Here they will be
14 # safe from updates to default.action.) Later defined actions always
15 # take precedence, so anything defined here should have the last word.
17 # See http://www.privoxy.org/user-manual/actions-file.html, or the
18 # comments in default.action, for an explanation of what an "action" is
19 # and what each action does.
21 # The examples included here either use bogus sites, or have the actual
22 # rules commented out (with the '#' character). Useful aliases are
23 # included in the top section as a convenience.
25 #############################################################################
27 #############################################################################
29 #############################################################################
31 # Aliases must be defined before they are used and are local to the
32 # actions file that they are defined in, you can't use the ones from
33 # default.action, unless you repeat them here:
36 # These aliases just save typing later, and the alias names should
37 # be self explanatory.
39 +crunch-all-cookies = +crunch-incoming-cookies +crunch-outgoing-cookies
40 -crunch-all-cookies = -crunch-incoming-cookies -crunch-outgoing-cookies
41 allow-all-cookies = -crunch-all-cookies -session-cookies-only -filter{content-cookies}
42 allow-popups = -filter{all-popups} -kill-popups
43 +block-as-image = +block +handle-as-image
44 -block-as-image = -block
46 # These aliases define combinations of actions that are useful for
47 # certain types of sites:
49 fragile = -block -crunch-all-cookies -filter -fast-redirects -hide-referer -kill-popups
50 shop = -crunch-all-cookies allow-popups
52 # Your favourite blend of filters:
54 myfilters = +filter{html-annoyances} +filter{js-annoyances} +filter{all-popups}\
55 +filter{webbugs} +filter{banners-by-size} +filter{fun}
57 # Allow ads for selected useful free sites:
59 allow-ads = -block -filter{banners-by-size} -filter{banners-by-link}
60 #... etc. Customize to your heart's content.
62 ## end aliases ########################################################
63 #######################################################################
65 # Begin examples: #####################################################
67 # Say you have accounts on some sites that you visit regularly, and you
68 # don't want to have to log in manually each time. So you'd like to allow
69 # persistent cookies for these sites. The allow-all-cookies alias defined
70 # above does exactly that, i.e. it disables crunching of cookies in any
71 # direction, and the processing of cookies to make them only temporary.
81 # Say the site where you do your homebanking needs to open popup
82 # windows, but you have chosen to kill popups uncoditionally by default.
83 # This will allow it for your-example-bank.com:
85 { -filter{all-popups} -kill-popups }
88 # Some hosts and some file types you may not want to filter for
93 # Technical documentation is likely to contain strings that might
94 # erroneously get altered by the JavaScript-oriented filters:
99 # And this stupid host sends streaming video with a wrong MIME type,
100 # so that Privoxy thinks it is getting HTML and starts filtering:
102 stupid-server.example.com/
105 # Example of a simple "block" action. Say you've seen an ad on your
106 # favourite page on example.com that you want to get rid of. You have
107 # right-clicked the image, selected "copy image location" and pasted
108 # the URL below while removing the leading http://, into a { +block }
109 # section. Note that { +handle-as-image } need not be specified, since
110 # all URLs ending in .gif will be tagged as images by the general rules
111 # as set in default.action anyway:
114 www.example.com/nasty-ads/sponsor.gif
116 # The URLs of dynamically generated banners, especially from large banner
117 # farms, often don't use the well-known image file name extensions, which
118 # makes it impossible for Privoxy to guess the file type just by looking
120 # You can use the +block-as-image alias defined above for these cases.
121 # Note that objects which match this rule but then turn out NOT to be an
122 # image are typically rendered as a "broken image" icon by the browser.
130 # Now you noticed that the default configuration breaks Forbes
131 # Magazine, but you were too lazy to find out which action is the
132 # culprit, and you were again too lazy to give feedback, so you just
133 # used the fragile alias on the site, and -- whoa! -- it worked. The
134 # 'fragile' aliases disables those actions that are most likely to break
135 # a site. Also, good for testing purposes to see if it is Privoxy that
136 # is causing the problem or not.
141 # Here are some sites we wish to support, and we will allow their ads
149 # user.action is generally the best place to define exceptions and
150 # additions to the default policies of default.action. Some actions are
151 # safe to have their default policies set here though. So let's set a
152 # default policy to have a 'blank' image as opposed to the checkerboard
153 # pattern for ALL sites. '/' of course matches all URLs.
156 { +set-image-blocker{blank} }
159 ## set vi:nowrap tw=72