><H3
CLASS="SECT2"
><A
-NAME="AEN239"
+NAME="AEN237"
>3.2. What is an <SPAN
CLASS="QUOTE"
>"actions"</SPAN
>Privoxy</SPAN
> might take, are configured.
Typically, you would define a set of default actions that apply
- to all URLs, then add exceptions to these defaults.</P
+ to all URLs, then add exceptions to these defaults where needed.</P
><P
> Actions can be defined on a per site basis, or for groups of sites. Actions
can also be grouped together and then applied to one or more sites. There
CLASS="QUOTE"
>"actions"</SPAN
> file. </P
-><P
-> <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> comes with several default
- <SPAN
-CLASS="APPLICATION"
->actions</SPAN
-> files, with varying degrees
- of filtering and blocking, as starting points for your own
- configuration (see below).</P
></DIV
><DIV
CLASS="SECT2"
><P
> These are all explained in the
<A
-HREF="../user-manual/configuration.html#ACTIONSFILE"
+HREF="../user-manual/actions-file.html"
TARGET="_top"
>user-manual</A
>.
><H3
CLASS="SECT2"
><A
-NAME="AEN257"
+NAME="AEN252"
>3.4. How are actions files configured? What is the easiest
way to do this?</A
></H3
"<A
HREF="http://config.privoxy.org"
TARGET="_top"
->Edit the actions list</A
+>View & change the current configuration</A
>"
from the selection list. You can also do this by editing the appropriate
file with a text editor.</P
><P
> Please see the
<A
-HREF="../user-manual/configuration.html#ACTIONSFILE"
+HREF="../user-manual/actions-file.html"
TARGET="_top"
>user-manual</A
> for a
><H3
CLASS="SECT2"
><A
-NAME="CONFIGFILES"
->3.5. What are the differences between
-intermediate.action, basic.action, etc.?</A
+NAME="AEN260"
+>3.5. There are several different <SPAN
+CLASS="QUOTE"
+>"actions"</SPAN
+> files. What are
+the differences?</A
></H3
><P
->Configuring <SPAN
+> As of <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> is not easy. To help you get
-started, we provide you with three different default configurations. The
-following table shows you, which features are enabled in each configuration.
- </P
-><P
-><DIV
-CLASS="TABLE"
-><A
-NAME="AEN270"
-></A
+> v2.9.15, three actions files
+ are being included, to be used for
+ different purposes. These are
+ <TT
+CLASS="FILENAME"
+>default.action</TT
+>, <TT
+CLASS="FILENAME"
+>standard.action</TT
+>,
+ and <TT
+CLASS="FILENAME"
+>user.action</TT
+>. Please see
+ <A
+HREF="../user-manual/actions-file.html"
+TARGET="_top"
+>the User Manual</A
+>
+ for an explanation of each.</P
><P
-><B
->Table 1. Default Configurations</B
-></P
-><TABLE
-BORDER="1"
-CLASS="CALSTABLE"
-><THEAD
-><TR
-><TH
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->Feature</TH
-><TH
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->default.action</TH
-><TH
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->basic.action</TH
-><TH
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->intermediate.action</TH
-><TH
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->advanced.action</TH
-></TR
-></THEAD
-><TBODY
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->ad-filtering</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->blank image</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->de-animate GIFs</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->referer forging</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->jon's +no-cookies-keep (i.e. session cookies only)</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->no-popup windows</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->fast redirects</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->hide-referrer</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->hide-useragent</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->content-modification</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->x</TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->feature-x</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->feature-y</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-></TR
-><TR
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->feature-z</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
->?</TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-><TD
-WIDTH="20%"
-ALIGN="LEFT"
-VALIGN="TOP"
-> </TD
-></TR
-></TBODY
-></TABLE
-></DIV
-></P
+> Earlier versions included three different versions
+ <TT
+CLASS="FILENAME"
+>default.action</TT
+> files. The new scheme allows for
+ greater flexibility of local configuration, and for browser based
+ configuration.</P
></DIV
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="AEN379"
+NAME="AEN286"
>3.7. What is <SPAN
CLASS="QUOTE"
>"default.filter"</SPAN
> The <SPAN
CLASS="QUOTE"
>"default.filter"</SPAN
-> file is used to <SPAN
+> file is where <SPAN
+CLASS="QUOTE"
+>"filters"</SPAN
+>
+ are defined, which are used to <SPAN
CLASS="QUOTE"
>"filter"</SPAN
> any
but you can disable/enable various sections of the included default
file with the <SPAN
CLASS="QUOTE"
->"Actions List Editor"</SPAN
-> from your browser.</P
+>"View & change the current configuration"</SPAN
+> from
+ your browser. </P
></DIV
><DIV
CLASS="SECT2"
><H3
CLASS="SECT2"
><A
-NAME="AEN391"
+NAME="AEN299"
>3.8. How can I set up <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
><TD
><PRE
CLASS="SCREEN"
-> listen-address 192.168.1.1:8118
- </PRE
+> listen-address 192.168.1.1:8118</PRE
></TD
></TR
></TABLE
><H3
CLASS="SECT2"
><A
-NAME="AEN403"
+NAME="AEN311"
>3.9. Instead of ads, now I get a checkerboard pattern. I don't want to see anything.</A
></H3
><P
<SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> is stopping. You have the choice of a checkerboard
- pattern, a transparent 1x1 GIF image (aka <SPAN
+> is stopping. You have the choice of a
+ checkerboard pattern, a transparent 1x1 GIF image (aka <SPAN
CLASS="QUOTE"
>"blank"</SPAN
->), or a custom
- URL of your choice. Note that to fit this category, the URL must match both
- the <SPAN
+>),
+ or a custom URL of your choice. Note that to fit this category, the URL must
+ match both the <A
+HREF="../user-manual/actions-file.html#HANDLE-AS-IMAGE"
+TARGET="_top"
+><SPAN
CLASS="QUOTE"
->"+image"</SPAN
-> and <SPAN
+>"+handle-as-image"</SPAN
+></A
+>
+ <I
+CLASS="EMPHASIS"
+>and</I
+>
+ <A
+HREF="../user-manual/actions-file.html#BLOCK"
+TARGET="_top"
+><SPAN
CLASS="QUOTE"
>"+block"</SPAN
+></A
> actions.</P
><P
-> If you want to see nothing, then change the <SPAN
+> If you want to see nothing, then change the
+ <A
+HREF="../user-manual/actions-file.html#SET-IMAGE-BLOCKER"
+TARGET="_top"
+><SPAN
CLASS="QUOTE"
->"+image-blocker"</SPAN
->
+>"+set-image-blocker"</SPAN
+></A
+>
action to <SPAN
CLASS="QUOTE"
>"+image-blocker{blank}"</SPAN
>. This can be done from the
<SPAN
CLASS="QUOTE"
->"Edit Actions List"</SPAN
+>"View & change the current configuration"</SPAN
> selection at <A
HREF="http://p.p/"
TARGET="_top"
>
banner, can be moved to the <SPAN
CLASS="QUOTE"
->"+image-blocker"</SPAN
+>"+set-image-blocker"</SPAN
> section for the
same reason, but there are some limits and risks to this (see below).</P
></DIV
><H3
CLASS="SECT2"
><A
-NAME="AEN418"
+NAME="AEN330"
>3.10. Why would anybody want to see a checkerboard pattern?</A
></H3
><P
><H3
CLASS="SECT2"
><A
-NAME="AEN423"
+NAME="AEN335"
>3.11. I see large red banners on some pages that say
<SPAN
CLASS="QUOTE"
<SPAN
CLASS="APPLICATION"
>Privoxy's</SPAN
-> block actions (+block). It is meant
- to be a warning so that you know something has been blocked and an easy way
- for you to see why. These are handled differently than what has been defined
- explicitly as <SPAN
+> block actions
+ (<A
+HREF="../user-manual/actions-file.html#BLOCK"
+TARGET="_top"
+><SPAN
+CLASS="QUOTE"
+>"+block"</SPAN
+></A
+>).
+ It is meant to be a warning so that you know something has been blocked and
+ an easy way for you to see why. These are handled differently than what has
+ been defined explicitly as <SPAN
CLASS="QUOTE"
>"images"</SPAN
-> (e.g. ad banners). Depending on the
- URL itself, it is sometimes hard for <SPAN
+> (e.g. ads that are GIF image
+ files). Depending on the URL itself, it is sometimes hard for
+ <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> to
- really know whether there is indeed an ad image there or not. And there are
- limitations as to what <SPAN
+> to really know whether there is indeed an
+ ad image there or not. And there are limitations as to what
+ <SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> can do to
- <SPAN
+> can do to <SPAN
CLASS="QUOTE"
>"fool"</SPAN
-> the browser.</P
+> the
+ browser.</P
><P
> For instance, if the ad is in a frame, then it is embedded in the separate
HTML page used for the frame. In this case, you cannot just substitute an
- aribitray image (like we would for a <SPAN
+ aribitrary image (like we would for a <SPAN
CLASS="QUOTE"
>"blank"</SPAN
> image), for an HTML
page. The browser is expecting an HTML page, and that is what it must have
- for frames. So this situation can be a little trickier to deal with, and
+ for frames. Such situations can be a little trickier to deal with, and
<SPAN
CLASS="APPLICATION"
>Privoxy</SPAN
-> will use the <SPAN
+> may show the <SPAN
CLASS="QUOTE"
>"Blocked"</SPAN
-> page.</P
+> page,
+ despite your best efforts.</P
><P
> If you want these to be treated as if they were images, so that they can be
made invisible, you can try moving the offending URL from the
> is blocking the frame, and
diable this. Then let the <SPAN
CLASS="QUOTE"
->"+image-blocker"</SPAN
+>"+set-image-blocker"</SPAN
> action
handle the ad that is embedded in the frame's HTML page. </P
></DIV
>3.12. I cannot see all of the <SPAN
CLASS="QUOTE"
>"Blocked"</SPAN
-> page banner. All I
-see is a bright red square.</A
+> page banner. Help.</A
></H3
><P
-> There is not enough space to fit the entire page. Try right clicking on the
- visible, red portion, and select <SPAN
+> There is not enough available space to fit the entire Blocked page. Try right
+ clicking on the visible portion, and select <SPAN
CLASS="QUOTE"
>"Show Frame"</SPAN
->, or equivalent.
- This will usually allow you to see the entire Privoxy <SPAN
+>,
+ or equivalent. This will usually allow you to see the entire Privoxy
+ <SPAN
CLASS="QUOTE"
>"Blocked"</SPAN
->
- page, and from there you can see just what is being blocked, and why.</P
+> page, and from there you can see just what is being
+ blocked, and why.</P
+><P
+> As of Privoxy 2.9.14, the Blocked banner page is re-sizeable, and tries
+ to adjust to the allotted space. There may be occassions where there
+ just isn't enough room to display much of anything useful though. </P
></DIV
><DIV
CLASS="SECT2"
></H3
><P
> This can be done. See the <A
-HREF="../user-manual/configuration.html#FORWARDING"
+HREF="../user-manual/config.html#FORWARDING"
TARGET="_top"
>user manual</A
>,