SPIP-Contrib

SPIP-Contrib

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

289 Plugins, 197 contribs sur SPIP-Zone, 120 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

  • Formidable, le générateur de formulaires

    23 janvier 2012 – 2446 commentaires

    Un générateur de formulaires facilement configurable pour les non-informaticiens et facilement extensible pour les développeurs. Introduction L’objectif était de créer un plugin permettant de générer des formulaires. Historiquement, 2 plugins (...)

  • ORR v2

    21 mai 2013 – 106 commentaires

    ORR, le plugin d’Organisation des Réservations et des Ressources passe en version 2, avec quelques nouveautés attendues. Je ne reprendrai pas les explications données dans la version 1. Les nouveautés : 1. Gestion des autorisations Le principe (...)

  • Visualiser un PDF dans un article

    13 juin – commentaires

    SoyezCréateurs utilise un modèle pour afficher un PDF dans le corps d’un article Un peu d’histoire Avant, les navigateurs n’incluaient pas de lecteur PDF nativement ce qui avait conduit à la création du plugin Lecteur pdf javascript pdf.js. Mais, (...)

  • Aveline v2

    9 novembre 2012 – 97 commentaires

    Aveline est une collection de noisettes hautement paramétrables, compatibles avec les thèmes Z et à inclure dans vos pages avec le noiZetier. Compatibilité Cette version 2 du plugin Aveline s’utilise, sous SPIP 3, avec la version 2 du noizetier, (...)

  • Speedsyndic pour SPIP 2 et SPIP 3

    11 octobre 2010 – 32 commentaires

    Ce plugin est une version compatible spip 2.0.x / 2.1 / 3.1 du plugin Speedsyndic Note : Une bonne partie du texte ci-dessous a été pompé de cet article, expliquant la version précédente du plugin. je n’ai fait qu’adapter le code pour spip 2, ajouter (...)