smarty/docs/pt_BR/programmers/advanced-features/template-resources.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready -->
  <sect1 id="template.resources">
   <title>Recursos (Resources)</title>
   <para>
	Os templates podem vir de uma variedade de fontes. Quando voc<6F> exibe (display) ou
	 busca (fetch) um template, ou inclui um template de dentro de outro template, voc<6F> 
	 fornece um tipo de recurso, seguido pelo
	 caminho e nome do template apropriado. Se um 
	 recurso n<>o <20> dado explicitamente o valor de 
	 <link linkend="variable.default.resource.type">$default_resource_type</link> <20> assumido.
   </para>
   <sect2 id="templates.from.template.dir">
    <title>Templates partindo do $template_dir</title>
    <para>
     Templates a partir do $template_dir n<>o exigem um recurso de template,
     apesar de voc<6F> usar o arquivo: resource for consistancy.
     Apenas forne<6E>a o caminho para o template que voc<6F> quer usar em rela<6C><61>o ao diret<65>rio
     root $template_dir.
    </para>
    <example>
     <title>Usando templates partindo do $template_dir</title>
     <programlisting>
// from PHP script
$smarty->display("index.tpl");
$smarty->display("admin/menu.tpl");
$smarty->display("file:admin/menu.tpl"); // Igual ao de cima

{* de dentro do template do Smarty *}
{include file="index.tpl"}
{include file="file:index.tpl"} {* igual ao de cima *}</programlisting>
    </example>
   </sect2>
   <sect2 id="templates.from.any.dir">
    <title>Templates partindo de qualquer diret<65>rio</title>
    <para>
     Os Templates de fora do $template_dir exigem o arquivo:
     tipo de recurso do template,
     seguido pelo caminho absoluto e nome do template.
    </para>
    <example>
     <title>usando templates partindo de qualquer diret<65>rio</title>
     <programlisting>
// de dentro do script PHP
$smarty->display("file:/export/templates/index.tpl");
$smarty->display("file:/path/to/my/templates/menu.tpl");

{* de dentro do template do Smarty *}
{include file="file:/usr/local/share/templates/navigation.tpl"}</programlisting>
    </example>

    <sect3 id="templates.windows.filepath">
     <title>Caminhos de arquivos do Windows</title>
     <para>
      Se voc<6F> est<73> usando uma m<>quina windows, caminhos de arquivos normalmente incluem uma letra
      do drive (C:) no come<6D>o do nome do caminho.
      Esteja certo de usar "file:" no caminho para
      evitar conflitos de nome e obter os resultados desejados.
     </para>
     <example>
      <title>usando templates com caminhos de arquivo do windows</title>
      <programlisting>
// de dentro do script PHP
$smarty->display("file:C:/export/templates/index.tpl");
$smarty->display("file:F:/path/to/my/templates/menu.tpl");

{* de dentro do template do Smarty *}
{include file="file:D:/usr/local/share/templates/navigation.tpl"}</programlisting>
     </example>
    </sect3>
   </sect2>

   <sect2 id="templates.from.elsewhere">
    <title>Templates partindo de outras fontes</title>
    <para>
     Voc<6F> pode resgatar templates usando qualquer fonte poss<73>vel de voc<6F> acessar com PHP: banco
      de dados, sockets, LDAP, e assim por diante.
      Voc<6F> faz isto escrevendo as fun<75><6E>es de plugin
      de recurso e registrando elas com o Smarty.
    </para>

    <para>
     Veja a se<73><65>o <link linkend="plugins.resources">plugins de recurso</link>
     para mais informa<6D><61>o sobre as fun<75><6E>es
     que voc<6F> deve fornecer.
    </para>

    <note>
     <para>
      Note que voc<6F> pode ativar manualmente o recurso de <literal>arquivo</literal> embutido, mas n<>o pode fornecer um recurso que busca templates a partir do sistema de arquivos de alguma outra forma registrando sob um outro nome de recurso.
      <literal>file</literal> resource, but you can provide a resource
      that fetches templates from the file system in some other way by
      registering under another resource name.
     </para>
    </note>
    <example>
     <title>usando recursos customiz<69>veis</title>
     <programlisting>
// no script PHP

// ponha estas fun<75><6E>es em algum lugar de sua aplica<63><61>o
function db_get_template ($tpl_name, &amp;$tpl_source, &amp;$smarty_obj)
{
    // fa<66>a o banco de dados chamar aqui para buscar o seu template,
    // preenchendo o $tpl_source
    $sql = new SQL;
    $sql->query("select tpl_source
                   from my_table
                  where tpl_name='$tpl_name'");
    if ($sql->num_rows) {
        $tpl_source = $sql->record['tpl_source'];
        return true;
    } else {
        return false;
    }
}

function db_get_timestamp($tpl_name, &amp;$tpl_timestamp, &amp;$smarty_obj)
{
    // fa<66>a o banco de dados chamar daqui para preencher a $tpl_timestamp.
    $sql = new SQL;
    $sql->query("select tpl_timestamp
                   from my_table
                  where tpl_name='$tpl_name'");
    if ($sql->num_rows) {
        $tpl_timestamp = $sql->record['tpl_timestamp'];
        return true;
    } else {
        return false;
    }
}

function db_get_secure($tpl_name, &amp;$smarty_obj)
{
    // assume-se que todos os templates s<>o seguros
    return true;
}

function db_get_trusted($tpl_name, &amp;$smarty_obj)
{
    // n<>o usado para templates
}

// registrar o nome de recurso "db"
$smarty->register_resource("db", array("db_get_template",
                                       "db_get_timestamp",
                                       "db_get_secure",
                                       "db_get_trusted"));

// usando o recurso a partir do script PHP
$smarty->display("db:index.tpl");

{* usando o recurso de dentro do template do Smarty *}
{include file="db:/extras/navigation.tpl"}</programlisting>
    </example>
   </sect2>

   <sect2 id="default.template.handler.function">
    <title>Fun<EFBFBD><EFBFBD>o Manipuladora de Template Padr<64>o</title>
    <para>
     Voc<6F> pode especificar a fun<75><6E>o que <20> usada para devolver o conte<74>do do template no evento
     em que o template n<>o pode ser devolvido de seu recurso. Um uso disto <20> para criar templates
     que n<>o existem "on-the-fly" 
     (templates cujo conte<74>do flutua muito, bastante vari<72>vel).
    </para>
    <example>
     <title>usando a fun<75><6E>o manipuladora de template padr<64>o</title>
     <programlisting>
&lt;?php
// ponha esta fun<75><6E>o em algum lugar de sua aplica<63><61>o

function make_template ($resource_type, $resource_name, &amp;$template_source, &amp;$template_timestamp, &amp;$smarty_obj)
{
	if( $resource_type == 'file' ) {
		if ( ! is_readable ( $resource_name )) {
			// cria um arquivo de template, retorna o conte<74>do.
			$template_source = "This is a new template.";
			$template_timestamp = time();
			$smarty_obj->_write_file($resource_name,$template_source);
			return true;
		}
    } else {
		// n<>o <20> arquivo
		return false;
    }
}

// defina a manipuladora padr<64>o
$smarty->default_template_handler_func = 'make_template';
?&gt;</programlisting>
    </example>
   </sect2>
</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
-->