Table of Contents

Préface

I. Pour commencer

1. Qu'est-ce que Smarty ?

2. Installation

Ce dont vous avez besoin

Installation de base

Configuration avancée

II. Smarty pour les graphistes

3. Bases syntaxiques

Commentaires

Variables

Fonctions

Paramètres

Variables insérées dans des chaînes de caractères

Opérations mathématiques

Désactiver l'analyse de Smarty

4. Variables

Variables assignées depuis PHP

Tableaux associatifs

Tableaux indexés

Objets

Variables chargées depuis des fichiers de configuration

Variable réservée {$smarty}

Variables de requête

{$smarty.now}

{$smarty.const}

{$smarty.capture}

{$smarty.config}

{$smarty.section}, {$smarty.foreach}

{$smarty.template}

{$smarty.version}

{$smarty.ldelim}, {$smarty.rdelim}

5. Modificateurs de variables

capitalize

cat

count_characters

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. Combiner des modificateurs de variable.

7. Fonctions natives

{capture}

{config_load}

{foreach},{foreachelse}

.index

.iteration

.first

.last

.show

.total

{if},{elseif},{else}

{include}

{include_php}

{insert}

{ldelim},{rdelim}

{literal}

{php}

{section},{sectionelse}

.index

.index_prev

.index_next

.iteration

.first

.last

.rownum

.loop

.show

.total

{strip}

8. Fonctions utilisateur

{assign}

{counter}

{cycle}

{debug}

{eval}

{fetch}

{html_checkboxes}

{html_image}

{html_options}

{html_radios}

{html_select_date}

{html_select_time}

{html_table}

{mailto}

{math}

{popup}

{popup_init}

{textformat}

9. Fichiers de configuration

10. Console de débogage

III. Smarty pour les programmeurs

11. Constantes

SMARTY_DIR

SMARTY_CORE_DIR

12. Variables

$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éthodes

append() — Ajoute un élément à un tableau assigné

append_by_ref() — Ajoute des valeurs par référence

assign() — Assigne des valeurs au template

assign_by_ref() — Assigne des valeurs par référence

clear_all_assign() — Efface les valeurs de toutes les variables assignées

clear_all_cache() — Efface les fichiers de cache des templates

clear_assign() — Efface la valeur d'une variable assignée

clear_cache() — Efface le cache d'un template spécifique

clear_compiled_tpl() — Efface la version compilée d'un template spécifié

clear_config() — Efface toutes les variables de configuration assignées

config_load() — Charge les données d'un fichier de configuration et les assigne au template

display() — Affiche le template

fetch() — Retourne le résultat du template

get_config_vars() — Retourne la valeur de la variable de configuration passée en paramètre

get_registered_object() — Retourne la référence d'un objet enregistré

get_template_vars() — Retourne la valeur assignée passée en paramètre

is_cached() — Retourne TRUE s'il y a un fichier de cache valide pour ce template

load_filter() — Charge un plugin de filtrage

register_block() — Déclare dynamiquement des plugins de fonction de blocs

register_compiler_function() — Déclare dynamiquement un plugin de fonction de compilation

register_function() — Déclare dynamiquement des plugins de fonction de templates

register_modifier() — Déclare dynamiquement un plugin de modificateur

register_object() — Enregistre un objet à utiliser dans un template

register_outputfilter() — Déclare dynamiquement des filtres de sortie

register_postfilter() — Déclare dynamiquement des filtres de post-compilation

register_prefilter() — Déclare dynamiquement des filtres de pré-compilation

register_resource() — Déclare dynamiquement une ressource plugin

trigger_error() — Affiche un message d'erreur

template_exists() — Vérifie si un template spécifique existe

unregister_block() — Désalloue dynamiquement un plugin de fonction de blocs

unregister_compiler_function() — Désalloue dynamiquement une fonction de compilation

unregister_function() — Désalloue dynamiquement un plugin de fonction de templates

unregister_modifier() — Désalloue dynamiquement un plugin modificateur de variable

unregister_object() — Désalloue dynamiquement un objet

unregister_outputfilter() — Désalloue dynamiquement un filtre de sortie

unregister_postfilter() — Désallouer dynamiquement un filtre de post-compilation

unregister_prefilter() — Désalloue dynamiquement un filtre de pré-compilation

unregister_resource() — Désalloue dynamiquement un plugin ressource

14. Cache

Paramétrer le cache

Caches multiples pour une seule page

Groupes de fichiers de cache

Contrôler la mise en cache des sorties des Plugins

15. Fonctionnalités avancées

Objets

Filtres de pré-compilation

Filtres de post-compilation

Filtres de sortie

Fonction de gestion du cache

Ressources

Templates depuis $template_dir

Templates à partir de n'importe quel répertoire

Templates depuis d'autres sources

Fonction de gestion de template par défaut

16. Etendre Smarty avec des plugins

Comment fonctionnent les plugins

Conventions de nommage

Ecrire des plugins

Les fonctions de templates

Modificateurs

Fonctions de blocs

Fonctions de compilation

filtres de pré-compilation/filtres de post-compilation

Filtres de sortie

Ressources

Insertions

IV. Appendices

17. Diagnostic des erreurs

Erreurs Smarty/PHP

18. Trucs et astuces

Gestion des variables non-assignées

Gestion des variables par défaut

Passage du titre à un template d'en-tête

Dates

WAP/WML

Templates composants

Dissimuler les adresses email

19. Ressources

20. BUGS