Personnalisation avancée

 Pré-requis

• Installer ou mettre à jour SPIP à la version stable la plus récente. Nous recommandons d’essayer d’abord avec l’installation (ou la mise à jour) automatique à l’aide du fichier spip_loader.php.
• Installer ou mettre à jour les squelettes d’ALTERNATIVES à la version la plus récente.

 Avertissement

Le jeu de squelettes d’Alternatives a été conçu pour permettre la mise en place rapide d’un site Web dynamique, communautaire, organisationnel ou institutionnel. Il a également été conçu pour autoriser à la fois la plus grande souplesse possible quant aux personnalisations désirées, mais également une capacité de suivre l’évolution et le développement des nouvelles fonctionnalités apportées au jeu de squelettes, à SPIP ainsi qu’aux nombreux greffons (plugins) développés pour SPIP.

Le jeu de squelettes offre déjà de nombreuses variantes, soit par mot-clé, soit par activation de configurations ou thèmes dans l’espace privé ou encore par l’insertion de raccoucis/modèles dans le texte des articles, rubriques, etc.

La personnalisation avancée dont il est question dans le présent article concerne la modification ou l’ajout de fichiers squelettes.

Pour préserver la capacité d’évolution du présent jeu de squelettes nous recommandons FORTEMENT :

1. de ne PAS modifier AUCUN des fichiers de distribution du présent jeu de squelettes placé dans le dossier des greffons (/plugins/) et dont nous allons détaillé la structure.
2. de bien assimiler les mécanismes standards de surcharge et de chemin d’accès aux fichiers de squelettes utilisé par SPIP.
3. de toujours placer vos modifications et personnalisations du jeu de squelettes, des greffons ajoutés ou même de SPIP, dans le dossier /squelettes/ à la racine de votre installation de SPIP.
4. En conséquence, ne JAMAIS modifier directement les fichiers de la distribution du jeu de squelettes d’Alternatives, des greffons ou de SPIP.

En fait, notre jeu de squelettes n’utilise rien de très sophistiqué, il n’utilise que de la façon la plus optimale possible les fonctionnalités de base de SPIP et des recommandations normatives du Web.

 Structure des dossiers

La distribution complète des squelettes d’ALTERNATIVES comprend les dossiers (ou répertoires) significatifs suivants :

• plugins/
  • alter-perso/ - (les variantes optionelles)
    • _themes/ - (des variantes thématique optionnelles)
      • perso-xx/ - (le thème xx - fichier d’activation : plugin.xml)
      • perso-yy/ - (le thème yy - fichier d’activation : plugin.xml)
      • perso-zz/ - (le thème zz - fichier d’activation : plugin.xml)
      • perso-theme/ - (un gabarit vide de thème - fichier d’activation : plugin.xml)
    • configuration/ - (les configurations optionnelles de base)
      • fluide/ - (configure une mise en page fluide - fichier d’activation : plugin.xml)
      • .../ - (configure ... - fichier d’activation : plugin.xml)
  • alternatives/ - (le squelette complet - fichier d’activation : plugin.xml)
  • .../ - (autres plugins)

 Comment SPIP s’y retourve-t-il

Tout le mécanisme des squelettes d’Alternatives repose sur la méthode utilisée par SPIP pour retrouver le chemin d’accès à un fichier squelette.

Prenons un exemple concret.

Si un squelette article.html se retrouve dans divers dossiers susceptibles de contenir des squelettes, lequel sera priorisé et ultimement utilisé, en lieu et place de tous les autres ?

Le mécanisme standard de SPIP (spip_path) établit ainsi sa recherche : le premier trouvé dans l’ordre suivant, est utilisé.

• dans tout dossier déclaré comme dossier squelettes dans le fichier mes_options.php placé dans le dossier racine /config/ ou /ecrire/. Le présent squelette n’utilise pas ce mécanisme, nous allons donc l’ignorer pour la suite des choses, mais c’est bon à savoir.
• dans le dossier /squelettes/ créé à la racine de SPIP.
• dans un des plugins déclaré et activé du dossier /plugins/. La recherche dans le dossier /plugins/ procède alphabétiquement. Si le fichier est trouvé dans le dossier a, il sera utilisé en priorité sur celui du dossier b.
• et enfin, dans le dossier /dist/.

Dans le cas des squelettes d’Alternatives, SPIP cherchera donc le fichier article.html par ordre de priorité dans les dossiers suivants :

• /squelettes/
• /plugins/alter-perso/_themes/ - (si un des dossier thématique s’y trouvant est activé, un seul theme peut être activé à la fois)
• /plugins/alter-perso/configuration/ - (si une ou plusieurs variantes de configuration sont activées)
• /plugins/alternatives/ - (si activé, évidemment)
• /plugins/ - (autres plugins, si activés)
• /dist/

 Créer vos fichiers de personnalisation

Pour personnaliser les squelettes d’ALTERNATIVES et ses variantes de configuration ou thématiques, il suffit donc de copier l’un quelconque des squelettes d’alternatives ou de ses variantes dans le dossier /squelettes/ à la racine de SPIP, et de le modifier en conséquence. Tout fichier de squelette ainsi créé dans le dossier /squelettes/ sera utilisé en priorité sur tout autre fichier du même nom se trouvant dans le dossier /plugins/. Il est toutefois impératif de respecter l’arborescence des dossiers du squelette /alternatives/. Ainsi, si on veut modifier le pied-de-page, il faut dupliquer le fichier approprié dans /squelettes/inc/inc-bas.html.

Pour modifier les feuilles de styles, vous pouvez créer dans le dossier /squelettes/styles/ une ou plusieurs feuilles de styles portant très exactement les noms suivants : /squelettes/styles/perso.css et y ajouter uniquement les règles et propriétés de styles que vous désirez modifier. Ces règles viendront s’ajouter ou remplacer celles des feuilles de styles utilisées par le jeu de squelettes.

Pour plus de détails sur les feuilles de styles personnalisées, voir : Personnaliser les feuilles de styles

Attention : moins vous dupliquez de fichiers de personnalisation dans le dossier /squelettes/, plus la maintenance sera facilitée lors des prochaines mises à jour du squelette ALTERNATIVES.

Questions et réponses sur le FORUM des utilisateurs