Inserts values from files, cookies, defines or variables. If used to
insert cookies or variables <insert> will quote before
inserting, to make it impossible to insert dangerous RXML tags.
Attributes
- cookie=cookie
-
Inserts the value of the cookie.
- cookies=full
-
Inserts the value of all cookies. With the optional argument full, the
insertion will be more verbose.
- encode=none
html
-
Determines what quoting method should be when inserting cookies or
variables. Default is html, which means that <, > and
& will be quoted, to make sure you can't insert RXML tags. If you
choose none nothing will be quoted. It will be possible to
insert dangerous RXML tags so you must be of what your variables
contain.
- define=name
-
Inserts this define, which must have been defined by the
<define> tag before it is used. The define can be done in
another file, if you have inserted the file.
- file=path
-
Inserts the file. This file will then be fetched just as if someone
had tried to fetch it through an HTTP request. This makes it possible to
include things like the result of Pike or CGI scripts.
If path does not begin with /, it is assumed to be a URL
relative to the directory containing the page with the
<insert> tag. Note that included files will be parsed if they
are named with an extension the main RXML parser handles. This might
cause unexpected behavior. For example, it will not be possible to
share any macros defined by the <define> tags.
If you want to have a file with often used macros you should name
it with an extension that won't be parsed. For example,
.txt.
- fromword=toword
-
Replaces fromword with toword in the macro or file, before insering
it. Note that only lower case character sequences can be replaced.
- nocache
-
Don't cache results when inserting files, but always fetch the file.
- variable=variable
-
Insert the variable.
Example
<define name=foo>This is a foo</define>
<insert name=foo>
<br><insert name=foo foo=cat>
<br><insert name=foo a=some foo=cats " is"=" are" his=here>
This is a foo
This is a cat
There are some cats
|