Home > AXS Visitor Tracking > Help > 1021

Long form redirects

AXS supports "short form" redirects by simply supplying the full URL to ax.pl in the query string:

http://xav.com/perl/ax.pl?http://www.yahoo.com/

In addition to the redirection option, the logging script may print a transparent GIF, print an SSI response, or print the debug page. The script chooses from among those four options based on the query string and other environment variables. To avoid confusion, a "long form" calling convention exists which is less error-prone. It uses a "mode" parameter to clearly specify which of the four options should be used:

http://xav.com/perl/ax.pl?mode=ssi
http://xav.com/perl/ax.pl?mode=debug
http://xav.com/perl/ax.pl?mode=img
http://xav.com/perl/ax.pl?mode=redir&nexturl=http://www.yahoo.com/

In cases where you are redirecting to a URL which uses a "mode" parameter of its own, you must use the long form. The redirect URL must be URL-encoded as well.

Example

http://www.mysite.tld/?a=b&x=y&mode=1
	# destination URL
	# MUST use long form due to presence of 'mode' param

http%3A//www.mysite.tld/%3Fa%3Db%26x%3Dy%26mode%3D1%0D%0A
	# URL encoding of destination URL

http://xav.com/perl/ax.pl?mode=redir&nexturl=http%3A//www.mysite.tld/%3Fa%3Db%26x%3Dy%26mode%3D1%0D%0A
	# example of correct "long form" redirect link

    "Long form redirects"
    http://www.xav.com/scripts/axs/help/1021.html