Comment faire un squelette facile à installer...

Préambule

Cet article ne prétend pas fournir un schéma parfait. Vos commentaires nous aideront à l’améliorer, il va donc évoluer grâce à vous, tenez-en compte à la lecture ;-)

la balise #DOSSIER_SQUELETTE

La balise #DOSSIER_SQUELETTE est une nouveauté de spip 1.8.2 (cf. « SPIP 1.8.2 » sur spip.net).

Dans les squelettes spip, les liens vers la feuille de style ou les images doivent être définis depuis la racine du site, ce qui obligeait jusqu’a présent à mettre le nom du répertoire du squelette « en dur » dans le code html, par exemple un appel à la feuille de style mes_styles.css placée dans le répertoire mon_squelette/css se faisait de la façon suivante :
<link href="mon_squelette/css/mes_style.css"... />

La balise #DOSSIER_SQUELETTE sert à remplacer cette écriture du nom de dossier afin de rendre les squelettes faciles à diffuser, ainsi on écrira maintenant :
<link href="#DOSSIER_SQUELETTE/css/mes_style.css"... />

et le résultat sera le même (voir plus loin comment définir le dossier des squelettes).

Pour continuer sur la feuille de style, n’oubliez pas d’indiquer dedans le chemin vers les images éventuellement utilisées (fond de page, puces...) de façon « relative ».

Dans un dossier squelettes ainsi structuré :

mon_squelette
	css
	  mes styles.css
	images
	  fond.png
	article.html
	rubrique.html
	[...autres fichiers...]

On n’aura qu’à écrire dans le fichier mes-styles.css l’appel à l’image de fond de cette façon :

body {
 background-image: url(../images/fond.png);
}

Ainsi, peu importe le nom du dossier squelette, si un fichier squelette peut retrouver le chemin de sa feuille de style (via #DOSSIER_SQUELETTE), la feuille de style, elle, retrouvera toujours son image.

le fichier page.php3

Le fichier « page.php3 », à la racine du site, est un appel de squelette, dont le $fond n’est pas défini ; ce fond peut donc être passé en URL d’appel. Ainsi on peut utiliser ce fichier pour tous les squelettes qui n’ont pas de fichier d’appel en propre (comme « article.php3 » pour les articles, etc.).

Par exemple, au lieu de créer un fichier galerie.php3 à la racine du site spip, on placera le lien suivant dans les fichiers html : page.php3?fond=galerie et on aura le fichier galerie.html bien rangé dans le dossier mon_squelette.

Le système marche également pour tous les fichiers inclus, ainsi <INCLURE(galerie.php3){id_article}> devient <INCLURE(page.php3){fond=galerie}{id_article}> et permet au webmaster de ne pas créer le fichier galerie.php3.

Notez que l’on ne peut pas appeler un $fond qui se trouverait dans un sous-répertoire du dossier de squelettes.

le dossier squelettes

Spip va chercher les squelettes dans le dossier nommé squelettes (attention au s final), s’il ne trouve rien il cherche à la racine du site, puis dans le répertoire dist

On peut également nommer son répertoire de squelettes comme on veut si on le signale à spip dans le fichier mes_fonctions.php3 :

$GLOBALS[ 'dossier_squelettes' ] = "mon_squelette" ;

(cf. l’article de spip.net à ce propos).

Attention !

Comme on peut placer le fichier mes_fonctions.php3 dans le dossier de son squelette, nous vous conseillons plutôt de définir évidement $dossier_squelettes dans ecrire/mes_options.php3. Ainsi, on peut fournir un squelette avec une architecture plate (i.e. un seul niveau de répertoire).

(cf. « Les variables de personnalisation »).

Notre objectif est de mettre tous les fichiers nécessaires au fonctionnement du site dans un même répertoire. Ainsi il sera très facile de partager vos squelettes avec d’autres personnes et d’autres sites.

On y met donc :

• tous les fichiers html des squelettes ;
• les formulaires modifiés ;
• le ou les feuilles de styles ;
• le ou les fichiers javascripts ;
• les images des squelettes ;
• le ou les fichiers de langues persos (cf. « Internationaliser ses squelettes, méthode des fichiers de langues).

Remarque sur les fichiers inclus
Les fichiers inclus dans les squelettes peuvent aussi être dans ce répertoire, ainsi que leur fichier php3 correspondant. La « norme » adopté par de nombreux contributeurs est de nommer leurs fichiers inclus inc-truc, on a ainsi dans le dossier des squelettes les couples inc-truc.php3 et inc-truc.html et ces fichiers sont appelés dans les squelettes via le code : <INCLURE(inc-truc.php3){parametre}>.

On peut également les mettre dans des sous répertoire si on précise le chemin d’accès dans le fichier d’appel php3 (ça complique un peu, mais pour les fanas du rangement autant le préciser) .
Exemple :
Tous mes fichiers inclus sont dans un sous-dossier inclusions, mes php3 sont dans le même dossier et de la forme :

<?php
$fond = "inclusions/nom_du_fichier";
$delais = 24 * 3600;
include ("inc-public.php3");
?>

On peut aussi utiliser le fichier page.php3 évoqué plus haut.

les fichiers fond_fonctions.php3

Il est possible de gérer mes_fonctions.php3 via des squelettes nommés fond_fonctions.php3, ou fond correspond au nom du squelette. Ce fichier contient des filtres spip, comme le fichier mes_options.php3, mais ils ne peuvent être utilisés que par un seul squelette. Par exemple si article_fonctions.php3 existe et se trouve dans le dossier des squelettes, alors il sera appelé pour le squelette article.html.

Cette possibilité peut s’avérer pratique parfois pour des filtres n’étant pas communs à tous les squelettes, et peut, par conséquent, permettre de « distribuer » son squelette sans manipulation du fichier mes_fonctions.php3 par l’utilisateur.

Pensez aux utilisateurs étrangers

Même si on ne développe pas un squelette multilingue, il se peut très bien que des utilisateurs étrangers veuillent installer votre squelette pour un site dans leur langue.

Vous n’avez pas à être expert des langues pour fournir des squelettes pouvant être utilisés dans une autre langue. SPIP fournit une bonne collection de chaînes localisées que vous pouvez utiliser dans votre squelette. Vous en trouverez une liste sur la page ecrire/lang_raccourcis.php3 de votre site.

Ainsi, par exemple, au lieu de mettre « Envoyer un message » en dur dans
votre squelette, vous utiliserez la « chaîne » <:envoyer_message:> et SPIP se chargera de faire la traduction dans la langue du site.

Il faut aussi penser à bien utiliser les filtres de date de SPIP qui garantissent que la date est écrite avec les bonnes conventions selon la langue.

Bilan

Il ne nous reste plus à la racine du site que le fichier mes_fonctions.php3 - si nécessaire - fichier qui contient les filtres et fonctions liées au squelette (ainsi que le nom du dossier contenant les squelettes si besoin).

L’installation se résume alors, pour l’utilisateur :
-  à déposer le répertoire du squelette sur son site via ftp;
-  et mettre à jour le fichier mes_fonctions.php3 si besoin.

Pour aller plus loin : Des variables dans la feuille de style

Le système des squelettes spip ne se limite pas aux fichiers html. On peut créer des squelettes de feuille de style ou de fichiers javascript, pour y utiliser des informations de la base de données. Voyons un exemple avec une feuille de style qui utiliserait des boucles spip :

1. Créer un fichier stylecss.php3 un peu spécial

<?php
$fond = "stylescss";
$delais = 2 * 24 * 3600;
$flag_preserver = true;
@header("Content-type: text/css");
include ("inc-public.php3");
?>

-  Pour une feuille de style on a la ligne : @header("Content-type: text/css");, selon le type de fichier généré vous devez changer cette ligne.

2. Créer un fichier stylecss.html contenant votre feuille de style, on peut maintenant y ajouter des boucles si besoin.

3. Et comme ce fichier se trouve dans le dossier des squelettes, l’appel à cette feuille de style est alors : <link href="#DOSSIER_SQUELETTE/stylecss.php3"... />

N’oubliez pas de commenter vos fichiers !

Et enfin, pour finir une dernière balise peu documentée car toute nouvelle, la balise #REM qui permet de mettre des commentaires dans le squelette, ces commentaires n’apparaissant pas en ligne. Utilisation :

[(#REM) ici mon commentaire expliquant ce que fait ma boucle]

En abuser permet d’aérer son code et aidera les débutants qui voudront personnaliser à leur sauce votre squelette.