NAME

XAO::DO::Web::URL - displays base, active and secure URLs

SYNOPSIS

Given that base_url is 'http://host.com' and browser is at 'http://www.host.com/test.html?a=1' the following translations will be performed:

<%URL%>                    -- http://www.host.com/test.html
<%URL active%>             -- http://www.host.com/test.html
<%URL active top%>         -- http://www.host.com
<%URL active full%>        -- http://www.host.com/test.html
<%URL active secure%>      -- https://www.host.com/test.html
<%URL active top secure%>  -- https://www.host.com
<%URL active full secure%> -- https://www.host.com/test.html
<%URL base%>               -- http://host.com/test.html
<%URL base top%>           -- http://host.com
<%URL base full%>          -- http://host.com/test.html
<%URL base secure%>        -- https://host.com/test.html
<%URL base top secure%>    -- https://host.com
<%URL base full secure%>   -- https://host.com/test.html
<%URL secure%>             -- https://www.host.com/test.html

If browser is at 'https://www.host.com/test.html' (secure protocol):

<%URL%>                    -- https://www.host.com/test.html
<%URL insecure%>           -- http://www.host.com/test.html
<%URL base%>               -- https://host.com/test.html
<%URL base top insecure%>  -- http://host.com

DESCRIPTION

Allows to display URL with some possible alterations. Default is to display full URL of the current page using active host name, if the page is a secure one then the URL will be secure. Active host name is usually the same as base host name, but may differ if your web server is set up to serve more then one domain using the same XAO::Web site.

Base URL is set as 'base_url' parameter in the initial site configuration.

METHODS

EXPORTS

Nothing.

AUTHOR

Copyright (c) 2003 XAO Inc.

Andrew Maltsev <am@xao.com>.

SEE ALSO

Recommended reading: XAO::Web, XAO::DO::Web::Page.