Smarty - le moteur et compilateur de template PHP
Précédent	Chapitre 7. Fonctions natives	Suivant

{include}

Les balises "{include}" sont utilisées pour inclure des templates à l'intérieur d'autres templates. Toutes les variables disponibles dans le template réalisant l'inclusion sont disponibles dans le template inclus. La balise {include} doit disposer de l'attribut "file", qui contient le chemin de la ressource template.

Vous pouvez spécifier un attribut optionnel 'assign' qui définit une variable de template dans laquelle la sortie de {include} sera stockée plutôt qu'affichée.

Toutes les valeurs des variables assignées sont restaurées lorsque le template inclus est terminé. Ceci signifie que vous pouvez utiliser toutes les variables d'un template inclus dans le template qui l'inclut. Mais les modifications des variables dans le template inclus ne sont pas visibles dans le template qui l'inclut après l'instruction {include}.

Nom attribut	Type	Requis	Defaut	Description
file	chaîne de caractères	Oui	n/a	Le nom du template à inclure
assign	chaîne de caractères	Non	n/a	Le nom de la variable dans laquelle sera assignée la sortie de include
[var ...]	[type de variable]	Non	n/a	Variables à passer au template

Exemple 7-9. fonction {include}

<html>
 <head>
  <title>{$title}</title>
 </head>
 <body>
  {include file='page_header.tpl'}

  {* body of template goes here *}
  {include file='$tpl_name.tpl'} <-- remplace $tpl_name avec la valeur

  {include file='page_footer.tpl'}
 </body>
</html>

Vous pouvez également passer des variables au template inclus sous forme d'attributs. Les variables passées au template par ce moyen ne sont accessibles que dans la portée de ce dernier. Les variables passées en tant qu'attribut remplacent les variables déjà définies, qui auraient le même nom.

Exemple 7-10. fonction {include}, passage de variables

{include file='header.tpl' title='Menu principal' table_bgcolor='#c0c0c0'}

{* Le corps du template vient ici *}

{include file='footer.tpl' logo='http://mon.example.com/logo.gif'}

où header.tpl est :

<table border='1' width='100%' bgcolor='{$table_bgcolor|default:"#0000FF"}'>
 <tr><td>
   <h1>{$title}</h1>
  </td></tr>
</table>

Exemple 7-11. {include} et assignement à une variable

Cet exemple assigne le contenu de nav.tpl à la variable $navbar, qui est alors affichée en haut et en bas de la page.

<body>
 {include file='nav.tpl' assign=navbar}
 {include file='header.tpl' title='Main Menu' table_bgcolor='#c0c0c0'}
 {$navbar}

 {* body of template goes here *}

 {include file='footer.tpl' logo='http://my.example.com/logo.gif'}
 {$navbar}
</body>

Utilisez la syntaxe ressource template pour inclure des fichiers situés en dehors du répertoire $template_dir.

Exemple 7-12. fonction {include}, exemple de ressource template

{* chemin absolu *}
{include file='/usr/local/include/templates/header.tpl'}

{* chemin absolu (même chose) *}
{include file='file:/usr/local/include/templates/header.tpl'}

{* chemin absolu windows (DOIT utiliser le préfixe "file:") *}
{include file='file:C:/www/pub/templates/header.tpl'}

{* inclusion d'une ressource template "db" *}
{include file='db:header.tpl'}

{* inclusion d'un template $variable - eg $module = 'contacts' *}
{include file="$module.tpl"}
{* ne fonctionne pas avec des simples guillemets ie aucun substitution de variables *}
{include file='$module.tpl'}

Voir aussi {include_php}, {php}, les ressources de template et les templates composants.

Précédent	Sommaire	Suivant
{if},{elseif},{else}	Niveau supérieur	{include_php}