External Filter

Allows you to filter content using external programs or scripts.

Parameters

Command

Format:

command = command_line

The program specified in command_line must behave like a Unix filter, that is read data from its standard input and write to its standard output.

Note: awk95 is recommended for simple scripting on Windows. It may be downloaded from Brian Kernighan's page: http://cm.bell-labs.com/cm/cs/who/bwk/awk95.exe. Lightweight and powerful enough for simple tasks (compare its executable size (160K) to anything else). For convenience, a copy is included with this software.

See also Common Filter Parameters.

Notes

• Currently only text content is passed through external filters (Content-type is text/*).
• Content is fed to external filters first, before parsing (for text/html).
• If more than one external filter matches current URL, they are executed in a pipe, e.g.: filter1 | filter2 | filter3 ..., so if your script is used in more than one filter instance, it must be prepared to many instances being executed simultaneously.

See also Common Filter Parameters.

Example

type = External Filter
name = Just an example
enabled = true
time = 
user = 
include = *
command = awk -f myscript.awk

{
  gsub(/foo/, "bar")
  print $0
}