View on
MetaCPAN
Andrew Maltsev > XAO-Web > XAO::DO::Web::URL

Download:
XAO-Web-1.47.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 2.002   Source  

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.

syntax highlighting: