Location: PHPKode > projects > Open Power Template > docs/Opt/guide.escaping.html
<!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>Custom escaping functions - 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>Custom escaping functions</h2>
		<p class="generated">@ 02.09.2010</p>
		<p class="location"><a href="index.html"><strong>User manual</strong></a> &raquo; <a href="guide.html">Programmer's Guide</a> &raquo; <a href="guide.escaping.html">Custom escaping functions</a></p>
	</div>
	
	<div id="content"><dl class="location"><dt><a href="guide.html">4. Programmer's Guide</a><br/>4.8. Custom escaping functions</dt><dd class="prev">4.7. Template inheritance<br/><a href="guide.inheritance.html">&laquo; Previous</a></dd><dd class="next">4.9. Internationalization<br/><a href="guide.i18n.html">Next &raquo;</a></dd></dl>	<h1>4.8. Custom escaping functions</h1><p>Currently OPT sanitizes the script data placed in the templates with simple <code>htmlspecialchars()</code> function. However, we are aware of the fact it is not perfect. This part of the library will be extended in the future, but currently OPT provides the ability to use a custom function here. In order to to that, just register a new OPT function called <code>escape</code>:</p>

<pre class="php"><span style="color: #000088;">$tpl</span><span style="color: #339933;">-&gt;</span><span style="color: #004000;">register</span><span style="color: #009900;">&#40;</span>Opt_Class<span style="color: #339933;">::</span><span style="color: #004000;">PHP_FUNCTION</span><span style="color: #339933;">,</span> <span style="color: #0000ff;">'escape'</span><span style="color: #339933;">,</span> <span style="color: #0000ff;">'myFilter'</span><span style="color: #009900;">&#41;</span><span style="color: #339933;">;</span></pre>

<p>The registered function must take exactly one argument - the text to be sanitized.</p>

<blockquote class="error">
  <p>In case of this function, it is not allowed to use argument order manipulators like <code>#2,1,3#</code>.</p>
</blockquote>
<h4>See also:</h4><ul><li><a href="syntax.expressions.escaping.html">3.5.7. HTML escaping</a></li></ul><dl class="location location-bottom"><dt>4.8. Custom escaping functions<br/><a href="guide.html">4. Programmer's Guide</a></dt><dd class="prev"><a href="guide.inheritance.html">&laquo; Previous</a><br/>4.7. Template inheritance</dd><dd class="next"><a href="guide.i18n.html">Next &raquo;</a><br/>4.9. Internationalization</dd></dl>		</div>
	
	<div id="footer">
		<p>Copyright &copy; <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>
Return current item: Open Power Template