mirror of
https://github.com/smarty-php/smarty.git
synced 2025-10-25 10:21:36 +02:00
122 lines
4.4 KiB
XML
122 lines
4.4 KiB
XML
<?xml version="1.0" encoding="iso-8859-1"?>
|
|
<!-- $Revision$ -->
|
|
<sect1 id="advanced.features.objects">
|
|
<title>Objetos</title>
|
|
<para>
|
|
El Smarty permite acceso a objetos de PHP a través de sus templates.
|
|
Hay dos formas de accesarlos. Una forma es
|
|
<link linkend="api.register.object">registrando objetos</link> para el
|
|
template, entonces acceselos mediante sintaxis similar a las funciones
|
|
habituales. La otra es <link linkend="api.assign">asignar objetos</link> al
|
|
template y accesarlos como si fueran una variable asignada. El primer método
|
|
tiene una sintaxis de template mucho mas agradable. Y también mas segura, a
|
|
medida que un objeto registrado puede ser reescrito a ciertos métodos y
|
|
propiedades. Sin embargo tanto, <emphasis role="bold">un objeto registrado
|
|
no puede ser puesto en loop o ser asignado en arreglos de objetos</emphasis>,
|
|
etc. El método que usted escoja sera determinado por sus necesidades, pero
|
|
utilice el primero método si es posible para mantener un minimo de sintaxis
|
|
en el template.
|
|
</para>
|
|
<para>
|
|
Si <link linkend="variable.security">$security</link> esta habilitada,
|
|
ninguno de los dos métodos privados o funciones pueden ser accesados
|
|
(comenzando con "_"). Si un metodo y propiedades de un mismo nombre existe,
|
|
el método será usado.
|
|
</para>
|
|
<para>
|
|
Usted puede restringir los métodos y propiedades que pueden ser accesados
|
|
listandolos en un arreglo como el tercer parámetro de registro.
|
|
</para>
|
|
<para>
|
|
Por default, los parámetros pasados a los objetos a a través de los
|
|
templates son pasados de la misma forma en que las
|
|
<link linkend="language.custom.functions">funciones de costumbre</link>
|
|
los obtienen. Un arreglo asociativo es pasado como el primer parámetro,
|
|
y el objeto smarty como el segundo. Si usted quiere que los parámetros
|
|
pasados uno de cada vez por cada argumento pasen como parámetros de un
|
|
objeto tradicional, defina el cuarto parámetro de registro en falso.
|
|
</para>
|
|
<para>
|
|
El quinto parámetro opcional solo tiene efecto con
|
|
<parameter>format</parameter> siendo <literal>true</literal>
|
|
y conteniendo una lista de métodos de ob que seran tratados
|
|
como bloques. Esto significa que estos métodos tienen una
|
|
etiqueta de cierre en el template
|
|
(<literal>{foobar->meth2}...{/foobar->meth2}</literal>) y
|
|
los parámetros para los métodos tienen la misma sinopsis como
|
|
los parámetros de <link
|
|
linkend="plugins.block.functions">block-function-plugins</link>:
|
|
Ellos reciben 4 parámetros
|
|
<parameter>$params</parameter>,
|
|
<parameter>$content</parameter>,
|
|
<parameter>&$smarty</parameter> y
|
|
<parameter>&$repeat</parameter> también se comportan como
|
|
block-function-plugins.
|
|
</para>
|
|
<example>
|
|
<title>usando un objeto registrado o atribuido</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// el objeto
|
|
|
|
class My_Object {
|
|
function meth1($params, &$smarty_obj) {
|
|
return "this is my meth1";
|
|
}
|
|
}
|
|
|
|
$myobj = new My_Object;
|
|
// registrando el objeto (será por referencia)
|
|
$smarty->register_object("foobar",$myobj);
|
|
// Si usted quiere restringir acceso a ciertos metodos o propriedades, listelos
|
|
$smarty->register_object("foobar",$myobj,array('meth1','meth2','prop1'));
|
|
// Si usted quiere usar el formato de parámetro del objeto tradicional, pase un booleano en false
|
|
$smarty->register_object("foobar",$myobj,null,false);
|
|
|
|
// también puede asignar ojetos. Posible cuando se asignan por referencia.
|
|
$smarty->assign_by_ref("myobj", $myobj);
|
|
|
|
$smarty->display("index.tpl");
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
<para>
|
|
y como debera accesar a su objeto en index.tpl
|
|
</para>
|
|
<programlisting>
|
|
<![CDATA[
|
|
{* accesando a nuestro objeto registrado *}
|
|
{foobar->meth1 p1="foo" p2=$bar}
|
|
|
|
{* usted también puede asignar la salida *}
|
|
{foobar->meth1 p1="foo" p2=$bar assign="output"}
|
|
the output was {$output}
|
|
|
|
{* accesando a nuestro objeto asignado *}
|
|
{$myobj->meth1("foo",$bar)}
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</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
|
|
-->
|