Rebuild with latest changes.
[privoxy.git] / user.action
1 ######################################################################
2
3 #  File        :  $Source: /cvsroot/ijbswa/current/user.action,v $
4
5 #  $Id: user.action,v 1.8 2008/03/01 15:13:03 fabiankeil Exp $
6 #
7 #  Purpose     :  User-maintained actions file, see
8 #                 http://www.privoxy.org/user-manual/actions-file.html
9 #
10 ######################################################################
11
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.
16
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.
20
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.
24
25 #############################################################################
26 # Aliases
27 #############################################################################
28 {{alias}}
29 #############################################################################
30 #
31 # You can define a short form for a list of permissions - e.g., instead
32 # of "-crunch-incoming-cookies -crunch-outgoing-cookies -filter -fast-redirects",
33 # you can just write "shop". This is called an alias.
34 #
35 # Currently, an alias can contain any character except space, tab, '=', '{'
36 # or '}'.
37 # But please use only 'a'-'z', '0'-'9', '+', and '-'.
38 #
39 # Alias names are not case sensitive.
40 #
41 # Aliases beginning with '+' or '-' may be used for system action names 
42 # in future releases - so try to avoid alias names like this.  (e.g. 
43 # "+crunch-all-cookies" below is not a good name)
44 #
45 # Aliases must be defined before they are used.
46
47 # These aliases just save typing later:
48 #
49 +crunch-all-cookies = +crunch-incoming-cookies +crunch-outgoing-cookies
50 -crunch-all-cookies = -crunch-incoming-cookies -crunch-outgoing-cookies
51  allow-all-cookies  = -crunch-all-cookies -session-cookies-only -filter{content-cookies}
52  allow-popups       = -filter{all-popups} -filter{unsolicited-popups}
53 +block-as-image     = +block{Blocked image request.} +handle-as-image
54 -block-as-image     = -block
55
56 # These aliases define combinations of actions
57 # that are useful for certain types of sites:
58 #
59 fragile     = -block -crunch-all-cookies -filter -fast-redirects -hide-referer -prevent-compression
60 shop        = -crunch-all-cookies allow-popups
61
62 # Your favourite blend of filters:
63 #
64 myfilters   = +filter{html-annoyances} +filter{js-annoyances} +filter{all-popups}\
65               +filter{webbugs} +filter{banners-by-size}
66
67 # Allow ads for selected useful free sites:
68 #
69 allow-ads   = -block -filter{banners-by-size} -filter{banners-by-link}
70 #... etc.  Customize to your heart's content.
71
72 ## end aliases ########################################################
73 #######################################################################
74
75 # Begin examples: #####################################################
76
77 # Say you have accounts on some sites that you visit regularly, and you
78 # don't want to have to log in manually each time. So you'd like to allow
79 # persistent cookies for these sites. The allow-all-cookies alias defined
80 # above does exactly that, i.e. it disables crunching of cookies in any
81 # direction, and the processing of cookies to make them only temporary.
82 #
83 { allow-all-cookies }
84 #.sourceforge.net
85 #sunsolve.sun.com
86 #slashdot.org
87 #.yahoo.com
88 #.msdn.microsoft.com
89 #.redhat.com
90
91 # Say the site where you do your homebanking needs to open popup
92 # windows, but you have chosen to kill popups uncoditionally by default.
93 # This will allow it for your-example-bank.com:
94 #
95 { -filter{all-popups} }
96 .banking.example.com
97
98 # Some hosts and some file types you may not want to filter for
99 # various reasons:
100 #
101 { -filter }
102
103 # Technical documentation is likely to contain strings that might
104 # erroneously get altered by the JavaScript-oriented filters:
105 #
106 #.tldp.org
107 #/(.*/)?selfhtml/
108
109 # And this stupid host sends streaming video with a wrong MIME type,
110 # so that Privoxy thinks it is getting HTML and starts filtering:
111 #
112 stupid-server.example.com/
113
114
115 # Example of a simple "block" action. Say you've seen an ad on your
116 # favourite page on example.com that you want to get rid of. You have
117 # right-clicked the image, selected "copy image location" and pasted
118 # the URL below while removing the leading http://, into a { +block{reason} }
119 # section. Note that { +handle-as-image } need not be specified, since
120 # all URLs ending in .gif will be tagged as images by the general rules
121 # as set in default.action anyway:
122 #
123 { +block{Nasty ads.} }
124 www.example.com/nasty-ads/sponsor.gif
125
126 # The URLs of dynamically generated banners, especially from large banner
127 # farms, often don't use the well-known image file name extensions, which
128 # makes it impossible for Privoxy to guess the file type just by looking
129 # at the URL. 
130 # You can use the +block-as-image alias defined above for these cases.
131 # Note that objects which match this rule but then turn out NOT to be an
132 # image are typically rendered as a "broken image" icon by the browser.
133 # Use cautiously.
134 #
135 { +block-as-image }
136 #.doubleclick.net
137 #/Realmedia/ads/
138 #ar.atwola.com/
139
140 # Now you noticed that the default configuration breaks Forbes
141 # Magazine, but you were too lazy to find out which action is the
142 # culprit, and you were again too lazy to give feedback, so you just
143 # used the fragile alias on the site, and -- whoa! -- it worked. The
144 # 'fragile' aliases disables those actions that are most likely to break
145 # a site. Also, good for testing purposes to see if it is Privoxy that
146 # is causing the problem or not.
147
148 { fragile }
149 #.forbes.com
150
151 # Here are some sites we wish to support, and we will allow their ads
152 # through.
153 #
154 { allow-ads }
155 #.sourceforge.net
156 #.slashdot.org
157 #.osdn.net
158
159 # user.action is generally the best place to define exceptions and
160 # additions to the default policies of default.action. Some actions are
161 # safe to have their default policies set here though. So let's set a
162 # default policy to have a 'blank' image as opposed to the checkerboard
163 # pattern for ALL sites. '/' of course matches all URLs.
164 # patterns:
165 #
166 { +set-image-blocker{blank} }
167 #/
168
169 ## set vi:nowrap tw=72