Smarty Icon

You may use the Smarty logo according to the trademark notice.

Smarty Template Engine Smarty Template Engine

For sponsorship, advertising, news or other inquiries, contact us at:

Sites Using Smarty

Advertisement

Smarty - a ferramenta para compilar templates para PHP

Monte Ohrt <monte at ohrt dot com>

Andrei Zmievski <andrei@php.net>

Fernando Correa da Conceição <fernandoc@php.net>

Marcelo Perreira Fonseca da Silva <marcelo@php.net>

Taniel Franklin <taniel@ig.com.br>

Thomas Gonzalez Miranda <thomasgm@php.net>

2010-09-20


Table of Contents

Prefácio
I. Iniciando
1. O que é o Smarty?
2. Instalação
Requisitos
Instalação Básica
Estendendo a configuração
II. Smarty para Designers de Template
3. Sintaxe Básica
Comentários
Funções
Atributos
Colocando Variáveis em Aspas Duplas
Matemática
Escapando da interpretação do Smarty
4. Variáveis
Variáveis definidas do PHP
Associative arrays
Índices de Matrizes
Objetos
Variáveis carregadas de arquivos de configuração
A variável reservada {$smarty}
Variáveis Request
{$smarty.now}
{$smarty.const}
{$smarty.capture}
{$smarty.config}
{$smarty.section}, {$smarty.foreach}
{$smarty.template}
{$smarty.ldelim}
{$smarty.rdelim}
5. Modificadores de variáveis
capitalize
count_characters
cat
count_paragraphs
count_sentences
count_words
date_format
default
escape
indent
lower
nl2br
regex_replace
replace
spacify
string_format
strip
strip_tags
truncate
upper
wordwrap
6. Combinando Modificadores
7. Funções internas
capture
config_load
foreach,foreachelse
iteration
first
last
show
total
include
include_php
insert
if,elseif,else
ldelim,rdelim
literal
php
section,sectionelse
index
index_prev
index_next
iteration
first
last
rownum
loop
show
total
strip
8. Funções Personalizadas
assign
counter
cycle
debug
eval
fetch
html_checkboxes
html_image
html_options
html_radios
html_select_date
html_select_time
html_table
math
mailto
popup_init
popup
textformat
9. Arquivos de Configuração
10. Debugging Console
III. Smarty para Programadores
11. Constantes
SMARTY_DIR
12. Variáveis
$template_dir
$compile_dir
$config_dir
$plugins_dir
$debugging
$debug_tpl
$debugging_ctrl
$autoload_filters
$compile_check
$force_compile
$caching
$cache_dir
$cache_lifetime
$cache_handler_func
$cache_modified_check
$config_overwrite
$config_booleanize
$config_read_hidden
$config_fix_newlines
$default_template_handler_func
$php_handling
$security
$secure_dir
$security_settings
$trusted_dir
$left_delimiter
$right_delimiter
$compiler_class
$request_vars_order
$request_use_auto_globals
$error_reporting
$compile_id
$use_sub_dirs
$default_modifiers
$default_resource_type
13. Métodos
append
append_by_ref
assign
assign_by_ref
clear_all_assign
clear_all_cache
clear_assign
clear_cache
clear_compiled_tpl
clear_config
config_load
display
fetch
get_config_vars
get_registered_object
get_template_vars
is_cached
load_filter
register_block
register_compiler_function
register_function
register_modifier
register_object
register_outputfilter
register_postfilter
register_prefilter
register_resource
trigger_error
template_exists
unregister_block
unregister_compiler_function
unregister_function
unregister_modifier
unregister_object
unregister_outputfilter
unregister_postfilter
unregister_prefilter
unregister_resource
14. Caching
Configurando Caching
Multiple Caches Per Page
Grupos de Cache
Controlling Cacheability of Plugins' Output
15. Advanced Features
Objetos
Prefilters
Postfilters
Output Filters (Filtros de Saída)
Função Manipuladora de Cache
Recursos (Resources)
Templates partindo do $template_dir
Templates partindo de qualquer diretório
Templates partindo de outras fontes
Função Manipuladora de Template Padrão
16. Extendendo a Smarty com Plugins
Como os Plugins Funcionam
Convenções de Aparência
Escrevendo Plugins
Funções de Template
Modifiers
Block Functions
Funções Compiladoras
Prefiltros/Posfiltros
Filtros de saída
Recursos (Resources)
Inserts
IV. Apêndices
17. Localização de Erros
Erros do Smarty/PHP
18. Dicas & Truques
Manipulação de Variável Vazia
Manipulação do valor padrão de uma Variável
Passando a variável titulo para o template de cabeçalho
Datas
WAP/WML
Templates componentizados
Ofuscando endereços de E-mail
19. Recursos
20. BUGS

List of Examples

2.1. Arquivos da biblioteca do Smarty necessários
2.2. Cria uma instância do Smarty
2.3. Definir a constante SMARTY_DIR manualmente
2.4. Adicionar o diretório da biblioteca para o include_path do PHP
2.5. Defina a constante SMARTY_DIR manualmente
2.6. Exemplo de estrutura de arquivo
2.7. Configurando permissões de arquivos
2.8. Editando /web/www.example.com/smarty/guestbook/templates/index.tpl
2.9. Editando /web/www.example.com/docs/guestbook/index.php
2.10. Editando /php/includes/guestbook/setup.php
2.11. Editando /web/www.example.com/docs/guestbook/index.php
3.1. Comentários
3.2. Sintaxe de funções
3.3. Sintaxe de atributos de funções
3.4. Sintaxe entre aspas
3.5. Exemplos de matemática
3.6. Exemplo de modificar os delimitadores
4.1. Variáveis definidas
4.2. Acessando variáveis de matriz associativa
4.3. Acesando matrizes por seus índices
4.4. Acessando propriedades de objetos
4.5. Variáveis de configuração
4.6. Mostrando váriáveis request
4.7. Usando {$smarty.now}
4.8. Usando {$smarty.const}
5.1. Exemplo de modificador
5.2. capitalize
5.3. count_characters
5.4. cat
5.5. count_paragraphs
5.6. count_sentences
5.7. count_words
5.8. date_format
5.9. date_format conversion specifiers
5.10. default
5.11. escape
5.12. indent
5.13. lower
5.14. nl2br
5.15. regex_replace
5.16. replace
5.17. spacify
5.18. string_format
5.19. strip
5.20. strip_tags
5.21. truncate
5.22. upper
5.23. wordwrap
6.1. combinando modificadores
7.1. capturando conteúdo do template
7.2. Função config_load
7.3. Função config_load com seções
7.4. foreach
7.5. foreach key
7.6. function include
7.7. Função include passando variáveis
7.8. Exemplos de recursos para a função include
7.9. Função include_php
7.10. função insert
7.11. comandos if
7.12. ldelim, rdelim
7.13. Tags literal
7.14. Tags php
7.15. section
7.16. loop de variável section
7.17. Nomes de section
7.18. sections aninhadas
7.19. sections e matrizes associativas
7.20. sectionelse
7.21. propriedade index da section
7.22. propriedade index_prev da section
7.23. propriedade index_next section
7.24. propriedade interation da section
7.25. propriedade first da section
7.26. propriedade last da section
7.27. propriedade rownum da section
7.28. propridade index da section
7.29. atributo show da section
7.30. propriedade total da section
7.31. strip tags
8.1. assign
8.2. counter
8.3. cycle
8.4. eval
8.5. fetch
8.6. html_checkboxes
8.7. html_image
8.8. html_options
8.9. html_radios
8.10. html_select_date
8.11. html_select_date
8.12. html_select_time
8.13. html_table
8.14. math
8.15. mailto
8.16. popup_init
8.17. popup
8.18. textformat
9.1. Exemplo de sintaxe de um arquivo de configuração
11.1. SMARTY_DIR
13.1. append
13.2. append_by_ref
13.3. assign
13.4. assign_by_ref
13.5. clear_all_assign
13.6. clear_all_cache
13.7. clear_assign
13.8. clear_cache
13.9. clear_compiled_tpl
13.10. clear_config
13.11. config_load
13.12. display
13.13. Exemplos de recursos da função display
13.14. fetch
13.15. get_config_vars
13.16. get_registered_object
13.17. get_template_vars
13.18. is_cached
13.19. is_cached with multiple-cache template
13.20. Carregando filtros de plugins
13.21. register_block
13.22. register_function
13.23. register_modifier
13.24. register_resource
13.25. unregister_function
13.26. unregister_modifier
13.27. unregister_resource
14.1. Habilitando Caching
14.2. Configurando cache_lifetime por cache
14.3. Habilitando $compile_check
14.4. Usando is_cached()
14.5. Limpando o cache
14.6. Passando um cache_id para display()
14.7. Passando um cache_id para is_cached()
14.8. Limpando todos os caches para um cache_id em particular
14.9. Grupos de cache_id
14.10. Prevenindo uma saída de plugin de ser cacheada
14.11. Prevenindo uma passagem inteira do template para o cache
15.1. usando um objeto registrado ou atribuído
15.2. Usando um prefilter de template
15.3. usando um postfilter de template
15.4. usando um filtro de saída de template
15.5. exemplo usando MySQL como uma fonte de cache
15.6. Usando templates partindo do $template_dir
15.7. usando templates partindo de qualquer diretório
15.8. usando templates com caminhos de arquivo do windows
15.9. usando recursos customizáveis
15.10. usando a função manipuladora de template padrão
16.1. função de plugin com saída
16.2. função de plugin sem saída
16.3. Plugin modificador simples
16.4. Plugin modificador mais complexo
16.5. função de bloco
16.6. função compiladora simples
16.7. Plugin prefilter
16.8. Plugin postfilter
16.9. output filter plugin
16.10. Plugin resource (recurso)
16.11. Plugin insert
17.1. Erros do Smarty
17.2. Erros de análise do PHP
17.3. Other common errors
18.1. Imprimindo &nbsp; quando uma variável está vazia
18.2. Atribuindo o valor padrão para uma variável de template
18.3. Passando a variável titulo para o template de cabeçalho
18.4. usando date_format
18.5. Convertendo datas de volta ao formato timestamp
18.6. Usando insert para escrever um cabeçalho WML Content-Type
18.7. Template componentizado
18.8. Exemplo de ofuscamento de um Endereço de E-mail