templates/show-status

   1 ##########################################################
   2 #
   3 # Show-Status-CGI Output template for Privoxy.
   4 #
   5 # USING HTML TEMPLATES:
   6 # ---------------------
   7 #
   8 # Template files are written win plain HTML, with a few
   9 # additions:
  10 #
  11 # - Lines that start with a '#' character like this one
  12 #   are ignored
  13 #
  14 # - Each item in the below list of exported symbols will
  15 #   be replaced by dynamically generated text, if they
  16 #   are enclosed in '@'-characters. E.g. The string @version@
  17 #   will be replaced by the version number of Privoxy.
  18 #
  19 # - One special application of this is to make whole blocks
  20 #   of the HTML template disappear if the condition <name>
  21 #   is not given. Simply enclose the block between the two
  22 #   strings @if-<name>start and if-<name>-end@. The strings
  23 #   should be placed in HTML comments (<!-- -->), so the
  24 #   html structure won't be messed when the magic happens.
  25 #
  26 # USABLE SYMBOLS IN THIS TEMPLATE:
  27 # --------------------------------
  28 #
  29 #  my-ip-addr:
  30 #    The IP-address that the client used to reach this proxy
  31 #  my-hostname:
  32 #    The hostname associated with my-ip-addr
  33 #  admin-address:
  34 #    The email address of the pxoxy's administrator, as configured
  35 #    in the config file
  36 #  default-cgi:
  37 #    The URL for the "main menu" builtin CGI of this proxy
  38 #  menu:
  39 #    List of <li> elements linking to the other available CGIs
  40 #  version:
  41 #    The version number of the proxy software
  42 #  code-status:
  43 #    The development status of the proxy software: "alpha", "beta",
  44 #    or "stable".
  45 #  homepage:
  46 #    The URL of the SourceForge ijbswa project, who maintains this
  47 #    software.
  48 #
  49 #  redirect-url:
  50 #    The URL to a script that will redirect to the Privoxy
  51 #    documentation for a given item
  52 #  invocation:
  53 #    The command line with whitch Privoxy was invoked
  54 #  options:
  55 #    The options read from the configfile, linked to their
  56 #    explanations, plus warnings if parsing acl or forward
  57 #    statements produced errors.
  58 #  sourceversions:
  59 #    A HTML-formatted list of the individual source file cvs versions
  60 #  defines:
  61 #    A HTML-formatted list of all conditional #defines used when
  62 #    Privoxy was compiled
  63 #
  64 #
  65 # CONDITIONAL SYMBOLS FOR THIS TEMPLATE AND THEIR DEPANDANT SYMBOLS:
  66 # ------------------------------------------------------------------
  67 #
  68 #  unstable:
  69 #    This is an alpha or beta release of the proxy software
  70 #  have-adminaddr-info:
  71 #    An e-mail address for the local Privoxy adminstrator has
  72 #    been specified and is available through the "admin-address"
  73 #    symbol
  74 #  have-proxy-info:
  75 #    A URL for online documentation about this proxy has been
  76 #    specified and is available through the "proxy-info-url"
  77 #    symbol
  78 #  have-help-info:
  79 #    If either have-proxy-info is true or have-adminaddr-info is
  80 #    true, have-help-info is true.  Used to conditionally include
  81 #    a grey box for any and all help info.
  82 #  statistics:
  83 #    Privoxy was compiled with statistics support
  84 #  have-stats:
  85 #    There have been previous requests and statistics have
  86 #    been collected. In this case, the following symbols
  87 #    are available:
  88 #    requests-received:
  89 #      The number of requests received so far
  90 #    requests-blocked:
  91 #      The number of request blocked so far
  92 #    percent-blocked:
  93 #      The percentage of blocked requests
  94 #  have-no-stats:
  95 #    There haven't any statistics been collected yet
  96 #  pcrs-support:
  97 #    Privoxy was compiled with pcrs support
  98 #  trust-support:
  99 #    Privoxy was compiled with trust support
 100 #  actions-filename:
 101 #    The path to the actions file.
 102 #  re-filter-filename:
 103 #    The path to the re_filter file. Only available if
 104 #    pcrs-support is set
 105 #  trust-filename:
 106 #    The path to the trust file.Only available if
 107 #    trust-support is set
 108 <html>
 109
 110 <head>
 111   <title>Privoxy@@my-hostname@: Proxy Status</title>
 112   <style type="text/css">
 113     BODY, P, H1, H2, UL, OL, LI { font-family: Helvetica, Helv, Arial, Sans-Serif, sans-serif }
 114   </style>
 115 </head>
 116
 117 <body bgcolor="#ffffff">
 118
 119   <table cellpadding=20 cellspacing=10 border=0 width=100%>
 120     <tr>
 121       <td bgcolor=#dddddd>
 122         <p><big><big><b>This is Privoxy (privacy enhancing proxy) @version@ on @my-hostname@ (@my-ip-address@), port @my-port@, @if-enabled-display-then@Enabled@else-not-enabled-display@Disabled@endif-enabled-display@</b></big></big></p>
 123       </td>
 124     </tr>
 125
 126     <tr>
 127       <td bgcolor=#eeeeee>
 128         <h2>The program was invoked as follows</h2>
 129         <blockquote><p>@invocation@</p></blockquote>
 130       </td>
 131     </tr>
 132
 133     <tr>
 134       <td bgcolor=#eeeeee>
 135         <h2>The following options were given in the config file:</h2>
 136         <blockquote><p>@options@</p></blockquote>
 137       </td>
 138     </tr>
 139
 140 <!-- @if-statistics-start -->
 141     <tr>
 142       <td bgcolor=#eeeeee>
 143         <h2>Blocking Statistics:</h2>
 144         <blockquote>
 145 <!-- @if-have-stats-start -->
 146         @requests-blocked@ out of @requests-received@ requests have been blocked,
 147         which equals a block rate of @percent-blocked@%.
 148 <!-- if-have-stats-end@ -->
 149 <!-- @if-have-no-stats-start -->
 150         There haven't been any requests so far.
 151 <!-- if-have-no-stats-end@ -->
 152       </td>
 153     </tr>
 154 <!-- if-statistics-end@ -->
 155
 156     <tr>
 157       <td bgcolor=#eeeeee>
 158         <h2>The following files are in use:</h2>
 159         <blockquote><p>Click a filename to browse</p></blockquote>
 160         <ul>
 161           <li>Actions List: <a href="show-status?file=permit">@actions-filename@</a></li>
 162 <!-- @if-pcrs-support-start -->
 163           <li>Regex Filter List: <a href="show-status?file=re">@re-filter-filename@</a></li>
 164 <!-- if-pcrs-support-end@ -->
 165 <!-- @if-trust-support-start -->
 166           <li>Trust List: <a href="show-status?file=trust">@trust-filename@</a></li>
 167 <!-- if-trust-support-end@ -->
 168         </ul>
 169       </td>
 170     </tr>
 171
 172     <tr>
 173       <td bgcolor=#eeeeee>
 174         <h2>Conditional #defines:</h2>
 175           <table border=1>
 176           <tr>
 177             <th>#define</th> <th>Enabled?</th> <th>Effects when enabled</th>
 178           </tr>
 179           <tr>
 180              <td><code>FEATURE_ACL</code></td>
 181              <td>@if-FEATURE_ACL-then@ Yes @else-not-FEATURE_ACL@ No @endif-FEATURE_ACL@</td>
 182              <td>Allows the use of an ACL to control access to the proxy by IP address.</td>
 183           </tr>
 184           <tr>
 185              <td><code>FEATURE_CGI_EDIT_ACTIONS</code></td>
 186              <td>@if-FEATURE_CGI_EDIT_ACTIONS-then@ Yes @else-not-FEATURE_CGI_EDIT_ACTIONS@ No @endif-FEATURE_CGI_EDIT_ACTIONS@</td>
 187              <td>Allows the use of the web-based actions file
 188                editor@if-FEATURE_CGI_EDIT_ACTIONS-then@, which is <a href="@default-cgi@edit-actions">here</a>@else-not-FEATURE_CGI_EDIT_ACTIONS@@endif-FEATURE_CGI_EDIT_ACTIONS@.</td>
 189           </tr>
 190           <tr>
 191              <td><code>FEATURE_COOKIE_JAR</code></td>
 192              <td>@if-FEATURE_COOKIE_JAR-then@ Yes @else-not-FEATURE_COOKIE_JAR@ No @endif-FEATURE_COOKIE_JAR@</td>
 193              <td>Allows the use of a "cookie jar" file to capture cookies.</td>
 194           </tr>
 195           <tr>
 196              <td><code>FEATURE_FAST_REDIRECTS</code></td>
 197              <td>@if-FEATURE_FAST_REDIRECTS-then@ Yes @else-not-FEATURE_FAST_REDIRECTS@ No @endif-FEATURE_FAST_REDIRECTS@</td>
 198              <td>Allows the +fast-redirects action, to bypass redirect and logging scripts.</td>
 199           </tr>
 200           <tr>
 201              <td><code>FEATURE_FORCE_LOAD</code></td>
 202              <td>@if-FEATURE_FORCE_LOAD-then@ Yes @else-not-FEATURE_FORCE_LOAD@ No @endif-FEATURE_FORCE_LOAD@</td>
 203              <td>Allows bypassing all filtering for a single page using the prefix "<code>@FORCE_PREFIX@</code>".</td>
 204           </tr>
 205           <tr>
 206              <td><code>FEATURE_IMAGE_BLOCKING</code></td>
 207              <td>@if-FEATURE_IMAGE_BLOCKING-then@ Yes @else-not-FEATURE_IMAGE_BLOCKING@ No @endif-FEATURE_IMAGE_BLOCKING@</td>
 208              <td>Allows the +image ation, to send "blocked" images instead of HTML.</td>
 209           </tr>
 210           <tr>
 211              <td><code>FEATURE_IMAGE_DETECT_MSIE</code></td>
 212              <td>@if-FEATURE_IMAGE_DETECT_MSIE-then@ Yes @else-not-FEATURE_IMAGE_DETECT_MSIE@ No @endif-FEATURE_IMAGE_DETECT_MSIE@</td>
 213              <td>Enables automatic detection of image and HTML requests from
 214              Microsoft Internet Explorer users, overriding the setting of
 215              +image in the actions file.</td>
 216           </tr>
 217           <tr>
 218              <td><code>FEATURE_KILL_POPUPS</code></td>
 219              <td>@if-FEATURE_KILL_POPUPS-then@ Yes @else-not-FEATURE_KILL_POPUPS@ No @endif-FEATURE_KILL_POPUPS@</td>
 220              <td>Allows the +no-popups action, to block JavaScript popups.</td>
 221           </tr>
 222           <tr>
 223              <td><code>FEATURE_NO_GIFS</code></td>
 224              <td>@if-FEATURE_NO_GIFS-then@ Yes @else-not-FEATURE_NO_GIFS@ No @endif-FEATURE_NO_GIFS@</td>
 225              <td>Use PNG instead of GIF for the built-in images.</td>
 226           </tr>
 227           <tr>
 228              <td><code>FEATURE_PTHREAD</code></td>
 229              <td>@if-FEATURE_PTHREAD-then@ Yes @else-not-FEATURE_PTHREAD@ No @endif-FEATURE_PTHREAD@</td>
 230              <td>Use POSIX threads rather than native threads</td>
 231           </tr>
 232           <tr>
 233              <td><code>FEATURE_STATISTICS</code></td>
 234              <td>@if-FEATURE_STATISTICS-then@ Yes @else-not-FEATURE_STATISTICS@ No @endif-FEATURE_STATISTICS@</td>
 235              <td>Enables the statistics function.</td>
 236           </tr>
 237           <tr>
 238              <td><code>FEATURE_TOGGLE</code></td>
 239              <td>@if-FEATURE_TOGGLE-then@ Yes @else-not-FEATURE_TOGGLE@ No @endif-FEATURE_TOGGLE@</td>
 240              <td>Allow Privoxy to be "disabled" so it is just a normal non-blocking non-anonymizing proxy.</td>
 241           </tr>
 242           <tr>
 243              <td><code>FEATURE_TRUST</code></td>
 244              <td>@if-FEATURE_TRUST-then@ Yes @else-not-FEATURE_TRUST@ No @endif-FEATURE_TRUST@</td>
 245              <td>Allows the use of trust files.</td>
 246           </tr>
 247           <tr>
 248              <td><code>REGEX_GNU</code></td>
 249              <td>@if-REGEX_GNU-then@ Yes @else-not-REGEX_GNU@ No @endif-REGEX_GNU@</td>
 250              <td rowspan="2">Changes the type of pattern matching done on URL paths.  PCRE is by far the best.
 251              The old GNU style will slow down Privoxy and increase the executable's size.  If both of
 252              these are disabled, simple prefix matching is done, but this is very inflexible.</td>
 253           </tr>
 254           <tr>
 255              <td><code>REGEX_PCRE</code></td>
 256              <td>@if-REGEX_PCRE-then@ Yes @else-not-REGEX_PCRE@ No @endif-REGEX_PCRE@</td>
 257           </tr>
 258           <tr>
 259              <td><code>STATIC_PCRE</code></td>
 260              <td>@if-STATIC_PCRE-then@ Yes @else-not-STATIC_PCRE@ No @endif-STATIC_PCRE@</td>
 261              <td>Use the supplied statically-linked PCRE library.  This is set automatically
 262              by <code>./configure</code> if you do not have the libpcre installed.</td>
 263           </tr>
 264           <tr>
 265              <td><code>STATIC_PCRS</code></td>
 266              <td>@if-STATIC_PCRS-then@ Yes @else-not-STATIC_PCRS@ No @endif-STATIC_PCRS@</td>
 267              <td>Use the supplied statically-linked PCRS library.  This is set automatically
 268              by <code>./configure</code> if you do not have the libpcrs installed.</td>
 269           </tr>
 270         </table>
 271       </td>
 272     </tr>
 273
 274     <tr>
 275       <td bgcolor=#dddddd>
 276         <h2>More Privoxy:</h2>
 277         <ul>@menu@</ul>
 278       </td>
 279     </tr>
 280
 281 <!-- @if-unstable-start -->
 282 # This will only appear if CODE_STATUS is "alpha" or "beta". See configure.in
 283     <tr>
 284       <td bgcolor=#ffdddd>
 285         <p><b>Please note that this <font color=red>@code-status@</font> release
 286           of the proxy software is not intended for production systems!
 287           <br>Use at your own risk. See the <a href="http://www.gnu.org/copyleft/gpl.html">license</a> for details.</b>
 288         </p>
 289         <p>
 290 <h2>Support and Service via Sourceforge</h2>
 291 <p>
 292 We value your feedback. However, to provide you with the best support,
 293 please note:
 294 <ul>
 295   <li>Use the <a href="http://sourceforge.net/tracker/?group_id=11118&atid=211118">support forum</a> to get
 296   help.</li>
 297   <li>Submit bugs only thru our <a href="http://sourceforge.net/tracker/?group_id=11118&atid=111118">bug
 298       forum</a>. Make sure that the bug has not yet been submitted.</li>
 299   <li>Submit feature requests only thru our <a
 300       href="http://sourceforge.net/tracker/?atid=361118&group_id=11118&func=browse">feature request forum</a>.</li>
 301 </ul>
 302 </p>
 303 <p>
 304 For any other issues, feel free to use the <a
 305 href="http://sourceforge.net/mail/?group_id=11118">mailing lists</a>.
 306 </p>
 307       </td>
 308     </tr>
 309 <!-- if-unstable-end@ -->
 310
 311 <!-- @if-have-help-info-start -->
 312     <tr>
 313       <td bgcolor=#dddddd>
 314         <h2>Local Privoxy support:</h2>
 315
 316 <!-- @if-have-proxy-info-start -->
 317         <p>You can consult the <a href="@proxy-info-url@">online documentation</a> for more information about this Privoxy installation.
 318 <!-- if-have-proxy-info-end@ -->
 319
 320 <!-- @if-have-adminaddr-info-start -->
 321         <p>Address e-mail questions about this service to
 322           <a href=mailto:@admin-address@><code>@admin-address@</code></a>,
 323           who will be glad to help you.
 324 <!-- if-have-adminaddr-info-end@ -->
 325
 326         </p>
 327       </td>
 328     </tr>
 329 <!-- if-have-help-info-end@ -->
 330
 331   </table>
 332
 333 </body>
 334 </html>