<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="pl">
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<meta name="robots" content="all" />
<title>opt:use - Open Power Template</title>
<link rel="stylesheet" type="text/css" href="design/generic.css" media="all" />
<link rel="stylesheet" type="text/css" href="design/print.css" media="print" />
<!--[if lte IE 6]><link rel="stylesheet" href="design/ie.css" type="text/css" /><![endif]-->
<!--[if IE 7]><link rel="stylesheet" href="design/ie7.css" type="text/css" /><![endif]-->
</head>
<body>
<div id="wrap">
<div id="header">
<h1>Open Power Template 2.0</h1>
<h2>opt:use</h2>
<p class="generated">@ 02.09.2010</p>
<p class="location"><a href="index.html"><strong>User manual</strong></a> » <a href="syntax.html">Template syntax</a> » <a href="syntax.attributes.html">OPT attributes</a> » <a href="syntax.attributes.use.html">opt:use</a></p>
</div>
<div id="content"><dl class="location"><dt><a href="syntax.attributes.html">3.8. OPT attributes</a><br/>3.8.11. opt:use</dt><dd class="prev">3.8.10. opt:single<br/><a href="syntax.attributes.single.html">« Previous</a></dd><dd class="next">3.9. Topics<br/><a href="syntax.topics.html">Next »</a></dd></dl> <h1>3.8.11. opt:use</h1><p>This attribute works similarly to <a href="syntax.instructions.insert.html" title="3.7.13. opt:insert">opt:insert</a> tag - it pastes the content of the snippet as the tag content. The original content is kept, if the snippet does not exist.</p>
<pre class="xml"><span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><opt:snippet</span> <span style="color: #000066;">name</span>=<span style="color: #ff0000;">"newBetterParagraph"</span><span style="color: #000000; font-weight: bold;">></span></span>
This is a content of the better paragraph!
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"></opt:snippet<span style="color: #000000; font-weight: bold;">></span></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><p</span> <span style="color: #000066;">opt:use</span>=<span style="color: #ff0000;">"newBetterParagraph"</span><span style="color: #000000; font-weight: bold;">></span></span>This is the default content<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"></p<span style="color: #000000; font-weight: bold;">></span></span></span></pre>
<p>Similarly to <code>opt:insert</code>, the original content may still appear, if the snippet contains <code>opt:parent</code>. This feature can be used to pack the existing content in the new tags. In the example below, we pack the text in the paragraph in an URL:</p>
<pre class="xml"><span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><opt:snippet</span> <span style="color: #000066;">name</span>=<span style="color: #ff0000;">"url"</span><span style="color: #000000; font-weight: bold;">></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><a</span> <span style="color: #000066;">parse:href</span>=<span style="color: #ff0000;">"$url"</span><span style="color: #000000; font-weight: bold;">></span><span style="color: #000000; font-weight: bold;"><opt:parent</span> <span style="color: #000000; font-weight: bold;">/></span><span style="color: #000000; font-weight: bold;"></a<span style="color: #000000; font-weight: bold;">></span></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"></opt:snippet<span style="color: #000000; font-weight: bold;">></span></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><p</span> <span style="color: #000066;">opt:use</span>=<span style="color: #ff0000;">"url"</span><span style="color: #000000; font-weight: bold;">></span></span>The text to be changed into URL.<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"></p<span style="color: #000000; font-weight: bold;">></span></span></span></pre>
<h2>Section integration</h2>
<p><code>opt:use</code> allows to define the generic section content. When pasted to the section tags, the snippet is automatically connected to the new section:</p>
<pre class="xml"><span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><opt:snippet</span> <span style="color: #000066;">name</span>=<span style="color: #ff0000;">"element"</span><span style="color: #000000; font-weight: bold;">></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><li<span style="color: #000000; font-weight: bold;">></span></span></span>{$element.name}<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"></li<span style="color: #000000; font-weight: bold;">></span></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"></opt:snippet<span style="color: #000000; font-weight: bold;">></span></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><p<span style="color: #000000; font-weight: bold;">></span></span></span>Categories:<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"></p<span style="color: #000000; font-weight: bold;">></span></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><ol<span style="color: #000000; font-weight: bold;">></span></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><opt:section</span> <span style="color: #000066;">name</span>=<span style="color: #ff0000;">"categories"</span> <span style="color: #000066;">opt:use</span>=<span style="color: #ff0000;">"element"</span> <span style="color: #000000; font-weight: bold;">/></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"></ol<span style="color: #000000; font-weight: bold;">></span></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><p<span style="color: #000000; font-weight: bold;">></span></span></span>Products:<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"></p<span style="color: #000000; font-weight: bold;">></span></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><ol<span style="color: #000000; font-weight: bold;">></span></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"><opt:section</span> <span style="color: #000066;">name</span>=<span style="color: #ff0000;">"products"</span> <span style="color: #000066;">opt:use</span>=<span style="color: #ff0000;">"element"</span><span style="color: #000000; font-weight: bold;">></span><span style="color: #000000; font-weight: bold;"></opt:section<span style="color: #000000; font-weight: bold;">></span></span></span>
<span style="color: #009900;"><span style="color: #000000; font-weight: bold;"></ol<span style="color: #000000; font-weight: bold;">></span></span></span></pre>
<p>When the <code>element</code> snippet is pasted to the <code>categories</code> sections, the variables <code>$element.foo</code> become <code>$categories.foo</code> etc. If we later paste the same snippet in the <code>products</code> section content, the same variables become <code>$products.foo</code>. This applies to all kinds of sections.</p>
<h4>See also:</h4><ul><li><a href="syntax.instructions.insert.html">3.7.13. opt:insert</a></li></ul><dl class="location location-bottom"><dt>3.8.11. opt:use<br/><a href="syntax.attributes.html">3.8. OPT attributes</a></dt><dd class="prev"><a href="syntax.attributes.single.html">« Previous</a><br/>3.8.10. opt:single</dd><dd class="next"><a href="syntax.topics.html">Next »</a><br/>3.9. Topics</dd></dl> </div>
<div id="footer">
<p>Copyright © <a href="http://www.invenzzia.org/">Invenzzia Group 2008-2009</a></p>
<p>Available under the terms of license: <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License 1.2</a></p>
<p>Generated by <strong>TypeFriendly 0.1.4</strong> by <a href="http://www.invenzzia.org/">Invenzzia</a></p>
</div>
</div>
</body>
</html>