Carnet Wiki

Plugin Switcher (suite)

Version 3 — December 2019 YannX

Reprise et complements de la documentation originelle : Le Switcher de squelettes.

Auteurs

Philippe Drouot, adaptation en plugin de la contrib «switcher» de Fil, distribué sous licence GNU/GPL
Le plugin a été repris par la suite par divers contributeurs qui le maintienne avec amour pour lui apporter des nouvelles fonctionnalités et de rester au goût du jour.

Téléchargement et Installation

-  Télécharger le plugin Switcher sur la Zone [1]- Installation : Comme tous les autres plugins, cf. http://www.spip.net/fr_article3396.html

Fonctionnement

Ce plugin ajoute un formulaire à liste déroulante (en javascript) sur tous les squelettes de la partie publique du site, permettant de basculer entre les squelettes «squelettes-dist dist » (ceux de la distribution standard placés dans le répertoire du même nom), ceux de votre dossier «squelettes», et/ou des dossiers alternatifs spécifiés , et/ou et l’ensemble des squelettes organisés en sous-répertoires d’un autre dossier contenus dans le répertoire ( nommé «squelettes-test» par défaut ), à l’intérieur duquel chaque jeu de squelettes doit être dans un sous-répertoire spécifique.

Remarques :
-  attention au changement de nom de ./dist en ./squelettes-dist
-  le délimiteur originel etait/est encore le ’ , ’,
alors que la Macro documentée utilise déjà le ’ : ’ !
-  il n’y a pas de fonction d’autorisation explicite
-  l’exploration du source montre bien d’autres options, non explicitées dans la documentation (parfois évoquées dans des commentaires?) :

  • SWITCHER_DOSSIERS_SQUELETTES
  • SWITCHER_REPERTOIRE_SQUELETTES_ALTERNATIFS
  • SWITCHER_SQUELETTES (à déclarer optionnellement dans mes_options.php /? plutot dans mes_fonctions.php ??/

Personnalisation

Le plugin propose une page complète de configuration en ligne :

  • sous CFG en SPIP2 ecrire/?exec=cfg&cfg=switcher,
  • sous Config / Plugins en SPIP3 /?exec=configurer_switcher

Personnalisation

On peut alors :

  • indiquer les répertoires alternatifs,
  • les comptes autorisés à voir le sélecteur actif (non disponible sur la version en-ligne v.0.2.Le plugin propose une page complète pour être configurer ecrire/?5 ),
    exec=cfg&cfg=switcher
    , on peut alors :
  • indiquer les répertoires alternatifs ,
    -* les comptes autorisés à voir le selecteur actif ,
    -* rendre public le selecteur pour tout le monde visiteur anonyme compris.
    -  Pour personnaliser le style par défaut du formulaire, allez dans le fichier «switcher_fonctions.php»

Utilisation courante

Une première utilisation bien documentée était(est) visible sur la page demontrant les divers themes disponibles pour Zpip :
tous les thèmes (squelettes, limitées à des fichiers de CSS) sont organisés dans des sous-repertoires d’une meme dossier principal.
L’autre utilisation courante, est de faciliter les tests de validations entr deux jeux de squelettes (lors d’une migration d’apparence du site).

Enfin un utilisateur demandait la création d’une balise #SWITCHER....
Ce qui amènerait aussi à rendre inter-paramétrable le style (et le DIV d’insertion ?)