smarty/docs/pt_BR/designers/language-builtin-functions/language-function-insert.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.2 Maintainer: thomasgm Status: ready -->
		<sect1 id="language.function.insert">
			<title>insert</title>
            <informaltable frame="all">
                <tgroup cols="5">
                <colspec colname="param" align="center" />
                <colspec colname="type" align="center" />
                <colspec colname="required" align="center" />
                <colspec colname="default" align="center" />
                <colspec colname="desc" />
                <thead>
                    <row>
                        <entry>Nome do Atributo</entry>
                        <entry>Tipo</entry>
                        <entry>Obrigat<EFBFBD>rio</entry>       
                        <entry>Padr<EFBFBD>o</entry>
                        <entry>Descri<EFBFBD><EFBFBD>o</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>name</entry>
                        <entry>string</entry>
                        <entry>Sim</entry>
                        <entry><emphasis>n/d</emphasis></entry>
                        <entry>O nome da fun<75><6E>o insert (insert_name)</entry>
                    </row>
                    <row>
                        <entry>assign</entry>
                        <entry>string</entry>
                        <entry>N<EFBFBD>o</entry>
                        <entry><emphasis>n/d</emphasis></entry>
                        <entry>O nome da vari<72>vel que
                        ir<69> receber a sa<73>da</entry>
                    </row>
                    <row>
                        <entry>script</entry>
                        <entry>string</entry>
                        <entry>N<EFBFBD>o</entry>
                        <entry><emphasis>n/d</emphasis></entry>
                        <entry>O nome de um script php que ser<65> incluido
                        antes que a fun<75><6E>o insert seja chamada</entry>
                    </row>
                    <row>
                        <entry>[var ...]</entry>
                        <entry>[var type]</entry>
                        <entry>N<EFBFBD>o</entry>
                        <entry><emphasis>n/d</emphasis></entry>
                        <entry>Vari<EFBFBD>vel para passar para a fun<75><6E>o insert</entry>
                    </row>
                </tbody>
                </tgroup>
            </informaltable>
			<para>
			 Tags insert funcionam parecido com as tags include, exceto que as tags
			 insert n<>o v<>o para o cache quando <link
			linkend="caching">caching</link> esta ativado. Ela ser<65>
			executada a cada invoca<63><61>o do template.
			</para>
            <para>
             Digamos que voc<6F> tenha um template com um banner no topo da p<>gina. O
             banner pode conter uma mistura de html, imagens, flash, etc.
             Assim n<>s n<>o podemos usar um link estatico aqui, e n<>s n<>o 
             queremos que este conte<74>do fique no cache junto com a p<>gina. E a<> que entra a tag 
             insert: o template conhece os valores #banner_location_id# e
             #site_id# (obtidos de um arquivo de configura<72><61>o), e precisa chamar
             uma fun<75><6E>o para obter o conte<74>do do banner.
			</para>
<example>
<title>fun<EFBFBD><EFBFBD>o insert</title>
<programlisting>
{* exemplo de como obter um banner *}
{insert name="getBanner" lid=#banner_location_id# sid=#site_id#}</programlisting>
</example>
			<para>
			 Neste exemplo, n<>s estamos usando o nome "getBanner" e passando os par<61>metros
			 #banner_location_id# e #site_id#. O Smarty ir<69> procurar por uma fun<75><6E>o chamada
			 insert_getBanner() na sua aplica<63><61>o PHP, passando os valores de 
			 #banner_location_id# e #site_id# como primeiro argumento em uma
			 matriz associativa. Todos os nomes de fun<75><6E>o insert em sua
			 aplica<63><61>o devem ser precedidas por "insert_" para prevenir poss<73>veis
			 problemas com nomes de fun<75><6E>es repetidos. Sua fun<75><6E>o insert_getBanner()
			 deve fazer alguma coisa com os valores passados e retornar os resultados.
			 Estes resultados s<>o mostrados no template no lugar da tag insert.
			 Neste exemplo, o Smarty ir<69> chamar esta fun<75><6E>o:
			 insert_getBanner(array("lid" => "12345","sid" => "67890"));
			 e mostrar o resultado retornado no lugar da tag insert.
			</para>
			<para>
			 Se voc<6F> passar o atributo "assign", a sa<73>da da tag insert ser<65>
			 dada para esta vari<72>vel ao inv<6E>s de ser mostrada
			 no template.
            </para>
			<note>
			 <title>Nota</title>
			  <para>
			   definir a sa<73>da para uma vari<72>vel n<>o <20>
			   <20>til quando o cache esta ativo.
			  </para>
			</note>
			<para>
			 Se voc<6F> passar o atributo "script", este script php ser<65> incluido
			 (apenas uma vez) antes da execu<63><75>o da fun<75><6E>o insert. Este
			 <20> o caso onde a fun<75><6E>o insert n<>o existe ainda, e um script
			 php deve ser inclu<6C>do antes para faze-la funcionar. O caminho pode
			 ser absoluto ou relativo <20> vari<72>vel $trusted_dir. Quando a seguran<61>a esta
			 ativada, o script deve estar no local definido na vari<72>vel $trusted_dir.
			</para>
			<para>
			 O objeto Smarty <20> passado como segundo argumento. Deste modo
			 voc<6F> pode refenciar o objeto Smarty
			 de dentro da fun<75><6E>o.
			</para>
			<note>
			<title>Nota Tecnica</title>
			<para>
			 <20> poss<73>vel ter partes do template fora do cache.
			 se voc<6F> tiver <link linkend="caching">caching</link>
             ativado, tags insert n<>o estar<61>o no cache. Ela ser<65> executada
             dinamicamente a cada vez que a p<>gina seja criada, mesmo com
             p<>ginas em cache. Isto funciona bem para coisas como banners, pesquisa,
             previs<69>es do tempo, resultados de pesquisa, <20>reas de opni<6E>o do usu<73>rio, etc.
			</para>
			</note>
</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
-->