smarty/docs/id/programmers/plugins/plugins-modifiers.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
   <sect1 id="plugins.modifiers"><title>Pengubah</title>
    <para>
     <link linkend="language.modifiers">Pengubah</link> adalah fungsi kecil
     yang diterapkan ke variabel dalam template sebelum ia ditampilkan atau 
     digunakan dalam beberapa konteks lain. Pengubah dapat dirangkai bersama.
    </para>
    <funcsynopsis>
     <funcprototype>
      <funcdef>mixed <function>smarty_modifier_<replaceable>name</replaceable></function></funcdef>
      <paramdef>mixed <parameter>$value</parameter></paramdef>
      <paramdef>[mixed <parameter>$param1</parameter>, ...]</paramdef>
     </funcprototype>
    </funcsynopsis>
    <para>
     Parameter pertama pada plugin pengubah adalah nilai di mana pengubah
     beroperasi. Parameter sisanya adalah opsional, tergantung pada
     jenis operasi apa yang dilakukan.
    </para>
    <para>
     Pengubah harus <ulink url="&url.php-manual;return">mengembalikan</ulink>
     hasil dari prosesnya.
    </para>

    <example>
     <title>Plugin pengubah sederhana</title>
     <para>
      Plugin ini pada dasarnya alias dari salah satu fungsi built-in PHP. 
      Ini tidak mempunyai parameter tambahan.
     </para>
     <programlisting role="php">
<![CDATA[
<?php
/*
 * Smarty plugin
 * -------------------------------------------------------------
 * File:     modifier.capitalize.php
 * Tipe:     pengubah
 * Nama:     capitalize
 * Kegunaan: membesarkan kata dalam string
 * -------------------------------------------------------------
 */
function smarty_modifier_capitalize($string)
{
    return ucwords($string);
}
?>
]]>
</programlisting>
    </example>
    <para></para>
    <example>
     <title>Plugin pengubah lebih kompleks</title>
     <programlisting role="php">
<![CDATA[
<?php
/*
 * Smarty plugin
 * -------------------------------------------------------------
 * File:     modifier.truncate.php
 * Tipe:     pengubah
 * Nama:     truncate
 * Kegunaan: Potong string ke panjang tertentu bila perlu,
 *           secara opsional memisahkan di tengah kata, dan 
 *           menambahkan string $etc.
 * -------------------------------------------------------------
 */
function smarty_modifier_truncate($string, $length = 80, $etc = '...',
                                  $break_words = false)
{
    if ($length == 0)
        return '';

    if (strlen($string) > $length) {
        $length -= strlen($etc);
        $fragment = substr($string, 0, $length+1);
        if ($break_words)
            $fragment = substr($fragment, 0, -1);
        else
            $fragment = preg_replace('/\s+(\S+)?$/', '', $fragment);
        return $fragment.$etc;
    } else
        return $string;
}
?>
]]>
     </programlisting>
    </example>
     <para>
     Lihat juga
     <link linkend="api.register.modifier"><varname>register_modifier()</varname></link>,
     <link linkend="api.unregister.modifier"><varname>unregister_modifier()</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
-->