diff --git a/docs/fr/programmers/api-functions/api-append-by-ref.xml b/docs/fr/programmers/api-functions/api-append-by-ref.xml
index 16aa5c4d..ec0d72ae 100644
--- a/docs/fr/programmers/api-functions/api-append-by-ref.xml
+++ b/docs/fr/programmers/api-functions/api-append-by-ref.xml
@@ -1,49 +1,44 @@
-
-
- append_by_ref
-
-
- void append_by_ref
- string varname
- mixed var
-
-
- void append_by_ref
- string varname
- mixed var
- boolean merge
-
-
-
- Utilisée pour ajouter des valeurs a un template par référence plut(t que
- par copie. Si vous ajoutez une variable par référence puis changez sa
- valeur, le changement est aussi répercuté sur la valeur assignée.
- Pour les objets, append_by_ref ne fait pas de copie en mémoire de l'objet
- assigné. Voir la documentation PHP pour plus d'informations sur les
- références de variable.
- Si vous passez le troisième paramètre a vrai, la valeur sera fusionnée
- avec le tableau courant plut(t que d'être ajoutée.
-
-
- Note technique
+
+
+
+ append_by_ref
+
+
+
+
+
+ voidappend_by_ref
+ stringvarname
+ mixedvar
+ boolmerge
+
- Le paramètre de fusion respecte les clés des tableaux, ainsi si vous
- fusionnez deux tableaux indexés numériquement, ils pourront s'écraser
- l'un l'autre ou donner des clés qui ne se suivent pas. Cela diffère
- donc de la fonction PHP array_merge() qui supprime les clés numériques
- et les renumérote.
+ Utilisée pour ajouter des valeurs à un template par référence plutôt que
+ par copie. Si vous ajoutez une variable par référence puis changez sa
+ valeur, le changement est aussi répercuté sur la valeur assignée.
+ Pour les objets, append_by_ref ne fait pas de copie en mémoire de l'objet
+ assigné. Voir la documentation PHP pour plus d'informations sur les
+ références de variable.
+ Si vous passez le troisième paramètre à true, la valeur
+ sera fusionnée avec le tableau courant plutôt que d'être ajoutée.
-
-
- append_by_ref
-
+ ¬e.parameter.merge;
+
+ Exemple avec append_by_ref
+
+append_by_ref("Name",$myname);
-$smarty->append_by_ref("Address",$address);
-
-
+$smarty->append_by_ref("Nom",$myname);
+$smarty->append_by_ref("Adresse",$address);
+?>
+]]>
+
+
+
+
-
-
- append
-
-
- void append
- mixed var
-
-
- void append
- string varname
- mixed var
-
-
- void append
- string varname
- mixed var
- boolean merge
-
-
-
- Utilisée pour ajouter un élément a un tableau assigné. Si vous utilisez
- cette fonction avec une chaîne de caractères, elle est convertie en
- tableau auquel on ajoute ensuite l'élément. Vous pouvez explicitement passer
- des paires nom/valeur. Si vous passez le troisième paramètre
- (optionel) a vrai, la valeur sera fusionnée avec le tableau plut(t que
- d'être ajoutée.
-
-
- Note technique
+
+
+
+ append
+
+
+
+
+
+ voidappend
+ mixedvar
+
+
+ voidappend
+ stringvarname
+ mixedvar
+ boolmerge
+
- Le paramètre de fusion respecte les clés des tableaux, ainsi si vous
- fusionnez deux tableaux indexés numériquement, ils pourront s'écraser
- l'un l'autre ou donner des clés qui ne se suivent pas. Cela diffère
- donc de la fonction PHP array_merge() qui supprime les clés numériques
- et les renumérote.
+ Utilisée pour ajouter un élément à un tableau assigné. Si vous utilisez
+ cette fonction avec une chaîne de caractères, elle est convertie en
+ tableau auquel on ajoute ensuite l'élément. Vous pouvez explicitement
+ passer des paires nom/valeur. Si vous passez le troisième paramètre
+ (optionel) à true, la valeur sera fusionnée avec le
+ tableau plutôt que d'être ajoutée.
-
-
- append
-
+ ¬e.parameter.merge;
+
+ Exemple avec append
+
+append("Name","Fred");
-$smarty->append("Address",$address);
+$smarty->append("Nom","Fred");
+$smarty->append("Adresse",$address);
// passe un tableau associatif
-$smarty->append(array("city" => "Lincoln","state" => "Nebraska"));
-
-
+$smarty->append(array("Ville" => "Lincoln","Pays" => "Nebraska"));
+?>
+]]>
+
+
+
+
-
-
- assign_by_ref
-
-
- void assign_by_ref
- string varname
- mixed var
-
-
-
- Utilisée pour assigner des valeurs aux templates par référence plut(t
+
+
+
+ assign_by_ref
+
+
+
+
+
+ voidassign_by_ref
+ stringvarname
+ mixedvar
+
+
+ Utilisée pour assigner des valeurs aux templates par référence plutôt
que par copie. Référez-vous au manuel PHP pour une explication plus précise
sur les références des variables.
@@ -26,13 +29,19 @@
- assign_by_ref
-
+ Exemple avec assign_by_ref
+
+assign_by_ref("Name",$myname);
-$smarty->assign_by_ref("Address",$address);
-
-
+$smarty->assign_by_ref("Nom",$myname);
+$smarty->assign_by_ref("Adresse",$address);
+?>
+]]>
+
+
+
+
-
-
- assign
-
-
- void assign
- mixed var
-
-
- void assign
- string varname
- mixed var
-
-
-
- Utilisée pour assigner des valeurs aux templates. Vous pouvez
- explicitement passer des paires nom/valeur, ou des tableaux
- associatifs contenant des paires nom/valeur.
-
-
- assign
-
+
+
+
+ assign
+
+
+
+
+
+ voidassign
+ mixedvar
+
+
+ voidassign
+ stringvarname
+ mixedvar
+
+
+ Utilisée pour assigner des valeurs aux templates. Vous pouvez
+ explicitement passer des paires nom/valeur, ou des tableaux
+ associatifs contenant des paires nom/valeur.
+
+
+ Exemple avec assign
+
+assign("Name","Fred");
-$smarty->assign("Address",$address);
+$smarty->assign("Nom","Fred");
+$smarty->assign("Adresse",$address);
// passe un tableau associatif
-$smarty->assign(array("city" => "Lincoln","state" => "Nebraska"));
-
-
+$smarty->assign(array("Ville" => "Lincoln","Pays" => "Nebraska"));
+?>
+]]>
+
+
+
+
-
-
- clear_all_assign
-
-
- void clear_all_assign
-
-
-
-
- Utilisée pour effacer les valeurs de toutes les variables assignées.
-
-
- clear_all_assign
-
+
+
+
+ clear_all_assign
+
+
+
+
+
+ voidclear_all_assign
+
+
+
+ Utilisée pour effacer les valeurs de toutes les variables assignées.
+
+
+ Exemple avec clear_all_assign
+
+clear_all_assign();
-
-
+$smarty->clear_all_assign();
+?>
+]]>
+
+
+
+
-
-
- clear_all_cache
-
-
- void clear_all_cache
- int expire time
-
-
-
- Utilisée pour effacer les fichiers de cache des templates. Vous pouvez passer un
- paramètre optionnel afin d'indiquer l'Gge minimun que doivent avoir
- les fichiers de cache pour qu'ils soient effacés.
-
-
- clear_all_cache
-
+
+
+
+ clear_all_cache
+
+
+
+
+
+ voidclear_all_cache
+ intexpire_time
+
+
+ Utilisée pour effacer les fichiers de cache des templates. Vous pouvez passer un
+ paramètre optionnel afin d'indiquer l'âge minimun que doivent avoir
+ les fichiers de cache pour qu'ils soient effacés.
+
+
+ Exemple avec clear_all_cache
+
+clear_all_cache();
-
-
+$smarty->clear_all_cache();
+?>
+]]>
+
+
+
+
-
-
- clear_assign
-
-
- void clear_assign
- string var
-
-
-
- Efface la valeur d'une variable assignée. Il peut s'agir
- d'une simple valeur ou d'un tableau de valeur.
-
-
- clear_assign
-
+
+
+
+ clear_assign
+
+
+
+
+
+ voidclear_assign
+ mixedvar
+
+
+ Efface la valeur d'une variable assignée. Il peut s'agir
+ d'une simple valeur ou d'un tableau de valeur.
+
+
+ Exemple avec clear_assign
+
+clear_assign("Name");
// efface plusieurs variables
-$smarty->clear_assign(array("Name","Address","Zip"));
-
-
+$smarty->clear_assign(array("Name","Address","Zip"));
+?>
+]]>
+
+
+
+
-
-
- clear_cache
-
- voidclear_cache
- stringtemplate
- stringcache id
- stringcompile id
- intexpire time
-
-
- Utilisée pour nettoyer le(s) fichier(s) de cache d'un template en particulier.
- Si vous avez plusieurs fichiers de cache pour ce template vous
- pouvez en spécifier un en particulier en passant son identifiant
- en deuxième paramètre. Vous pouvez aussi passer un identifiant
- de compilation en troisième paramètre. Vous pouvez grouper des
- templates ensemble afin qu'ils puissent être supprimés en groupe.
- Référez-vous a la section sur le
- cache
- pour plus d'informations. Vous pouvez passer un quatrième paramètre
- pour indiquer un Gge minimum en secondes que le fichier en cache doit
- avoir avant d'être effacé.
+
+
+
+ clear_cache
+
+
+
+
+
+ voidclear_cache
+ stringtemplate
+ stringcache_id
+ stringcompile_id
+ intexpire_time
+
+
+ Utilisée pour nettoyer le(s) fichier(s) de cache d'un
+ template en particulier.
+ Si vous avez plusieurs fichiers de cache pour ce template, vous
+ pouvez en spécifier un en particulier en passant son identifiant
+ cache_id en deuxième paramètre.
+ Vous pouvez aussi passer un identifiant de compilation
+ compile_id en troisième paramètre.
+ Vous pouvez grouper des templates ensemble afin qu'ils puissent
+ être supprimés en groupe. Référez-vous a la section sur le
+ cache pour plus d'informations.
+ Vous pouvez passer un quatrième paramètre pour indiquer un âge
+ minimum en secondes que le fichier en cache doit avoir avant d'être effacé.
- clear_cache
-
+ Exemple avec clear_cache
+
+clear_cache("index.tpl");
-// efface un fichier de cache grGce a son identifiant de cache
-$smarty->clear_cache("index.tpl","CACHEID");
+// efface un fichier de cache grâce à son identifiant de cache
+$smarty->clear_cache("index.tpl","CACHEID");
+?>
+]]>
+
-
+
+
-
-
- clear_compiled_tpl
-
-
- void clear_compiled_tpl
- string tpl_file
-
-
-
- Utilisée pour effacer la version compilée du template spécifié ou
- de tous les templates si aucun n'est spécifié. Cette fonction
- est destinée a un usage avancé et n'est pas habituellement utilisée.
-
-
- clear_compiled_tpl
-
+
+
+
+ clear_compiled_tpl
+
+
+
+
+
+ voidclear_compiled_tpl
+ stringtpl_file
+ stringcompile_id
+ intexp_time
+
+
+ Utilisée pour effacer la version compilée du template spécifié ou
+ de tous les templates si aucun n'est spécifié.
+ Si vous passez uniquement un compile_id, le template compilé
+ correspondant à ce compile_id sera effacé. Si vous passez un
+ exp_time, les templates compilés plus vieux que exp_time secondes
+ seront effacés, par défaut, tous les templates compilés seront
+ effacés au vû de leurs âges. Cette fonction est destinée à un usage
+ avancé et n'est habituellement pas utilisée.
+
+
+ Exemple avec clear_compiled_tpl
+
+clear_compiled_tpl("index.tpl");
// efface tout le contenu du répertoire des templates compilés
-$smarty->clear_compiled_tpl();
-
-
+$smarty->clear_compiled_tpl();
+?>
+]]>
+
+
+
+
-
-
- clear_config
-
- voidclear_config
- stringvar
-
-
- Utilisée pour effacer toutes les variables de configuration s'étant
- vues assigner une valeur. Si une variable est spécifiée, seule cette
- variable est effacée.
-
-
- clear_config
-
+
+
+
+ clear_config
+
+
+
+
+
+ voidclear_config
+ stringvar
+
+
+ Utilisée pour effacer toutes les variables de configuration assignées.
+ Si un nom de variable est spécifié, seule cette variable sera effacée.
+
+
+ Exemple avec clear_config
+
+clear_config();
// efface une seule variable
-$smarty->clear_config('foobar');
-
-
+$smarty->clear_config('foobar');
+?>
+]]>
+
+
+
+
-
-
- config_load
-
- voidconfig_load
- stringfile
- stringsection
-
-
- Utilisée pour charger des données d'un fichier de config et les
- assigner a un template. Cette fonction fonctionne exactement comme
- la fonction de template config_load.
-
-
- Note technique
+
+
+
+ config_load
+
+
+
+
+
+ voidconfig_load
+ stringfile
+ stringsection
+
- Comme pour Smarty 2.4.0, les variables de templates assignées
- sont conservées entre chaque appel a fetch et display.
- Les variables de configuration chargées avec config_load sont
- globales. Les fichiers de config sont aussi compilés pour une
- exécution plus rapide et respecte les réglages de force_compile et de compile_check.
+ Utilisée pour charger des données d'un fichier file
+ de configuration et les assigner a un template. Cette fonction fonctionne
+ exactement comme la fonction de template config_load.
-
-
- config_load
-
+
+ Note technique
+
+ Comme pour Smarty 2.4.0, les variables de templates assignées
+ sont conservées entre chaque appel à fetch() et display().
+ Les variables de configuration chargées avec config_load() sont
+ globales. Les fichiers de configuration sont aussi compilés pour une
+ exécution plus rapide et respecte les réglages de force_compile et de compile_check.
+
+
+
+ Exemple avec config_load
+
+config_load('my.conf');
// charge une section
-$smarty->config_load('my.conf','foobar');
-
-
+$smarty->config_load('my.conf','foobar');
+?>
+]]>
+
+
+
+
-
-
- display
-
- voiddisplay
- stringtemplate
- stringcache_id
- stringcompile_id
-
-
- Utilisée pour afficher un template. Il faut fournir un type et un
- chemin de ressource template
- valides. Vous pouvez passer en second paramètre un identifiant
- de fichier de cache. Reportez-vous a la section
- cache pour plus de renseignements.
-
+
+
+
+ display
+
+
+
+
+
+ voiddisplay
+ stringtemplate
+ stringcache_id
+ stringcompile_id
+
- Le troisième paramètre optionnel est un identifiant de compilation.
- Cela s'avère utile quand vous voulez compiler différentes versions
- d'un même template, pour par exemple avoir des templates
- compilés séparés pour différents langages. Une autre utilité de ce
- paramètre est le cas oú vous utilisez plus d'un $template_dir mais un seul
- $compile_dir, car certains templates avec le même nom s'écraseraient
- entre eux. Vous pouvez aussi régler la variable $compile_id une seule
- fois au lieu de la passer a chaque appel.
+ Utilisée pour afficher un template. Il faut fournir un type et un
+ chemin de ressource template
+ valides. Vous pouvez passer en second paramètre un identifiant
+ de fichier de cache. Reportez-vous à la section
+ cache pour plus de renseignements.
+ ¶meter.compileid;
- affichage
-
+ Exemple avec display
+
+caching = true;
-// ne fait un appel a la base de données que si le fichier
+// ne fait un appel à la base de données que si le fichier
// de cache n'existe pas
-if(!$smarty->is_cached("index.tpl"))
-{
+if(!$smarty->is_cached("index.tpl")) {
// quelques données
$address = "245 N 50th";
$db_data = array(
- "City" => "Lincoln",
- "State" => "Nebraska",
- "Zip" = > "68502"
- );
+ "Ville" => "Lincoln",
+ "Pays" => "Nebraska",
+ "Code postal" = > "68502"
+ );
- $smarty->assign("Name","Fred");
- $smarty->assign("Address",$address);
+ $smarty->assign("Nom","Fred");
+ $smarty->assign("Adresse",$address);
$smarty->assign($db_data);
}
// display the output
-$smarty->display("index.tpl");
+$smarty->display("index.tpl");
+?>
+]]>
+
Utilisez la syntaxe des ressources templates
pour afficher des fichiers en-dehors du répertoire
- $template_dir
+ $template_dir.
-
- exemples de fonction d'affichage de ressources templates
-
+ Exemples de fonction d'affichage de ressources templates
+
+display("/usr/local/include/templates/header.tpl");
-// chemin absolu (pareil)
+// chemin absolu (mêm chose)
$smarty->display("file:/usr/local/include/templates/header.tpl");
// chemin absolu Windows (on DOIT utiliser le préfixe "file:")
$smarty->display("file:C:/www/pub/templates/header.tpl");
-// inclue a partir de la ressource template "db"
-$smarty->display("db:header.tpl");
+// inclue à partir de la ressource template nommée "db"
+$smarty->display("db:header.tpl");
+?>
+]]>
+
-
-
+
+
-
-
- fetch
-
- stringfetch
- stringtemplate
- stringcache_id
- stringcompile_id
-
-
- Utilisée pour renvoyer le résultat du template plut(t que de l'afficher.
- Il faut passer un type et un chemin de ressource template
- valides. Vous pouvez passer un identifiant de cache en deuxième
- paramètre. Reportez-vous a la section cache
- pour plus de renseignements.
-
-
- Un troisième paramètre optionnel est un identifiant de compilation.
- Cela s'avère utile quand vous voulez compiler différentes versions
- d'un même template, pour par exemple avoir des templates
- compilés séparés pour différents langages. Une autre utilité de ce
- paramètre est le cas oú vous utilisez plus d'un $template_dir
- mais un seul $compile_dir, car certains templates avec le même nom
- s'écraseraient entre eux. Vous pouvez aussi régler la variable $compile_id une seule
- fois plut(t que de la passer a chaque appel.
-
-
- fetch
-
+
+
+
+ fetch
+
+
+
+
+
+ stringfetch
+ stringtemplate
+ stringcache_id
+ stringcompile_id
+
+
+ Utilisée pour renvoyer le résultat du template plutôt que de l'afficher.
+ Il faut passer un type et un chemin de ressource template
+ valides. Vous pouvez passer un identifiant de cache en deuxième
+ paramètre. Reportez-vous à la section cache
+ pour plus de renseignements.
+
+ ¶meter.compileid;
+
+
+ Exemple avec fetch
+
+caching = true;
-// ne fait un appel a la base de données que si le fichier
+// ne fait un appel à la base de données que si le fichier
// de cache n'existe pas
if(!$smarty->is_cached("index.tpl"))
{
@@ -44,13 +42,13 @@ if(!$smarty->is_cached("index.tpl"))
// quelques données
$address = "245 N 50th";
$db_data = array(
- "City" => "Lincoln",
- "State" => "Nebraska",
- "Zip" = > "68502"
- );
+ "Ville" => "Lincoln",
+ "Pays" => "Nebraska",
+ "Code postal" = > "68502"
+ );
- $smarty->assign("Name","Fred");
- $smarty->assign("Address",$address);
+ $smarty->assign("Nom","Fred");
+ $smarty->assign("Adresse",$address);
$smarty->assign($db_data);
}
@@ -60,9 +58,14 @@ $output = $smarty->fetch("index.tpl");
// fait quelque chose avec $output
-echo $output;
-
-
+echo $output;
+?>
+]]>
+
+
+
+
+
-
-
- get_config_vars
-
- arrayget_config_vars
- stringvarname
-
-
- Retourne la valeur de la variable de configuration passée en paramètre.
- Si aucun paramètre n'est donné, un tableau de toutes les variables de
- configuration chargées est renvoyé.
-
-
- get_config_vars
-
+
+
+
+ get_config_vars
+
+
+
+
+
+ arrayget_config_vars
+ stringvarname
+
+
+ Retourne la valeur de la variable de configuration passée en paramètre.
+ Si aucun paramètre n'est donné, un tableau de toutes les variables de
+ configuration chargées est retourné.
+
+
+ Exemple avec get_config_vars
+
+get_config_vars('foo');
@@ -22,9 +29,13 @@ $foo = $smarty->get_config_vars('foo');
$config_vars = $smarty->get_config_vars();
// les affiche a l'écran
-print_r($config_vars);
-
-
+print_r($config_vars);
+?>
+]]>
+
+
+
+
-
-
- get_registered_object
-
-
- array get_registered_object
- string object_name
-
-
-
- Retourne la référence d'un objet enregistré. Utile quand vous
- voulez accéder directement a un objet enregistré avec une
- fonction utilisateur.
-
-
- get_registered_object
-
-function smarty_block_foo($params, &$smarty) {
- if (isset[$params['object']]) {
- // récupère la référence de l'objet enregistré
- $obj_ref =& $smarty->get_registered_object($params['object']);
- // $obj_ref est maintenant une référence vers l'objet
- }
-}
-
-
+
+
+
+ get_registered_object
+
+
+
+
+
+ arrayget_registered_object
+ stringobject_name
+
+
+ Retourne la référence d'un objet enregistré. Utile quand vous
+ voulez accéder directement à un objet enregistré avec une
+ fonction utilisateur.
+
+
+ Exemple avec get_registered_object
+
+get_registered_object($params['object']);
+ // $obj_ref est maintenant une référence vers l'objet
+ }
+}
+?>
+]]>
+
+
+
+
-
-
- get_template_vars
-
- arrayget_template_vars
- stringvarname
-
-
- Retourne la valeur assignée passée en paramètre. Si aucun paramètre
- n'est donné, un tableau de toutes les variables assignées est
- renvoyé.
-
-
- get_template_vars
-
+
+
+
+ get_template_vars
+
+
+
+
+
+ arrayget_template_vars
+ stringvarname
+
+
+ Retourne la valeur assignée passée en paramètre. Si aucun paramètre
+ n'est donné, un tableau de toutes les variables assignées est
+ retourné.
+
+
+ Exemple avec get_template_vars
+
+get_template_vars('foo');
@@ -23,9 +30,13 @@ $foo = $smarty->get_template_vars('foo');
$tpl_vars = $smarty->get_template_vars();
// les affiche a l'écran
-print_r($tpl_vars);
-
-
+print_r($tpl_vars);
+?>
+]]>
+
+
+
+
-
-
- is_cached
-
-
- void is_cached
- string template
- [string cache_id]
-
-
-
- Retourne vrai s'il y a un fichier de cache valide pour ce template.
- Cela fonctionne seulement si caching est a vrai.
-
-
- is_cached
+
+
+
+ is_cached
+
+
+
+
+
+ boolis_cached
+ stringtemplate
+ stringcache_id
+ stringcompile_id
+
+
+ Retourne &true; s'il y a un fichier de cache valide pour ce template.
+ Celà fonctionne seulement si caching est défini à true.
+
+
+ Exemple avec is_cached
display("index.tpl");
?>
]]>
-
+
- Vous pouvez aussi passer en second paramètre un identifiant
- de cache au cas oú vous voudriez plusieurs fichiers de cache
- pour ce template.
+ Vous pouvez aussi passer en second paramètre un identifiant
+ de cache au cas où vous voudriez plusieurs fichiers de cache
+ pour ce template.
Vous pouvez donner un identifiant de compilation en tant que troisième paramètre.
@@ -45,8 +49,8 @@ $smarty->display("index.tpl");
Si vous voulez utiliser un identifiant de compilation sans utilisez d'identifiant de cache,
mettez null pour l'identifiant de cache.
-
- is_cached avec plusieurs templates
+
+ Exemple avec is_cached et plusieurs templates
display("index.tpl", "FrontPage");
?>
]]>
-
+
+
- Note technique
-
- Si is_cached retourne vrai, il charge en fait le cache existant et
- le stocke en interne. Tout appel supplémentaire à display() ou
- fetch() retournera ce contenu stocké en interne
- sans tenter de recharger le fichier en cache. Cela évite des problématiques d'accès concurents,
- lorsqu'un second processus efface le cache entre l'appel de is_cached et l'appel à display dans
- l'un de nos exemples ci-dessus. Cela signifie également que les appels à clear_cache()
- et les changements de paramètres du cache peuvent n'avoir aucun effet alors que is_cached
- à retourné vrai.
-
+ Note technique
+
+ Si is_cached retourne vrai, il charge en fait le cache existant et
+ le stocke en interne. Tout appel supplémentaire à
+ display() ou
+ fetch() retournera ce contenu stocké en interne
+ sans tenter de recharger le fichier en cache. Celà évite des problématiques d'accès concurents,
+ lorsqu'un second processus efface le cache entre l'appel de is_cached et l'appel à display
+ comme dans l'un de nos exemples ci-dessus. Cela signifie également que les appels à
+ clear_cache()
+ et les changements de paramètres du cache peuvent n'avoir aucun effet alors que
+ is_cached a retourné vrai.
+
-
+
+
-
-
- load_filter
-
-
- void load_filter
- string type
- string name
-
-
-
- Cette fonction peut être utilisée pour charger un plugin
- de filtrage. Le premier argument spécifie le type du filtre
- et peut prendre l'une des valeurs suivantes : 'pre', 'post'
- ou 'output'. Le second argument spécifie le nom du plugin
- de filtrage, par exemple 'trim'.
-
-
- Chargement de plugins de filtrage
-
+
+
+
+ load_filter
+
+
+
+
+
+ voidload_filter
+ stringtype
+ stringname
+
+
+ Cette fonction peut être utilisée pour charger un plugin
+ de filtrage. Le premier argument spécifie le type du filtre
+ et peut prendre l'une des valeurs suivantes : 'pre', 'post'
+ ou 'output'. Le second argument spécifie le nom du plugin
+ de filtrage, par exemple 'trim'.
+
+
+ Chargement de plugins de filtrage
+
+load_filter('pre', 'trim'); // charge le filtre 'trim' de type 'pre'
$smarty->load_filter('pre', 'datefooter'); // charge un autre filtre de type 'pre' appelé 'datefooter'
-$smarty->load_filter('output', 'compress'); // charge le filtre 'compress' de type 'output'
-
-
+$smarty->load_filter('output', 'compress'); // charge le filtre 'compress' de type 'output'
+?>
+]]>
+
+
+
+
-
-
- register_block
-
-
- void register_block
- string name
- string impl
-
-
-
- Utilisée pour déclarrer dynamiquement des plugins de fonction
- de blocs. Il faut passer en paramètre le nom de la fonction
- de blocs, suivi du nom de la fonction PHP qui l'implémente.
-
-
- register_block
-
-/* PHP */
+
+
+
+ register_block
+
+
+
+
+
+ voidregister_block
+ stringname
+ mixedimpl
+ boolcacheable
+ mixedcache_attrs
+
+
+ Utilisée pour déclarer dynamiquement des plugins de fonction
+ de blocs. Il faut passer en paramètre le nom de la fonction
+ de blocs, suivi du nom de la fonction PHP qui l'implémente.
+
+
+ La fonction PHP impl peut être soit (a) une
+ chaîne de caractères contenant le nom de la fonction, soit (b) un tableau
+ de la forme array(&$object, $method) où
+ &$object est une référence à un objet et
+ $method est le nom de la méthode, soit (c) un
+ tableau de la forme array(&$class, $method) où
+ $class est le nom de la classe et
+ $method est une méthode de cette classe.
+
+
+ Les paramètre cacheable et
+ cache_attrs peuvent être omis dans la plupart
+ des cas. Voir Contrôler la mise en cache des sorties des Plugins
+ pour plus d'informations concernant cette utilisation.
+
+
+ Exemple avec register_block
+
+register_block("translate", "do_translation");
function do_translation ($params, $content, &$smarty) {
@@ -28,13 +51,23 @@ function do_translation ($params, $content, &$smarty) {
echo $translation;
}
}
-
+?>
+]]>
+
+
+ Le template Smarty :
+
+
+
-
-
+Hello, world!
+{/translate}
+]]>
+
+
+
+
-
-
- register_compiler_function
-
-
- void register_compiler_function
- string name
- string impl
-
-
-
- Utilisée pour déclarer dynamiquement un plugin de fonction
- de compilation. Il faut passer en paramètres le nom de la fonction
- de compilation, suivi par la fonction PHP qui
- l'implémente.
-
-
+
+
+
+ register_compiler_function
+
+
+
+
+
+ boolregister_compiler_function
+ stringname
+ mixedimpl
+ boolcacheable
+
+
+ Utilisée pour déclarer dynamiquement un plugin de fonction
+ de compilation. Il faut passer en paramètres le nom de la fonction
+ de compilation, suivi par la fonction PHP qui
+ l'implémente.
+
+
+ La fonction PHP impl peut être soit (a) une
+ chaîne de caractères contenant le nom de la fonction, soit (b) un tableau
+ de la forme array(&$object, $method) où
+ &$object est une référence à un objet et
+ $method est le nom de la méthode, soit (c) un
+ tableau de la forme array(&$class, $method) où
+ $class est le nom de la classe et
+ $method est une méthode de cette classe.
+
+
+ Le paramètre cacheable peut être omis dans la
+ plupart des cas. Voir Contrôler la mise en cache des sorties des Plugins
+ pour plus d'informations concernant cette utilisation.
+
+
+
-
-
- register_function
-
-
- void register_function
- string name
- string impl
-
-
-
- Utilisée pour déclarer dynamiquement des plugins de fonction
- de templates. Il faut passer en paramètres le nom de la fonction
- de templates, suivi par le nom de la fonction PHP qui l'implémente.
-
-
- register_function
-
+
+
+
+ register_function
+
+
+
+
+
+ voidregister_function
+ stringname
+ mixedimpl
+ boolcacheable
+ mixedcache_attrs
+
+
+ Utilisée pour déclarer dynamiquement des plugins de fonction
+ de templates. Il faut passer en paramètres le nom de la fonction
+ de templates, suivi par le nom de la fonction PHP qui l'implémente.
+
+
+ La fonction PHP impl peut être soit (a) une
+ chaîne de caractères contenant le nom de la fonction, soit (b) un tableau
+ de la forme array(&$object, $method) où
+ &$object est une référence à un objet et
+ $method est le nom de la méthode, soit (c) un
+ tableau de la forme array(&$class, $method) où
+ $class est le nom de la classe et
+ $method est une méthode de cette classe.
+
+
+ Les paramètres cacheable et
+ cache_attrs peut être omis dans la
+ plupart des cas. Voir Contrôler la mise en cache des sorties des Plugins
+ pour plus d'informations concernant cette utilisation.
+
+
+ Exemple avec register_function
+
+register_function("date_now", "print_current_date");
function print_current_date ($params) {
@@ -29,9 +53,13 @@ function print_current_date ($params) {
// vous pouvez maintenant utiliser ceci dans Smarty pour afficher
// la date actuelle : {date_now} ou {date_now format="%Y/%m/%d"}
-// pour la formater
-
-
+// pour la formater
+?>
+]]>
+
+
+
+
-
-
- register_modifier
-
-
- void register_modifier
- string name
- string impl
-
-
-
- Utilisée pour déclarer dynamiquement un plugin de modificateur.
- Il faut passer en paramètre le nom du modificateur de variables,
- suivi de la fonction PHP qui l'implémente.
-
-
- register_modifier
-
+
+
+
+ register_modifier
+
+
+
+
+
+ voidregister_modifier
+ stringname
+ mixedimpl
+
+
+ Utilisée pour déclarer dynamiquement un plugin de modificateur.
+ Il faut passer en paramètre le nom du modificateur de variables,
+ suivi de la fonction PHP qui l'implémente.
+
+
+ La fonction PHP impl peut être soit (a) une
+ chaîne de caractères contenant le nom de la fonction, soit (b) un tableau
+ de la forme array(&$object, $method) où
+ &$object est une référence à un objet et
+ $method est le nom de la méthode, soit (c) un
+ tableau de la forme array(&$class, $method) où
+ $class est le nom de la classe et
+ $method est une méthode de cette classe.
+
+
+ register_modifier
+
+register_modifier("sslash","stripslashes");
-// vous pouvez maintenant utiliser {$var|sslash} pour supprimer les slash des variables
-
-
+// vous pouvez maintenant utiliser {$var|sslash} pour supprimer les slash des variables
+?>
+]]>
+
+
+
+
-
-
- register_object
-
-
- void register_object
- string object_name
- object $object
- array allowed methods/properties
- boolean format
-
-
-
- Utilisée pour enregistrer un objet a utiliser dans un template.
- Reportez-vous a la section
- objet de
+
+
+
+ register_object
+
+
+
+
+
+ voidregister_object
+ stringobject_name
+ objectobject
+ arrayallowed_methods_properties
+ booleanformat
+ arrayblock_methods
+
+
+ Utilisée pour enregistrer un objet à utiliser dans un template.
+ Reportez-vous a la section
+ objet de
ce manuel pour des exemples.
-
+
+
-
-
- register_outputfilter
-
-
- void register_outputfilter
- string function_name
-
-
-
- Utilisée pour déclarer dynamiquement des filtres de sortie, pour
- agir sur la sortie d'un template avant qu'elle ne soit affichée.
- Reportez-vous a la section
- filtres de sortie pour plus d'information sur le sujet.
-
-
+
+
+
+ register_outputfilter
+
+
+
+
+
+ voidregister_outputfilter
+ mixedfunction
+
+
+ Utilisée pour déclarer dynamiquement des filtres de sortie, pour
+ agir sur la sortie d'un template avant qu'il ne soit affiché.
+ Reportez-vous à la section
+ filtres de sortie pour plus d'information sur le sujet.
+
+
+ La fonction PHP function peut être soit (a) une
+ chaîne de caractères contenant le nom de la fonction, soit (b) un tableau
+ de la forme array(&$object, $method) où
+ &$object est une référence à un objet et
+ $method est le nom de la méthode, soit (c) un
+ tableau de la forme array(&$class, $method) où
+ $class est le nom de la classe et
+ $method est une méthode de cette classe.
+
+
+
-
-
- register_postfilter
-
-
- void register_postfilter
- string function_name
-
-
-
- Utilisée pour déclarer dynamiquement des filtres de post-compilation pour y faire
- passer des templates une fois qu'ils ont été compilés. Reportez-vous
- a la section
- filtres de post-compilation de templates
- pour avoir plus de renseignements sur la faton de paramétrer les fonctions
+
+
+
+ register_postfilter
+
+
+
+
+
+ voidregister_postfilter
+ mixedfunction
+
+
+ Utilisée pour déclarer dynamiquement des filtres de post-compilation pour y faire
+ passer des templates une fois qu'ils ont été compilés. Reportez-vous
+ à la section
+ filtres de post-compilation de templates
+ pour avoir plus de renseignements sur la façon de paramétrer les fonctions
de post-compilation.
-
+
+ La fonction PHP function peut être soit (a) une
+ chaîne de caractères contenant le nom de la fonction, soit (b) un tableau
+ de la forme array(&$object, $method) où
+ &$object est une référence à un objet et
+ $method est le nom de la méthode, soit (c) un
+ tableau de la forme array(&$class, $method) où
+ $class est le nom de la classe et
+ $method est une méthode de cette classe.
+
+
+
-
-
- register_prefilter
-
-
- void register_prefilter
- string function_name
-
-
-
- Utilisée pour déclarer dynamiquement des filtres de pré-compilation pour y faire
- passer des templates avant qu'ils ne soient compilés. Reportez-vous
- a la section
- filtres de pré-compilation de templates
- pour avoir plus de renseignements sur la faton de paramétrer les fonctions
+
+
+
+ register_prefilter
+
+
+
+
+
+ voidregister_prefilter
+ mixedfunction
+
+
+ Utilisée pour déclarer dynamiquement des filtres de pré-compilation pour y faire
+ passer des templates avant qu'ils ne soient compilés. Reportez-vous
+ à la section
+ filtres de pré-compilation de templates
+ pour avoir plus de renseignements sur la façon de paramétrer les fonctions
de pré-compilation.
-
+
+ La fonction PHP function peut être soit (a) une
+ chaîne de caractères contenant le nom de la fonction, soit (b) un tableau
+ de la forme array(&$object, $method) où
+ &$object est une référence à un objet et
+ $method est le nom de la méthode, soit (c) un
+ tableau de la forme array(&$class, $method) où
+ $class est le nom de la classe et
+ $method est une méthode de cette classe.
+
+
+
-
-
- register_resource
-
-
- void register_resource
- string name
- array resource_funcs
-
-
-
- Utilisée pour déclarer dynamiquement une ressource plugin
- dans Smarty. Il faut passer en paramètre le nom de la ressource
- et le tableau des fonctions PHP qui l'implémentent. Reportez-vous
- a la section ressources templates
- pour avoir plus d'informations sur la faton de paramétrer une fonction
- récupérant des templates.
-
-
- register_resource
-
+
+
+
+ register_resource
+
+
+
+
+
+ voidregister_resource
+ stringname
+ arrayresource_funcs
+
+
+ Utilisée pour déclarer dynamiquement une ressource plugin
+ dans Smarty. Il faut passer en paramètre le nom de la ressource
+ et le tableau des fonctions PHP qui l'implémentent. Reportez-vous
+ a la section ressources templates
+ pour avoir plus d'informations sur la faton de paramétrer une fonction
+ récupérant des templates.
+
+
+ Note technique
+
+ Un nom de ressource doit être composé d'au moins deux caractères.
+ Les noms de ressources d'un seul caractère seront ignorés et utilisés
+ comme étant une partie du chemin du fichier, comme avec
+ $smarty->display('c:/path/to/index.tpl');
+
+
+
+ Le tableau de fonctions PHP resource_funcs
+ doit être composé de 4 ou 5 éléments. S'il est composé de 4 éléments,
+ les éléments seront les noms de fonctions pour, respectivement,
+ "source", "timestamp", "secure" et "trusted" de la ressource.
+ S'il est composé de 5 éléments, le premier élément devra être une
+ référence sur un objet ou le nom d'une classe de l'objet ou une classe
+ implémentant la ressource et les 4 éléments suivants doivent être
+ les noms des méthodes implémentant "source", "timestamp",
+ "secure" et "trusted".
+
+
+ Exemple avec register_resource
+
+register_resource("db", array("db_get_template",
- "db_get_timestamp",
- "db_get_secure",
- "db_get_trusted"));
-
-
+"db_get_timestamp",
+"db_get_secure",
+ "db_get_trusted"));
+?>
+]]>
+
+
+
+
-
-
- template_exists
-
-
- bool template_exists
- string template
-
-
-
- Cette fonction vérifie si le template spécifié existe. Elle accepte
- soit un chemin vers le template, soit une ressource de type
- chaene de caractères précisant le nom du template.
-
-
+
+
+
+ template_exists
+
+
+
+
+
+ booltemplate_exists
+ stringtemplate
+
+
+ Cette fonction vérifie si le template spécifié existe. Elle accepte
+ soit un chemin vers le template, soit une ressource de type
+ chaîne de caractères spécifiant le nom du template.
+
+
+
-
-
- trigger_error
-
-
- void trigger_error
- string error_msg
- [int level]
-
-
-
- Cette fonction peut-être utilisée pour afficher un message d'erreur
- en utilisant Smarty. Le paramètre level
- peut prendre l'une des valeures utilisées par la fonction PHP
- trigger_error, i.e. E_USER_NOTICE, E_USER_WARNING, etc. Par défaut
- il s'agit de E_USER_WARNING.
-
-
+
+
+
+ trigger_error
+
+
+
+
+
+ voidtrigger_error
+ stringerror_msg
+ intlevel
+
+
+ Cette fonction peut-être utilisée pour afficher un message d'erreur
+ en utilisant Smarty. Le paramètre level
+ peut prendre l'une des valeures utilisées par la fonction PHP
+ trigger_error(), i.e. E_USER_NOTICE, E_USER_WARNING, etc. Par défaut
+ il s'agit de E_USER_WARNING.
+
+
+
-
-
- unregister_block
-
-
- void unregister_block
- string name
-
-
-
- Utilisée pour désallouer dynamiquement un plugin de fonction
- de blocs. Passez en paramètre le nom du bloc.
-
-
+
+
+
+ unregister_block
+
+
+
+
+
+ voidunregister_block
+ stringname
+
+
+ Utilisée pour désallouer dynamiquement un plugin de fonction
+ de blocs. Passez en paramètre le nom name du bloc.
+
+
+
-
-
- unregister_compiler_function
-
-
- void unregister_compiler_function
- string name
-
-
-
- Utilisée pour désallouer dynamiquement un fonction de compilation.
- Passez en paramètre le nom de la fonction de compilation.
-
-
+
+
+
+ unregister_compiler_function
+
+
+
+
+
+ voidunregister_compiler_function
+ stringname
+
+
+ Utilisée pour désallouer dynamiquement un fonction de compilation.
+ Passez en paramètre le nom name de
+ la fonction de compilation.
+
+
+
-
-
- unregister_function
-
-
- void unregister_function
- string name
-
-
-
- Utilisée pour désallouer dynamiquement un plugin de fonction
- de templates. Passez en paramètres le nom de la fonction de templates.
-
-
- unregister_function
-
+
+
+
+ unregister_function
+
+
+
+
+
+ voidunregister_function
+ stringname
+
+
+ Utilisée pour désallouer dynamiquement un plugin de fonction
+ de templates. Passez en paramètres le nom de la fonction de templates.
+
+
+ Exemple avec unregister_function
+
+unregister_function("fetch");
-
-
+$smarty->unregister_function("fetch");
+?>
+]]>
+
+
+
+
-
-
- unregister_modifier
-
-
- void unregister_modifier
- string name
-
-
-
- Utilisée pour désallouer dynamiquement un plugin modificateur de variable.
- Passez en paramètre le nom du modificateur de templates.
-
-
- unregister_modifier
-
+
+
+
+ unregister_modifier
+
+
+
+
+
+ voidunregister_modifier
+ stringname
+
+
+ Utilisée pour désallouer dynamiquement un plugin modificateur de variable.
+ Passez en paramètre le nom du modificateur de templates.
+
+
+ Exemple avec unregister_modifier
+
+unregister_modifier("strip_tags");
-
-
+$smarty->unregister_modifier("strip_tags");
+?>
+]]>
+
+
+
+
-
-
- unregister_object
-
-
- void unregister_object
- string object_name
-
-
-
- Utilisée pour désallouer un objet.
-
-
+
+
+
+ unregister_object
+
+
+
+
+
+ voidunregister_object
+ stringobject_name
+
+
+ Utilisée pour désallouer un objet.
+
+
+
-
-
- unregister_outputfilter
-
-
- void unregister_outputfilter
- string function_name
-
-
-
- Utilisée pour désallouer dynamiquement un filtre de sortie.
-
-
+
+
+
+ unregister_outputfilter
+
+
+
+
+
+ voidunregister_outputfilter
+ stringfunction_name
+
+
+ Utilisée pour désallouer dynamiquement un filtre de sortie.
+
+
+
-
-
- unregister_postfilter
-
-
- void unregister_postfilter
- string function_name
-
-
-
- Utilisée pour désallouer dynamiquement un filtre de post-compilation.
-
-
+
+
+
+ unregister_postfilter
+
+
+
+
+
+ voidunregister_postfilter
+ stringfunction_name
+
+
+ Utilisée pour désallouer dynamiquement un filtre de post-compilation.
+
+
+
-
-
- unregister_prefilter
-
-
- void unregister_prefilter
- string function_name
-
-
-
- Utilisée pour désallouer dynamiquement un filtre de pré-compilation.
-
-
+
+
+
+ unregister_prefilter
+
+
+
+
+
+ voidunregister_prefilter
+ stringfunction_name
+
+
+ Utilisée pour désallouer dynamiquement un filtre de pré-compilation.
+
+
+
-
-
- unregister_resource
-
-
- void unregister_resource
- string name
-
-
-
- Utilisée pour désallouer dynamiquement un plugin ressource.
- Passez en paramètre le nom de la ressource.
-
-
- unregister_resource
-
-$smarty->unregister_resource("db");
-
-
+
+
+
+ unregister_resource
+
+
+
+
+
+ voidunregister_resource
+ stringname
+
+
+ Utilisée pour désallouer dynamiquement un plugin ressource.
+ Passez en paramètre le nom de la ressource.
+
+
+ Exemple avec unregister_resource
+
+unregister_resource("db");
+?>
+]]>
+
+
+
+