{insert}

les balises {insert} fonctionnent à peu près comme les balises include, à l'exception que leur sortie n'est pas placée en cache lorsque le cache est activé. les balises {insert} seront exécutées à chaque appel du template.

supposons que vous avez un template avec un emplacement pour un bandeau publicitaire en haut de page. ce bandeau publicitaire peut contenir toutes sortes de contenus html, images, flash, etc. nous ne pouvons pas placer du contenu statique à cet endroit. nous ne voulons pas non plus que ce contenu fasse partie du cache. arrive alors la balise {insert}. le template connais #emplacement_bandeau# et #id_site# (récupérés depuis un fichier de configuration), et à besoin d'un appel de fonction pour récupérer le contenu du bandeau.

{* exemple de récupération d'un bandeau publicitaire *} {insert name="getbanner" lid=#emplacement_bandeau# sid=#id_site#}

dans cet exemple, nous utilisons le nom getbanner et lui passons les paramètres #emplacement_bandeau# et #id_site#. smarty va rechercher une fonction appelée insert_getbanner () dans votre application php, et lui passer les valeurs #banner_location_id# et #site_id# comme premier paramètre, dans un tableau associatif. tous les noms des fonctions {insert} de votre application doivent être prefixées de "insert_" pour remédier à d'éventuels conflits de nommage. votre fonction insert_getbanner () est supposée traiter les valeurs passées et retourner un résultat. ces résultats sont affichés dans le template en lieu et place de la balise. dans cet exemple, smarty appellera cette fonction insert_getbanner(array("lid" => "12345","sid" => "67890")); et affichera le résultat retourné à la place de la balise {insert}.

si vous donnez une valeur à l'attribut "assign", la sortie de la balise {insert} sera assigné à une variable de template de ce nom au lieu d'être affichée directement. note: assigner la sortie à une variable n'est pas très utile lorsque le cache est activé.

si vous donnez une valeur à l'attribut "script", ce script php sera inclus (une seule fois) avant l'exécution de la fonction {insert}. le cas peut survenir lorsque la fonction {insert} n'existe pas encore, et que le script php chargé de sa définission doit être inclus. le chemin doit être absolu ou relatif à $trusted_dir. lorsque "security" est actif, le script doit être situé dans $trusted_dir.

l'objet smarty est passé comme second argument. de cette façon, vous pouvez utiliser ou modifier des informations sur l'objet smarty, directement depuis votre fonction {insert}.