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
<%URL uri%>                -- /test.html
<%URL x='TAG'%>            -- from /extra_urls, assumes "top"

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 the base host name. If the page is a secure one then the URL will also be secure.

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

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.

METHODS

EXPORTS

Nothing.

AUTHOR

Copyright (c) 2005 Andrew Maltsev

Copyright (c) 2001-2004 Andrew Maltsev, XAO Inc.

<am@ejelta.com> -- http://ejelta.com/xao/

SEE ALSO

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