Passo 1 - Download
Bem o primeiro passo é fazer o download em:
Passo 2 - include_path
Depois que você descompactar os arquivos baixados, configure um diretório
de includes no seu servidor a partir do arquivo de configuração do PHP
(php.ini), para que qualquer que seja o local que você esteja não precise
colocar o caminho completo da classe.
Passo 3 - Utilização
Vamos criar o arquivo: cria_template.php como exemplo. Coloque uma
include para a classe para que TODOS os métodos da classe estejam
disponíveis no arquivo cria_template.php:
<?php
# include para o Classe FastTemplate
include ("class.FastTemplate.php3");
?>
Passo 4 - Instanciação
No mesmo arquivo (cria_template.php), crie uma instância para um novo objeto.
<?php
# cria uma nova Instância de objeto para a Classe
$template = new FastTemplate('.');
?>
O parâmetro => '.' deve ser o caminho onde estará os templates. Nesse
caso, na mesma pasta do arquivo "cria_template.php". Se, por acaso fosse
no diretório modelos deveria obedecer a sintaxe:
<?php
$template = new FastTemplate('modelos');
?>
Passo 5 - Objeto
Criar o objeto de template referenciando o arquivo de template:
<?php
$template->define(array("pagina"=>"pagina.tpl"));
?>
No caso acima o nome "pagina" será a referência do objeto para o
arquivo de template "pagina.tpl". A extensão poderia ser HTML, mas é
aconselhável manter o "*.tpl" para sabermos que é um template.
Passo 6 - Template dinâmico
Devemos agora criar outro template: O dinâmico. Aquele que considera
um bloco dinâmico para que seja usado apenas uma arquivo de template.
<?php
$template->define_dynamic("linhas","pagina");
# associa o modelo dinâmico "linhas" para o template página
# o nome "linhas" referes-e a um bloco dinâmico do mesmo nome na
# página do template definida em "pagina.tpl"
?>
Passo 7 - Exibição dos dados
Construir um loop de exibição de dados do bloco dinâmico na página de
Template. No caso usei o MySQL, mas pode-se usar qualquer banco de dados
ou até mesmo, por exemplo, um loop para construção de um depo down de
mês/dia/ano.
<?php
$dados=mysql_query("SELECT nome,fone from tabela ORDER BY nome");
while (list($nome,$fone)=mysql_fetch_row($dados)) {
$template->assign(array("{NOME}" => $nome, {FONE}" => $fone ));
$template->parse('LINHAS','.linhas');
}
?>
No caso acima o template dinâmico tem apenas duas CONSTANTES, que são
campos retornados de uma pesquisa SQL feita no MySQL e armazenada na
variável
$dados.
Deverá ser feita uma atribuição aos valores das contantes: {NOME} e
{FONE}. A classe percorrerá o arquivo "pagina.tpl" e onde encontrar
essas constantes a substituirá pelo conteúdo retornado pela consulta SQL.
Depois é feita uma "concatenação" dos resultados da pesquisa no bloco
dinâmico "linhas" definido no passo 6. O 1° argumento ,'LINHAS',
pode ser qualquer nome, mas é preferível colocar nomes sugestivos.
Passo 8 - Atribuição de resultados
Agora deverá ser feita a atribuição do resultado do bloco no primeiro
template que é a página completa do Template:
O 1° argumento ,'SAIDA', pode ser qualquer nome, mas é preferível
colocar nomes sugestivos.
Esse arquivo não deverá conter nenhuma TAG PHP, deverá conter apenas
HTML puro e logicamente as constantes definidas na página
"cria_template.php". No caso apresentado será exibido os dados numa
tabela de forma que a parte dinâmica, as linhas, estarão definidas
DENTRO do BLOCO DINÂMICO. O bloco dinâmico é delimitado pelos
comentários HTML!
Deverá ser seguida minuciosamente as palavras do comentários. Ou seja,
é case sensitive. Por isso mesmo coloque tudo em MAIÚSCULA!!