Files
smarty/docs/id/programmers/plugins/plugins-functions.xml
2007-09-18 21:38:43 +00:00

131 lines
3.8 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<sect1 id="plugins.functions"><title>Fungsi Template</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>smarty_function_<replaceable>name</replaceable></function></funcdef>
<paramdef>array <parameter>$params</parameter></paramdef>
<paramdef>object <parameter>&amp;$smarty</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Semua <link linkend="language.syntax.attributes">atribut</link> yang
dikirimkan ke fungsi template dari template yang berisi
<parameter>$params</parameter> sebagai array asosiatif.
</para>
<para>
Output (nilai hasil) atas fungsi akan diganti di tempat tag fungsi dalam
template, misalnya fungsi
<link linkend="language.function.fetch"><varname>{fetch}</varname></link>.
Alternatif lain, fungsi bisa hanya melakukan beberapa tugas tanpa output
apapun, misalnya fugnsi <link linkend="language.function.assign">
<varname>{assign}</varname></link>.
</para>
<para>
Jika fungsi perlu menempatkan beberapa variabel ke template atau gunakan
beberapa fungsionalitas lain yang disediakan-Smarty, ini dapat menggunakan
obyek <parameter>$smarty</parameter> yang disertakan untuk melakukannya
misaslnya <literal>$smarty->foo()</literal>.
</para>
<para>
<example>
<title>plugin fungsi dengan output</title>
<programlisting role="php">
<![CDATA[
<?php
/*
* Smarty plugin
* -------------------------------------------------------------
* File: function.eightball.php
* Tipe: fungsi
* Nama: eightball
* Kegunaan: menampilkan jawaban acak magis
* -------------------------------------------------------------
*/
function smarty_function_eightball($params, &$smarty)
{
$answers = array('Yes',
'No',
'No way',
'Outlook not so good',
'Ask again soon',
'Maybe in your reality');
$result = array_rand($answers);
return $answers[$result];
}
?>
]]>
</programlisting>
</example>
</para>
<para>
yang dapat digunakan dalam template sebagai:
</para>
<programlisting>
Question: Will we ever have time travel?
Answer: {eightball}.
</programlisting>
<para>
<example>
<title>plugin fungsi tanpa output</title>
<programlisting role="php">
<![CDATA[
<?php
/*
* Smarty plugin
* -------------------------------------------------------------
* File: function.assign.php
* Tipe: fungsi
* Nama: assign
* Kegunaan: menempatkan nilai ke varabel template
* -------------------------------------------------------------
*/
function smarty_function_assign($params, &$smarty)
{
if (empty($params['var'])) {
$smarty->trigger_error("assign: missing 'var' parameter");
return;
}
if (!in_array('value', array_keys($params))) {
$smarty->trigger_error("assign: missing 'value' parameter");
return;
}
$smarty->assign($params['var'], $params['value']);
}
?>
]]>
</programlisting>
</example>
</para>
<para>
Lihat juga:
<link linkend="api.register.function"><varname>register_function()</varname></link>,
<link linkend="api.unregister.function"><varname>unregister_function()</varname></link>.
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->