<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 14 (filtered medium)">
<base href="http://permalink.gmane.org/gmane.comp.cms.opencms.devel/39403">
<title>Re: <cms:link> tag - when to use?</title>
<style><!--
/* Font Definitions */
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
@font-face
{font-family:Consolas;
panose-1:2 11 6 9 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman","serif";
color:black;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
pre
{mso-style-priority:99;
mso-style-link:"HTML Vorformatiert Zchn";
margin:0cm;
margin-bottom:.0001pt;
font-size:10.0pt;
font-family:"Courier New";
color:black;}
p.MsoAcetate, li.MsoAcetate, div.MsoAcetate
{mso-style-priority:99;
mso-style-link:"Sprechblasentext Zchn";
margin:0cm;
margin-bottom:.0001pt;
font-size:8.0pt;
font-family:"Tahoma","sans-serif";
color:black;}
span.HTMLVorformatiertZchn
{mso-style-name:"HTML Vorformatiert Zchn";
mso-style-priority:99;
mso-style-link:"HTML Vorformatiert";
font-family:"Consolas","serif";
color:black;}
span.E-MailFormatvorlage19
{mso-style-type:personal-reply;
font-family:"Calibri","sans-serif";
color:#1F497D;}
span.SprechblasentextZchn
{mso-style-name:"Sprechblasentext Zchn";
mso-style-priority:99;
mso-style-link:Sprechblasentext;
font-family:"Tahoma","sans-serif";
color:black;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;}
@page WordSection1
{size:612.0pt 792.0pt;
margin:70.85pt 70.85pt 2.0cm 70.85pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body bgcolor="white" lang="DE" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span lang="EN-US" style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">Thanks for that. I never managed to check that.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">Best regards<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1F497D">Kai<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<div>
<div style="border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0cm 0cm 0cm">
<p class="MsoNormal"><b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif";color:windowtext">Von:</span></b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif";color:windowtext"> opencms-dev-bounces@opencms.org [mailto:opencms-dev-bounces@opencms.org]
<b>Im Auftrag von </b>Tobias Karrer<br>
<b>Gesendet:</b> Dienstag, 11. November 2014 18:53<br>
<b>An:</b> The OpenCms mailing list<br>
<b>Betreff:</b> Re: [opencms-dev] tag - when to use?<o:p></o:p></span></p>
</div>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal">"<i>Somehow the <cms:img> tag doesn't need it</i>. "<br>
Because it is explicitly done in CmsJspTagImage#imageTagAction() (line 274 in 9.0.1):<br>
<span style="font-family:"Courier New""> </span><span style="font-size:10.0pt;font-family:"Courier New"">result.append(OpenCms.getLinkManager().substituteLink(cms, imageLink));</span><span style="font-size:10.0pt">
</span><br>
:-)<br>
<br>
Tobias<br>
<br>
Am 11.11.2014 14:06, schrieb Schliemann, Kai:<o:p></o:p></p>
</div>
<blockquote style="margin-top:5.0pt;margin-bottom:5.0pt">
<pre>Hi Chris,<o:p></o:p></pre>
<pre>I have a minor addition to Paul's excellent explanation ( I wonder, if we should put that on the OpenCms wiki).<o:p></o:p></pre>
<pre>Don't use the <cms:link> tag inside an <cms:img> tag. Somehow the <cms:img> tag doesn't need it.<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>Best regards<o:p></o:p></pre>
<pre>Kai<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>-----Ursprüngliche Nachricht-----<o:p></o:p></pre>
<pre>Von: opencms-dev-bounces< at >opencms.org [<a href="mailto:opencms-dev-bounces">mailto:opencms-dev-bounces</a>< at >opencms.org] Im Auftrag von Paul-Inge Flakstad<o:p></o:p></pre>
<pre>Gesendet: Dienstag, 11. November 2014 14:49<o:p></o:p></pre>
<pre>An: kuku< at >physik.rwth-aachen.de; The OpenCms mailing list<o:p></o:p></pre>
<pre>Betreff: Re: [opencms-dev] <cms:link> tag - when to use?<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>Hi Chris,<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>1) About the <cms:link> tag<o:p></o:p></pre>
<pre>It's definitely a bad idea to drop the <cms:link> tag. It's vital to properly perform URI conversion/substitution/translation (whichever word you prefer).<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre><cms:link> makes sure any OpenCms-relative URI is converted to a site-relative URI. This function is *vital* if your site has a prefix like "/opencms/opencms".<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>E.g.: <o:p></o:p></pre>
<pre>Say you have a stylesheet with an OpenCms-relative URI like "/system/modules/module/resources/style.css". This URI is the one you should always use in your code (or, alternatively, an equivalent like "../resources/style.css"). Now, if your OpenCms site has a prefix - "/opencms/opencms" - then the site-relative URI is "/opencms/opencms/system/modules/module/resources/style.css". Note the difference in the two URIs.<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>Of course, most real-world sites have no prefix. As a result, the OpenCms-relative URI and the site-relative URI are identical. So, you might be tempted to drop the <cms:link> tag. Don't.<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>First of all; Things won't work properly if you at some point should *introduce* a prefix like "/opencms/opencms". (You probably won't do that for production sites or anything, but perhaps some of your OpenCms installs used for testing have a prefix? -I know some of mine do. Proper use of the <cms:link> tag is important if you want your stuff to work on those test installs.)<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>Secondly; The <cms:link> tag handles another important feature: Link substitution for exported resources.<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>Static resources - stylesheets, javascripts, images etc. - are typically exported by OpenCms over to the server's real file system (RFS), and mostly served from there. (More efficient.) If you drop using the <cms:link> tag, these resources will always be served from OpenCms - never from the RFS. (They will still be exported though. Not that it matters much.)<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>When you use <cms:link> around a URI that refers to a resource that gets exported, that URI is automagically substituted (in the Online project) with the URI of its corresponding exported resource. <o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>E.g.: "/img/myimage.jpg" --becomes--> "/opencms/export/sites/mysite/img/myimage.jpg"<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre><o:p> </o:p></pre>
<pre>2) About your script error<o:p></o:p></pre>
<pre>Very little info to work with, so it's a long shot: Please make sure you've declared the "cms" taglib prefix (in the directives at the top of the JSP), like this:<o:p></o:p></pre>
<pre><%< at >taglib prefix="cms" uri=<a href="http://www.opencms.org/taglib/cms">"http://www.opencms.org/taglib/cms"</a> %><o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>If that's not it, please provide further info so we may help you identify the error.<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>Cheers,<o:p></o:p></pre>
<pre>Paul<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>-----Original Message-----<o:p></o:p></pre>
<pre>From: opencms-dev-bounces< at >opencms.org [<a href="mailto:opencms-dev-bounces">mailto:opencms-dev-bounces</a>< at >opencms.org] On Behalf Of Christoph Kukulies<o:p></o:p></pre>
<pre>Sent: 11. november 2014 11:01<o:p></o:p></pre>
<pre>To: The OpenCms mailing list<o:p></o:p></pre>
<pre>Subject: [opencms-dev] <cms:link> tag - when to use?<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>I'm importing a site from Wordpress into OpenCms and while looking at the links used in the original page I'm asking myself whether I should surround every link, e.g. a page that is invoked behind a menu item, with a "<cms:link>/actual/link/</cms:link>". Is it necessary, what is the benefit?<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>Side note: when I have the jsp open in the workplace and I'm cut/pasting a such modified code, by CTRL-A selecting all and pasting (CTRL-V) the modified code with all the new links I'm ending in a script error, saying that a script on the page is no longer functioning.<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre><o:p> </o:p></pre>
<pre>--<o:p></o:p></pre>
<pre>Chris Christoph P. U. Kukulies kukulies (at) rwth-aachen.de _______________________________________________<o:p></o:p></pre>
<pre>This mail is sent to you from the opencms-dev mailing list To change your list options, or to unsubscribe from the list, please visit <a href="http://lists.opencms.org/cgi-bin/mailman/listinfo/opencms-dev">http://lists.opencms.org/cgi-bin/mailman/listinfo/opencms-dev</a><o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre><o:p> </o:p></pre>
<pre><o:p> </o:p></pre>
<pre>_______________________________________________<o:p></o:p></pre>
<pre>This mail is sent to you from the opencms-dev mailing list To change your list options, or to unsubscribe from the list, please visit <a href="http://lists.opencms.org/cgi-bin/mailman/listinfo/opencms-dev">http://lists.opencms.org/cgi-bin/mailman/listinfo/opencms-dev</a><o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre><o:p> </o:p></pre>
<pre><o:p> </o:p></pre>
<pre>_______________________________________________<o:p></o:p></pre>
<pre>This mail is sent to you from the opencms-dev mailing list<o:p></o:p></pre>
<pre>To change your list options, or to unsubscribe from the list, please visit<o:p></o:p></pre>
<pre><a href="http://lists.opencms.org/cgi-bin/mailman/listinfo/opencms-dev">http://lists.opencms.org/cgi-bin/mailman/listinfo/opencms-dev</a><o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre><o:p> </o:p></pre>
<pre><o:p> </o:p></pre>
<pre><o:p> </o:p></pre>
</blockquote>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</body>
</html>