############################################################################## # # File : $Source: /cvsroot/ijbswa/current/templates/edit-actions-for-url,v $ # # Purpose : Template used to edit the actions associated with a # particular section in an actions file. # # # Copyright : Written by and Copyright (C) 2001-2008 the SourceForge # Privoxy team. http://www.privoxy.org/ # # Original Author: Copyright (C) 2001 Jonathan Foster # http://www.jon-foster.co.uk/ # # This program is free software; you can redistribute it # and/or modify it under the terms of the GNU General # Public License as published by the Free Software # Foundation; either version 2 of the License, or (at # your option) any later version. # # This program is distributed in the hope that it will # be useful, but WITHOUT ANY WARRANTY; without even the # implied warranty of MERCHANTABILITY or FITNESS FOR A # PARTICULAR PURPOSE. See the GNU General Public # License for more details. # # The GNU General Public License should be included with # this file. If not, you can view it at # http://www.gnu.org/copyleft/gpl.html # or write to the Free Software Foundation, Inc., 59 # Temple Place - Suite 330, Boston, MA 02111-1307, USA. # # Revisions : # $Log: edit-actions-for-url,v $ # Revision 1.55 2008/09/19 15:26:29 fabiankeil # Add change-x-forwarded-for{} action to block or add # X-Forwarded-For headers. Mostly based on code removed # before 3.0.7. # # Revision 1.54 2008/03/29 12:14:27 fabiankeil # Remove send-wafer and send-vanilla-wafer actions. # # Revision 1.53 2008/03/28 15:13:45 fabiankeil # Remove inspect-jpegs action. # # Revision 1.52 2008/03/15 14:52:36 fabiankeil # Add CGI editor support for the "disable all filters of this type" # directives "-client-header-filter", "-server-header-filter", # "-client-header-tagger" and "-server-header-tagger". # # Revision 1.51 2008/03/07 16:46:49 fabiankeil # Reword limit-connect{} entry. # # Revision 1.50 2008/03/04 18:30:44 fabiankeil # Remove the treat-forbidden-connects-like-blocks action. We now # use the "blocked" page for forbidden CONNECT requests by default. # # Revision 1.49 2008/03/01 14:00:47 fabiankeil # Let the block action take the reason for the block # as argument and show it on the "blocked" page. # # Revision 1.48 2007/12/11 21:18:55 fabiankeil # Make forward-override accessible through the CGI editor. # # Revision 1.47 2007/12/06 18:21:55 fabiankeil # Update hide-forwarded-for-headers description. # # Revision 1.46 2007/11/10 15:06:10 fabiankeil # - Add support for +hide-referrer{conditional-forge}. # - Minor rewordings. # # Revision 1.45 2007/05/24 13:38:45 fabiankeil # Two minor fixes. # # Revision 1.44 2007/04/15 16:39:21 fabiankeil # Introduce tags as alternative way to specify which # actions apply to a request. At the moment tags can be # created based on client and server headers. # # Revision 1.43 2007/03/29 11:40:34 fabiankeil # Divide @filter-params@ into @client-header-filter-params@ # @content-filter-params@ and @server-header-filter-params@. # # Revision 1.42 2007/03/20 15:40:00 fabiankeil # Adjust to new world order with dedicated header-filter actions. # # Revision 1.41 2007/01/23 16:03:16 fabiankeil # - Add favicon links. # - Remove useless W3C validator links. # # Revision 1.40 2006/12/21 13:01:03 fabiankeil # Prepare for "split-large-forms". # # Mention that redirect{} now also understands # a single pcrs job as argument. # # Add some table summaries and remove useless validator link. # # Revision 1.39 2006/10/04 17:37:54 fabiankeil # JavaScript fix for bug report #1570678. # # Revision 1.38 2006/09/08 12:06:35 fabiankeil # Have hide-if-modified-since interpret the random # range value as minutes instead of hours. Allows # more fine-grained configuration. # # Revision 1.37 2006/09/05 18:20:14 fabiankeil # Sorted alphabetically, fixed spelling mistakes # and shortened some descriptions. # # Revision 1.36 2006/08/14 08:29:17 fabiankeil # Split filter-headers{} into filter-client-headers{} # and filter-server-headers{}. # # Revision 1.35 2006/08/03 02:46:42 david__schmidt # Incorporate Fabian Keil's patch work: http://www.fabiankeil.de/sourcecode/privoxy/ # # Revision 1.34 2006/07/18 14:49:13 david__schmidt # Reorganizing the repository: swapping out what was HEAD (the old 3.1 branch) # with what was really the latest development (the v_3_0_branch branch) # # Revision 1.29.2.5 2004/10/05 03:17:26 david__schmidt # Typo: inspect_jpegs, not inspect-jpegs in form # # Revision 1.29.2.4 2004/10/03 12:53:46 david__schmidt # Add the ability to check jpeg images for invalid # lengths of comment blocks. Defensive strategy # against the exploit: # Microsoft Security Bulletin MS04-028 # Buffer Overrun in JPEG Processing (GDI+) Could # Allow Code Execution (833987) # Enabled with +inspect-jpegs in actions files. # # Revision 1.29.2.3 2002/08/23 02:22:53 hal9 # Fix a perl brain fart with
  • in comments. # # Revision 1.29.2.1 2002/08/02 12:51:42 oes # Added top submit button; Consistency with docs: Change default name for action from hide-referer to hide-referrer # # Revision 1.29 2002/05/21 19:10:57 oes # Fixed JavaScript error # # Revision 1.28 2002/05/14 21:36:38 oes # - Renamed prevent-(setting/reading)-cookies to # crunch-(incoming/outgoing)-cookies # - Renamed helplink export to actions-help-prefix # - Restored alphabetical order of actions # # Revision 1.27 2002/04/26 22:55:26 jongfoster # Removing the alternating colors because they've been wrong # since the actions renames, they're high maintenance, they # don't look particularly good, and now there are gaps between # the table cells we don't need them. # # Revision 1.26 2002/04/26 21:55:17 jongfoster # Cosmetic change: Making the +filter UI look the same as # the other actions. # # Revision 1.25 2002/04/26 21:37:50 jongfoster # Fixing all(?) the substitutions that were broken in the # recent actions rename. # # Revision 1.24 2002/04/26 18:24:28 jongfoster # Fixing typos in help hyperlinks # # Revision 1.23 2002/04/26 12:57:02 oes # Actions renamed, alphabetically sorted, comments fixed, and names linked to help # # Revision 1.22 2002/04/10 13:32:53 oes # Made templates modular # # Revision 1.21 2002/04/08 17:05:18 oes # Inline a style exception # # Revision 1.20 2002/04/05 16:01:30 oes # Correct HTML, external Stylesheets, eye candy, some fixes # # Revision 1.19 2002/03/26 22:29:56 swa # we have a new homepage! # # Revision 1.18 2002/03/24 16:32:08 jongfoster # Removing logo option # # Revision 1.17 2002/03/24 15:23:33 jongfoster # Name changes # # Revision 1.16 2002/03/24 11:01:06 swa # name change # # Revision 1.15 2002/03/23 16:18:15 swa # renamed every reference to the old name with foobar. # fixed "application foobar application" tag, fixed # "the foobar" with "foobar". left junkbuster in cvs # comments and remarks to history untouched. should # make final rename easier. # # Revision 1.14 2002/03/16 15:22:19 jongfoster # Moving 'alpha' warning to the end of the page # # Revision 1.13 2002/03/16 14:28:38 jongfoster # First version of modular filters support # # Revision 1.12 2002/03/12 01:42:50 oes # Introduced modular filters # # Revision 1.11 2002/03/08 18:19:14 jongfoster # Adding +image-blocker{pattern} option to edit interface # # Revision 1.10 2002/03/03 10:29:12 swa # point users to the right feedback forms, # not necessarily the developer list. # # Revision 1.9 2002/01/23 00:26:45 jongfoster # Reducing length of URLs # Where encoded and unencoded versions of a string existed, removing # the unencoded one. # # Revision 1.8 2002/01/17 21:33:00 jongfoster # Replacing all references to the URL of the config interface # with @default-cgi@ # # Revision 1.7 2002/01/17 21:21:03 jongfoster # DOS->Unix line endings # # Revision 1.6 2001/11/22 21:58:41 jongfoster # Adding action +no-cookies-keep # # Revision 1.5 2001/11/13 21:12:17 jongfoster # Added support for the following actions: # +downgrade, +limit-connect, +no-compression # # Revision 1.4 2001/11/13 00:58:18 jongfoster # New version of actions file editor templates # # ############################################################################## # # Browser support for the JavaScript on this page: # MS Internet Explorer 5.5 - Tested, Yes # Netscape 6.0 - Tested, Yes # Netscape 4.75 - Tested, NO # Opera 5.12 - Tested, NO # MS Internet Explorer 4+ - Untested, Yes # MS IE 3.x, NS3.x - Untested, NO # Mozilla >=0.6 - Untested, Yes # # All browsers should work, you just might not get the pretty DHTML effects. # # The effects that only work under the browsers marked "Yes" above are: # - Text edit boxes that won't have any effect are disabled. # - Table rows containing additional settings are hidden if the feature in # question is disabled. # # There are major kludges to get around these problems with NS4, but they # screw up the HTML too much for other browsers. If anyone wants to try, # here's some descriptions of the kludges: # http://www.webreference.com/js/tips/991114.html # http://www.webreference.com/dhtml/column12/outDisplay.html # # If you're favorite browser isn't listed, please test and add it. # # ############################################################################# # # Standard support: # # This file currently produces valid HTML 4.01 Strict. # # If you change it, please save the generated page from your web browser # and then upload it to http://validator.w3.org/ for checking. # ############################################################################# # # Available variables include: # # action-name-y # action-name-n # action-name-x # # deanimate-gifs-param-first # deanimate-gifs-param-last # hide-from-param-block # hide-from-param-custom # hide-from-param # hide-referrer-param-forge # hide-referrer-param-block # hide-referrer-param-custom # hide-referrer-param # hide-user-agent-param # image-blocker-param-pattern # image-blocker-param-blank # image-blocker-param-custom # # ############################################################################# Privoxy@@my-hostname@: Edit actions
    # This will only appear if CODE_STATUS is "alpha" or "beta". See configure.in
    #include mod-title
    #include mod-unstable-warning

    Edit Actions

    Edit Actions (Section 1)

    @client-header-filter-params@ @client-header-tagger-params@
    Enable Disable No Change Action Description
    add-header Adds HTTP headers.
            Editing the settings for this option, or turning it on if it was off, is not yet supported using this web-based editor.
    block Block the request.
            Block reason to tell the user:
    change-x-forwarded-for Specifies whether to block or add X-Forwarded-For headers.
           

      client-header-filter * Filter the client headers. You can use the radio buttons on this line to disable all client-header filters applied by previous rules, and/or you can enable or disable the filters individually below.
      client-header-tagger * Create tags based on the client headers. You can use the radio buttons on this line to disable all client-header taggers applied by previous rules, and/or you can enable or disable the taggers individually below.
    content-type-overwrite Replace Content-Type header. By default it only applies to text documents, but if you know what you're doing you can enable force-text-mode to modify binary content types as well.
            New Content-Type:
    crunch-client-header Remove header(s) matching the supplied pattern.
            Header string to suppress:
    crunch-if-none-match Remove If-None-Match header. Useful for filter testing and to make sure the header can't be used to track your visits.
    crunch-incoming-cookies Prevent the website from setting HTTP cookies on your system.
    crunch-outgoing-cookies Prevent the website from reading HTTP cookies from your system.
    crunch-server-header Remove server header(s) matching the supplied pattern.
            Header string to suppress:
    deanimate-gifs Replace animated GIFs with their (first/last) frame.
            Use the   
    downgrade-http-version Change HTTP/1.1 requests to HTTP/1.0. Only change if you know what you're doing!
    fast-redirects Bypass some click-tracking URLs.
           

    Edit Actions (Section 2)

    @content-filter-params@
    Enable Disable No Change Action Description
      filter * Filter the website through regular expression filters. You can use the radio buttons on this line to disable all filters applied by previous rules, and/or you can enable or disable the filters individually below.

    Edit Actions (Section 3)

    Enable Disable No Change Action Description
    force-text-mode Enable filtering on documents whose Content-Type wasn't recognized as text. Do think twice, nothing is alright.
    forward-override Override forward directives in the configuration file. Note that the parameter syntax isn't checked until the action is used. Syntax errors will cause Privoxy to exit.
            Overriding forward directive:
    handle-as-empty-document Block with an empty document instead of an Image or HTML message. The empty document contains only a space and can safely be parsed as JavaScript or Style Sheet. Use content-type-overwrite to specify the Content-Type, default is text/html.
    handle-as-image Request is for an image (only useful in conjunction with the block and set-image-blocker actions).
    hide-accept-language Pretend to have different language settings. (Makes a fake User-Agent more believable, but you may end up with content in the language you pretended to understand.)
           


    hide-content-disposition Block or overwrite the content-disposition header. Useful to view a document inside the browser, even if you were supposed to save it first, or to change the suggested file name.
           


    hide-from-header Stop old web browsers from sending the user's e-mail address with every request.
           

    hide-if-modified-since Remove or randomize the If-Modified-Since header.
            Useful for filter testing.
    minute(s). To appreciate this option a small amount of paranoia is required, but at least in theory the If-Modified-Since header could be used to keep track of your visits.

    Edit Actions (Section 4)

    @server-header-filter-params@ @server-header-tagger-params@
    Enable Disable No Change Action Description
    hide-referrer Helps prevent tracking by not sending the URL of the previous web page. 
            (breaks images on some free web hosts).
    (fools checks for in-site links.)
    hide-user-agent Pretend to be using a different web browser.  (May cause problems with broken web sites).
            User Agent string to send:
    limit-connect Limit which ports are allowed in HTTP CONNECT requests. These requests are used to tunnel SSL and other protocols through HTTP proxies.
            Legal ports (comma separated, ranges allowed):
    overwrite-last-modified Remove or randomize the Last-Modified header.
           

    prevent-compression Disables compression. Compressed web pages are faster to download, but cannot be filtered with filter or kill-popups if your Privoxy version was build without zlib support.
    redirect Redirect to another address.
            Static address or a single pcrs command to redirect to a rewritten version of the original URL:
      server-header-filter * Filter the server headers. You can use the radio buttons on this line to disable all server-header filters applied by previous rules, and/or you can enable or disable the filters individually below.
      server-header-tagger * Create tags based on the server headers. You can use the radio buttons on this line to disable all server-header taggers applied by previous rules, and/or you can enable or disable the taggers individually below.
    session-cookies-only HTTP cookies set by the website are changed to temporary ("per-session") ones, which only last until you close your web browser. This will allow you to use sites that require cookies, but sites will not be able to track you across sessions. For this to be useful, you should disable crunch-outgoing-cookies and crunch-incoming-cookies.
    set-image-blocker Specifies how to block images.
           


    More Privoxy:
    #include mod-support-and-service
    #include mod-local-help