FilterProxy version <: print $ENV{VERSION}; :>

<: print $ENV{MESSAGE}; :>
FilterProxy Global options
{filtering}?"checked":"unchecked"; :>> Filtering Enabled
{debug}?"checked":"unchecked"; :>> Print debug info to file:
Wait this many seconds before giving up on an outgoing connection
Global configuration for modules:
<: my($module); foreach $module (@{$ENV{MODULES}}) { print "
", $module, "
\n"; } :>

<: my($site, $escsite); foreach $site (sort keys %{$ENV{MODULECONFIG}->{filters}}) { # escape the meta-characters in the site. $escsite = $site; $escsite =~ s/([^a-zA-Z0-9_.-])/uc sprintf("%%%02x",ord($1))/eg; print "\n"; print " \n"; print " \n"; print " \n"; print " \n"; print " \n"; print " \n"; print "\n"; } :>
URL regexp Filters Applied Action
$site"; foreach $module (sort keys %{$ENV{MODULECONFIG}->{filters}->{$site}}) { print "$module "; } print "\n"; print "

How does this work?

For every page you request with your browser, FilterProxy will compare its URL to the 'URL regexp' list above. If one (or more) match, it will apply the filters listed for that regexp. A regexp is a Regular Expression, and gory details can be found by running 'man perlre'. The basics are summarized below. These regexps are case-insensitive.

If more than one regexp matches your URL, each of the configurations is passed to the respective modules.

Regular Expression Overview

regexp stringWill match
.*all sites
.any single character
*causes the expression that preceeds it to be matched 0 or more times
+causes the expression that preceeds to be matched 1 or more times
?causes the expression that preceeds it to be matched 0 or 1 times
[a-z]any of the characters in the brackets will match
[^a-z]any character but those brackets will match
()Use to group expressions
http://www.somewhere.comhttp://wwwAsomewhereAcom, http://www.somewhere.com
http://www\.somewhere\.comhttp://www.somewhere.com
http://(www\.)?somewhere\.comhttp://www.somewhere.com, http://somewhere.com
http://([a-z]*)?\.somewhere\.comhttp://juniper.somewhere.com, http://www.somewhere.com, BUT NOT http://somewhere.com (note leading \.)

Hopefully you get the idea. If you need more info, consult perl's "perlre" manual page.