Premier contact avec SPIP et ses squelettes : le fichier « sommaire.php3 »

Comme bon nombre de livres, SPIP s’ouvre par le sommaire avec ce fichier clé qui se nomme « sommaire.php3 » et dont voici ci-dessous son contenu :

$fond = "sommaire";
$delais = 2 * 3600;
$flag_preserver = true;
include ("inc-public.php3");

Ces 3 lignes de code contiennent en fait les clés essentielles pour comprendre comment le système des squelettes SPIP fonctionne.

Intéressons nous tout d’abord à la ligne : « $fond = "sommaire"; »

Il faut savoir qu’avec SPIP, à chaque type de page spécifique correspond un squelette.
Le sommaire étant un type de page spécifique, un squelette lui est associé.
Mais « sommaire.php3 » n’est qu’une composante du squelette de la page type « sommaire ».
En fait, comme chez les humains, les squelettes SPIP fonctionnent en couple.
Ainsi, pour s’afficher correctement, ce fichier « .php3 » a besoin de sa moitié.

La ligne « $fond = "sommaire"; » va avoir pour première fonction fondamentale d’indiquer à ce fichier .php3 qui est sa moitié.

Puis, par le biais de la ligne « include ("inc-public.php3"); » notre première moitié de squelette va alors récupérer les informations nécessaires qui vont lui permettre de savoir 3 choses essentielles :

1. sa moitié porte le nom de la variable « $fond »
   (« sommaire » dans le cas présent);
2. sa moitié est le fichier dont l’extension est « .html »;
3. sa moitié se trouve soit :
   
• dans le dossier « CACHE ».
  
• à la racine du site.
  
• dans le dossier nommé « squelettes ».
  
• Si le dossier nommé « squelettes » n’existe pas, elle se trouve alors forcement dans un dossier nommé « dist ».
  

Enfin la ligne « $delais = 2 * 3600; » lui dira de stocker une copie de sa moitié dans sa version « présentable » pour une durée de deux heures dans le dossier « CACHE » après l’avoir affiché.

Remarque : Je vous conseille dès à présent de fixer la variable « $delais » à « 0 » afin de neutralier la fonction de cache lors du développement de votre projet. Cela vous permettra de visualiser directement la manipulation de vos données par la fonction « recharger la page » de votre navigateur Web. Vous déterminerez un délai pour votre cache au moment de la mise en ligne définitive du projet.

La messe est dite !
A travers ces 3 lignes de code, SPIP vous permet de démarrer vos investigations afin de lever le voile sur tous ses secrets.

Ainsi, dans votre SPIP fraîchement installé, la moitié de notre « sommaire.php3 » se nomme « sommaire.html » et se trouve forcément dans… le dossier « dist ».

« dist » pour « distribution ».
Ce dossier, vous l’aurez compris dès que vous l’aurez ouvert, contient l’ensemble des fichiers « .html» utilisé pour les squelettes génériques.

Les fichiers « .php3 » des squelettes doivent, quand à eux, obligatoirement se trouver à la racine du site.

Nous allons pouvoir maintenant découvrir ce que le fichier « sommaire.html » a dans le ventre...

Mr Vertigo