...appliqué au squelette Sarka v1.1.1 (deux captures d’écrans ci-dessous).

Avant-propos

En essayant un certain nombre de squelettes, je me suis dit qu’il serait utile d’avoir la possibilité de les paramétrer.

Il ne s’agit évidemment pas de réécrire du code mais par exemple de :

• choisir des couleurs
• choisir d’afficher la liste des rubriques en haut, en bas, ... ou pas du tout
• choisir le nombre d’articles récents à afficher
• ...

C’est bien décrit dans l’introduction de cet article :

Le principe est simple, pour pouvoir distribuer des squelettes, il faut pouvoir configurer certaines petites choses : le numéro de la rubrique qui sert aux galeries, le nom du mot clef qui cache les articles, la couleur de fond du CSS, etc...

L’idéal pour cela serait de fournir à l’administrateur une page de configuration dans l’espace privée dans laquelle il puisse faire tous ces choix. Au lieu de l’obliger à aller modifier la structure de son site ou les fichiers du squelette.

Principe général

Chaque concepteur de squelette peut prévoir une page de configuration. Cette page permet de :

1. modifier des variables globales utilisées dans le squelette (rubrique particulière, mot-clé ou groupe de mots-clés, nombre d’articles récents à afficher, ...) ;
2. modifier les styles du squelette (couleurs, épaisseurs, tailles, espacements, "paddings", ...) ;
3. sauvegarder les paramètres ainsi définis.

Les variables globales du squelette sont rangées dans un fichier dans le répertoire du squelette [1]. Ce fichier porte toujours le même nom afin de permettre son chargement dans la partie Spip hors du squelette.

Si c’est un paramètre de style, on peut imaginer de régénérer la feuille de style à la volée mais une fois pour toute dans l’arborescence du squelette.

Du côté de Spip, on a :

1. un onglet de plus qui apparaît dans la configuration lorsque le fichier de configuration du squelette existe ;
2. un canevas identique pour toutes les configurations de squelette afin :
   • d’assurer une présentation commune ;
   • de charger toutes fonctions utiles ;
   • de simplifier le fichier de configuration du squelette ;
   • de charger une page dans le répertoire “ecrire” (je n’ai pas réussi à faire marcher la page de configuration dans le répertoire du squelette).

Description

Concernant le squelette

Usage de la configuration

“(dossier_squelettes)/variables_globales_squelette.php” est le fichier qui définit les paramètres du squelette. Si il existe, il est chargé par “ecrire/mes_options.php”.

Exemple de contenu de “ecrire/mes_options.php” :

Ces paramètres sont de ce fait disponibles partout, notamment dans le squelette. On y accède, soit, en PHP par $GLOBALS['sarka']['nombre_articles_recents'], soit, par une nouvelle balise #SKELVAR [2] à ajouter dans “(dossier_squelettes)/mes_fonctions.php” [3] :

Je ne comprends pas tout des balises mais il faut remarquer le terme ’sarka’ qui apparaît deux fois et permet d’aller chercher la bonne table.

Modification de la configuration

“(dossier_squelettes)/subconfig-squelette.php” permet à un administrateur du site de modifier interactivement la configuration du squelette.

“(dossier_squelettes)/appliquer_modifs_config-squelette.php” assure la modification des fichiers nécessaires à la prise en compte des changements de paramètres :

• “(dossier_squelettes)/variables_globales_squelette.php”
• “(dossier_squelettes)/(les styles).css”
• ...

Concernant Spip

On modifie “ecrire/inc_presentation.php” pour insérer un nouvel onglet dans la page de configuration. Cet insertion se fait à la condition qu’il existe un fichier “(dossier_squelettes)/subconfig-squelette.php” (deux nouvelles lignes après l’“onglet_interactivite”) :
[...]

[...]

C’est la seule modification au code de SPIP existant.

L’onglet ajouté ci-dessus appelle une page canevas, “ecrire/config-squelette.php”, qui elle-même insérera la page de configuration du squelette “(dossier_squelettes)/subconfig-squelette.php”. Ce canevas est du même type que ceux des autres pages de configuration [4].

En cas de modification des variables, ce canevas appelle “(dossier_squelettes)/appliquer_modifs_config-squelette.php” si il existe.

Installation

Attention : j’utilise les versions avec les suffixes “.php” ci-après.

1. Installer Spip 1.8.2 e php
   • unzip -aX SPIP-v1-8-2-e-php.zip (<— les commandes que j’ai faites sous Linux)
   • mv -i SPIP-v1-8-2-e spip-test
   • (finir l’installation de Spip : machine, user, pass, base, ...)
   • cd spip-test
2. Installer le squelette Sarka v1.1.1 php
   • unzip -aX squelette_sarka-spip-1.1.1-php.zip
   • mv -i squelette_sarka-spip-1.1.1/* .
   • rmdir squelette_sarka-spip-1.1.1
3. Installer mon patch
   • tar xpvzf SPIP182e-patch-config-squelette.tar.gz

C’est tout... et ça marche !

Il ne reste plus qu’à (Yaqua :-)) étendre le module pour le squelette Sarka ou à l’écrire pour votre squelette.

Reste à faire

• Séparer complètement ce qui est la modification de Spip et celle du squelette Sarka
• Déplacer le fichier “ecrire/lang/subconfskel_fr.php” dans le répertoire du squelette
  idée : avoir un fichier “ecrire/lang/subconfskel_fr.php” chargeant “(dossier_squelettes)/lang/subconfskel_fr.php” si il existe.

SPIP182e-patch config-squelette.tar.gz

C’est un Tar Linux Gzippé. Il devrait être reconnu par WinZip et consorts.

Ci-joint les fichiers suivants :

1. “ecrire/config-squelette.php”
   canevas général de la page de configuration du squelette
2. “ecrire/inc_presentation.php”
   ajout de l’onglet de configuration du squelette
3. “ecrire/lang/confskel_fr.php”
   les messages utilisés dans “ecrire/config-squelette.php”
4. “ecrire/lang/subconfskel_fr.php”
   les messages utilisés dans “squelette-sarka-spip/subconfig-squelette.php”
5. “ecrire/mes_options.php”
   définition du répertoire du squelette utilisé et chargement ses variables globales
6. “squelette-sarka-spip/appliquer_modifs_config-squelette.php”
   comme son nom l’indique (première version fonctionnelle, non complète bien sûr)
7. “squelette-sarka-spip/styles/impression.css”
   un style pour l’impression d’article [5].
8. “squelette-sarka-spip/article.html”
   la page qui l’utilise
9. “squelette-sarka-spip/mes_fonctions.php”
   le fichier qui définit la nouvelle balise
10. “squelette-sarka-spip/subconfig-squelette.php”
    le paramétrage du squelette Sarka (très rudimentaire : deux variables pour l’instant)
11. “squelette-sarka-spip/variables_globales_squelette.php”
    paramètre(s) Sarka (que j’ai ajouté)
12. “squelette-sarka-spip/sommaire.html”
    la page qui utilise ces nouveaux paramètres.