⧼vector-jumptocontent⧽

API:EPrints/URL: Difference between revisions

From EPrints Documentation
← Older edit
No edit summary
No edit summary
 
Line 8: Line 8:
'''EPrints::URL''' - URL utility methods
'''EPrints::URL''' - URL utility methods


<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->
<!-- Edit below this comment -->




<!-- Pod2Wiki= -->
<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=head_description -->
<!-- Pod2Wiki=head_description -->
==DESCRIPTION==
==DESCRIPTION==
This module contains utility methods for generating and getting URLs, relative paths etc.
This module contains utility methods for generating and getting URLs, relative paths etc.


<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->
<!-- Edit below this comment -->




<!-- Pod2Wiki= -->
<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=head_synopsis -->
<!-- Pod2Wiki=head_synopsis -->
==SYNOPSIS==
==SYNOPSIS==
  use EPrints;
<source lang="perl">use EPrints;
 
 
  my $base_url = $session-&gt;get_url-&gt;get(
my $base_url = $session->get_url->get(
    scheme =&gt; "auto",
scheme => "auto",
    host =&gt; 1,
host => 1,
    path =&gt; "cgi",
path => "cgi",
    query =&gt; 0,
query => 0,
  );
);</source>
 
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->
<!-- Edit below this comment -->




<!-- Pod2Wiki= -->
<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=head_methods -->
<!-- Pod2Wiki=head_methods -->
==METHODS==
==METHODS==
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<!-- Pod2Wiki=head_get -->
<span style='display:none'>User Comments</span>
===get===
<!-- Edit below this comment -->
 


<!-- Pod2Wiki= -->
<source lang="perl">$url = $url->get( %opts [, $page ] )
</div>
<!-- Pod2Wiki=item_get -->
===get===


$url = $url-&gt;get( %opts [, $page ] )
</source>
Constructs a $url based on the current configuration and %opts. If $page is specified will return a URL to that page.
Constructs a $url based on the current configuration and %opts. If $page is specified will return a URL to that page.


<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
* scheme =&gt; "auto"
<span style='display:none'>User Comments</span>
: Link to same protocol as is active now (N/A to shell scripts).
<!-- Edit below this comment -->
 
 
<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=item_scheme_auto -->
===scheme_auto===
 
scheme =&gt; "auto"
Link to same protocol as is active now (N/A to shell scripts).
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->
 


<!-- Pod2Wiki= -->
* scheme =&gt; "http"
</div>
: Link to the non-secure location.
<!-- Pod2Wiki=item_scheme_http -->
===scheme_http===


scheme =&gt; "http"
* scheme =&gt; "https"
Link to the non-secure location.
: Link to the secure location (or http if <code>securehost</code> isn't defined).


<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
* host =&gt; 1
<span style='display:none'>User Comments</span>
: Create an absolute link (including host and port).
<!-- Edit below this comment -->


* path =&gt; "auto"
: Use the current path (N/A to shell scripts).


<!-- Pod2Wiki= -->
* path =&gt; "static", path =&gt; "cgi", path =&gt; "images"
</div>
: Link to the root of the static, cgi and images respectively.
<!-- Pod2Wiki=item_scheme_https -->
===scheme_https===


scheme =&gt; "https"
* query =&gt; 1
Link to the secure location.
: Create a self-referential link (i.e. include all parameters in the query part).


<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->
<!-- Edit below this comment -->




<!-- Pod2Wiki= -->
<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=head_copyright -->
<!-- Pod2Wiki=item_host_1 -->
==COPYRIGHT==
===host_1===
Copyright 2000-2011 University of Southampton.
 
host =&gt; 1
Create an absolute link (including host and port).
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->
 
 
<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=item_path_auto -->
===path_auto===
 
path =&gt; "auto"
Use the current path (N/A to shell scripts).
 
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->
 


<!-- Pod2Wiki= -->
This file is part of EPrints http://www.eprints.org/.
</div>
<!-- Pod2Wiki=item_path_static_path_cgi_path_images -->
===path_static_path_cgi_path_images===


path =&gt; "static", path =&gt; "cgi", path =&gt; "images"
EPrints is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Link to the root of the static, cgi and images respectively.


<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '>
EPrints is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License for more details.
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->
 
 
<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=item_query_1 -->
===query_1===


  query =&gt; 1
You should have received a copy of the GNU Lesser General Public License along with EPrints. If not, see http://www.gnu.org/licenses/.
Create a self-referential link (i.e. include all parameters in the query part).


<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->
<!-- Edit below this comment -->




<!-- Pod2Wiki= -->
<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=_postamble_ -->
<!-- Pod2Wiki=head_copyright -->
==COPYRIGHT==
<div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce;  padding: 0em 1em 0em 1em; font-size: 80%; '>
<span style='display:none'>User Comments</span>
<!-- Edit below this comment -->
<!-- Edit below this comment -->
<!-- Pod2Wiki= -->
</div>
<!-- Pod2Wiki=_postamble_ --><!-- Edit below this comment -->

Latest revision as of 09:56, 22 January 2013

Latest Source Code (3.4, 3.3) | Revision Log | Before editing this page please read Pod2Wiki


NAME

EPrints::URL - URL utility methods


DESCRIPTION

This module contains utility methods for generating and getting URLs, relative paths etc.


SYNOPSIS

use EPrints;

my $base_url = $session->get_url->get(
	scheme => "auto",
	host => 1,
	path => "cgi",
	query => 0,
);


METHODS

get

$url = $url->get( %opts [, $page ] )

Constructs a $url based on the current configuration and %opts. If $page is specified will return a URL to that page.

  • scheme => "auto"
Link to same protocol as is active now (N/A to shell scripts).
  • scheme => "http"
Link to the non-secure location.
  • scheme => "https"
Link to the secure location (or http if securehost isn't defined).
  • host => 1
Create an absolute link (including host and port).
  • path => "auto"
Use the current path (N/A to shell scripts).
  • path => "static", path => "cgi", path => "images"
Link to the root of the static, cgi and images respectively.
  • query => 1
Create a self-referential link (i.e. include all parameters in the query part).


COPYRIGHT

Copyright 2000-2011 University of Southampton.

This file is part of EPrints http://www.eprints.org/.

EPrints is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

EPrints is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with EPrints. If not, see http://www.gnu.org/licenses/.



Retrieved from "https://wiki.ext-9.eprints-hosting.org/w/index.php?title=API:EPrints/URL&oldid=10689"