SPIP-Contrib

SPIP-Contrib

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

290 Plugins, 198 contribs sur SPIP-Zone, 98 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 ?
  • [Se connecter]

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

  • Docker importe vos documents distants

    25 février 2013 – commentaires

    Un plugin qui permet de recopier localement dans le dossier IMG l’ensemble de vos documents distants. SPIP a un mode de documents qui permet d’indexer dans la base des documents en les laissant sur internet. On peut recopier individuellement (...)

  • Créer une Application Twitter pour utiliser dans SPIP

    14 juin 2013 – 19 commentaires

    Depuis le 9 juin 2013, il n’est plus possible d’accéder à l’API Twitter sans authentification. Cela passe par la création d’une Application Twitter qui disposera de ses clés secrètes pour accèder à l’API Twitter. Voici les étapes détaillées de la (...)

  • Formidable, le générateur de formulaires

    23 janvier 2012 – 2508 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 (...)

  • cibloc : mettre en forme le texte d’articles avec des blocs

    9 juillet – 23 commentaires

    Le plugin CIBLOC permet de mettre en forme le texte d’articles avec des blocs. Il offre des blocs, des colonnes, des icônes et des boutons. Les objectifs de ce plugin Le plugin CIBLOC offre des blocs, des colonnes, des icônes et des boutons : (...)

  • Réservations multiples

    4 juillet – commentaires

    Permettre aux utilisateurs d’effectuer de réservations multiples (réserver pour plusieurs personnes à la fois ou réserver un événement plusieurs fois) Dépendances Saisies Réservation d’événements Introduction Il y a deux manières de multiplier les (...)