SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

288 Plugins, 197 contribs sur SPIP-Zone, 227 visiteurs en ce moment

Accueil > Squelettes > Outils pour squelettes > noiZetier > Fonctionnement par défaut du noiZetier

Fonctionnement par défaut du noiZetier

21 juin 2010 – par Joseph

4 votes

Le noiZetier est prévu pour fonctionner nativement avec les squelettes Zpip compatibles. Cette page décrit son fonctionnement avec ces derniers.

Le fonctionnement de l’interface du noiZetier repose sur plusieurs étapes principales :

  • Déterminer les pages et les blocs pouvant recevoir des noisettes.
  • Lister les noisettes disponibles.
  • Insérer les noisettes à la fin de chaque bloc.

Lister les pages et les blocs pouvant recevoir des noisettes

La première étape consiste à déterminer les pages pouvant recevoir une noisette. Par défaut, le noiZetier considère qu’à tout fichier HTML présent dans le sous-répertoire contenu correspond une page pouvant recevoir des noisettes [1]. Les compositions classiques situées dans ce répertoire sont de fait automatiquement détectées par le noiZetier.

Ce répertoire par défaut peut être modifié en ajoutant une constante à un fichier d’options de la manière suivante :

  1. define('_NOIZETIER_REPERTOIRE_PAGES','mon_repertoire/');

Pour améliorer la présentation des pages dans l’interface, les différentes pages peuvent être décrites sous la forme d’un fichier XML de même nom, présent dans le même sous-répertoire et reprenant une structure analogue à celle de la description des compositions (les paramètres en moins [2]). Exemple de description de la page article dans le plugin Aveline :

Concernant les compositions, le noiZetier reprend le nom, la description et l’icône définies directement dans leur XML de configuration.

Enfin, le noiZetier considère que chaque page contient trois blocs : contenu, navigation et extra. Ces blocs par défaut ajoutés à chaque page peuvent être modifiés à l’aide d’un pipeline nommé noizetier_blocs_defaut.

Il est également possible de spécifier, pour une page précise, les blocs de cette page en ajoutant dans le XML de cette page l’élément suivant pour chaque bloc de la page [3] :

  1. <bloc id="sousrepertoire" nom="plugin:chainelange" description="plugin:chainelange" icon="img/fichier.png" />

Le tableau décrivant l’ensemble des pages et des blocs passe au travers d’un pipeline noizetier_lister_pages permettant ainsi à un plugin de modifier ce tableau.

Lister les noisettes disponibles

La liste des noisettes est déterminée à partir du contenu des sous-répertoires noisettes. Le nom des noisettes permet de déterminer sur quelles pages chaque noisette peut être proposée.

Voir Déclarer des noisettes au noiZetier pour plus de détails.

Insérer les noisettes à la fin de chaque bloc

Le noiZetier utilise le pipeline recuperer_fond pour intercepter les appels à un squelette bloc/page.html. Le cas échéant, le noiZetier ajoute à la fin du squelette une inclusion du squelette noizetier-generer-bloc.html qui se charge d’inclure les noisettes proprement dites.

Notes

[1Si Zpip est actif, le squelette contenu/page.html est retiré de la liste des pages, ce fichier n’étant présent que pour assurer une compatibilité pour SPIP 2.0.

[2Voir Compositions 1.

[3Les blocs par défaut ne seront alors pas pris en compte.

Dernière modification de cette page le 21 juin 2010

Retour en haut de la page

Répondre à cet article

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Court-circuit 2

    17 octobre 2011 – 76 commentaires

    Court-circuit 2 permet de rediriger certaines rubriques vers un article particulier. Vous pouvez configurer, dans l’espace privé, les règles de redirection à appliquer. Historique Court-circuit 2 est une évolution de Court-circuit 1, reprenant (...)

  • Créer des squelettes avec Zcore

    14 juillet 2015 – 19 commentaires

    Ou comment bien démarrer avec Zcore. Avec SPIP 3.0 est venu le plugin Zcore développé par un collectif de spipeurs. De plus en plus d’utilisateurs adoptent la mécanique de « Z » pour leurs squelettes. Un premier article a été écris pour expliquer la (...)

  • Envoyer des fichiers avec un formulaire Formidable

    2 janvier – 32 commentaires

    La version 3.0.0 du plugin Formidable permet de créer des formulaires comprenant des envois de fichiers. Cet article regroupe la documentation relative à cette fonctionnalité. Pour une présentation générale de Formidable, voir « Formidable, le (...)

  • Grappes 1.0

    23 novembre 2012 – 27 commentaires

    Présentation et nouveautés Cette version 1.0 du plugin Grappes est un portage pour SPIP 3.x. Le plugin permet de grouper des objets de SPIP dans des grappes. Les objets du core (articles, rubriques, auteurs, etc.) sont pris en charge, ainsi que (...)

  • NoSPAM

    20 novembre 2008 – 277 commentaires

    Un plugin pour limiter le risque de spam dans les forums de SPIP.

Ça spipe par là