<redirect/>

Provided by module: Tags: RXML tags

Redirects the user to another page by sending a HTTP redirect header to the client. If the redirect is local, i.e. within the server, all prestates are preserved. E.g. "/index.html" and "index.html" preserves the prestates, while "http://server.com/index.html" does not.

Note!

Be aware that RXML code both before and after this tag will generate output that is included in the resulting page.

Attributes

to="URL"

The location to where the client should be sent.

type="string"

The type of redirect, i.e. the http status code. This can be one of the strings "permanent" (301), "found" (302), "see-other" (303), or "temporary" (307). It can also be an integer code. The default is 302.

add="string"

The prestate or prestates that should be added, in a comma-separated list.

drop="string"

The prestate or prestates that should be dropped, in a comma-separated list.

drop-all

Removes all prestates from the redirect target.

text="string"

Sends a text string to the browser, that hints from where and why the page was redirected. Not all browsers will show this string. Only special clients like Telnet uses it.

Arguments prefixed with "add" or "drop" are treated as prestate toggles, which are added or removed, respectively, from the current set of prestates in the URL in the redirect header (see also <apre>). Note that this only works when the to=... URL is absolute, i.e. begins with a "/", otherwise these state toggles have no effect.