SPIP-Contrib

SPIP-Contrib

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

286 Plugins, 197 contribs sur SPIP-Zone, 349 visiteurs en ce moment

Accueil > Outils pour plugins > Tutoriaux pour Plugins > Mise en oeuvre de la balise #PIPELINE

Mise en oeuvre de la balise #PIPELINE

8 décembre 2007 – par Jacques J. – commentaires

4 votes

Permet, d’insérer du code à-peu-près là où on le souhaite dans un squelette.

La balise #PIPELINE, qui existe depuis plus d’un an est restée plutôt discrète. Elle permet, d’insérer du code à-peu-près là où on le souhaite dans un squelette.

Les pipelines

Tout d’abord il est bon de se remémorer le principe des pipelines. Il a été introduit un système de points d’entrée, aussi appelé « pipeline », permettant de glisser un calcul supplémentaire, ou une information différente à l’endroit désiré dans le code de SPIP.

Le point d’entrée est donc le moyen d’indiquer à SPIP quel est ce calcul et où il entre en ligne de compte [1]

Voir : http://doc.spip.org/@Tuto-Se-servir...

Il existe donc une liste de points d’entrées prédéfinis, mais il peut arriver que l’on ait besoin d’en créer de supplémentaires.

Voir : http://www.spip-blog.net/Balise-PIP...

Un exemple d’implémentation

Je vous présente un exemple d’implémentation d’un nouveau pipeline. Celui-ci permettra d’afficher la boussole de SPIP, cf. http://www.spip-contrib.net

Pour plus d’explications sur la création d’un plugin, cf. : Création d’un plugin

le fichier plugin.xml à créer

  1. <plugin>
  2. <nom>Boussole</nom>
  3. <auteur></auteur>
  4. <version>0.2</version>
  5. <etat>dev</etat>
  6. <description>
  7. Rajoute la boussole Spip dans le code de Spip
  8. </description> <prefix>boussole</prefix>
  9. <pipeline>
  10. <nom>insert_head</nom>
  11. <action>insert_head</action>
  12. <inclure>boussole.php</inclure>
  13. </pipeline>
  14. <pipeline>
  15. <nom>insert_boussole</nom>
  16. <action>insert_boussole</action>
  17. <inclure>boussole.php</inclure>
  18. </pipeline>
  19.  
  20. </plugin>

Télécharger

Il est fait usage ici de deux pipelines :

-  # insert_head : qui permet de rajouter du code entre les balises html <head> et </head> qui ici appellera le fichier css nécessaire.
-  # insert_boussole : ce pipeline est donc créé par ce plugin. Il permettra d’insérer dans le code de SPIP le code permettant d’afficher la boussole.

Dans le fichier boussole.php, on trouvera le code suivant :
function boussole_insert_boussole($flux)

Le nom de la fonction est composé ainsi :
-  boussole, qui est le préfixe du plugin
-  insert_boussole, le nom du nouveau pipeline

Il ne reste maintenant qu’à rajouter l’appel de ce nouveau pipeline dans le code de SPIP à l’endroit où l’on désire. Pour cela il suffit de rajouter #PIPELINE{insert_boussole} insert_boussole étant le nom du nouveau pipeline.

Le plugin : http://spip.jermer.fr/?La-boussole-...

Notes

[1Nota SPIP_Contrib :
-  voir cet article pour plus d’explications SPIP 1.9 - Les Plugins
-  cette liste de pipelines est évolutive aussi regardez dans « inc_version.php » et cherchez $spip_pipeline et vous trouverez une liste à jour.

Dernière modification de cette page le 8 décembre 2007

Retour en haut de la page

Vos commentaires

  • Le 11 décembre 2007 à 17:45, par danou9 En réponse à : Mise en oeuvre de la balise #PIPELINE

    En fait si je comprend, la philosophie est la même que la notion de modèle, mais au lieu d’un modèle, c’est un plugin ...
    Tout dépend des besoins ;
    si un modèle est suffisant, pas besoin d’un plugin pour enserrer quelques chose dans un article par exemple

    • Le 11 décembre 2007 à 18:05, par Jacques J. En réponse à : Mise en oeuvre de la balise #PIPELINE

      Non, il ne s’agit pas ici de comparer modèle et plugin, mais de montrer comment, si le besoin s’en fait sentir, utiliser la possibilité de création d’un nouveau pipeline.

      Un modèle lui, peut s’utiliser en insertion dans un article ou bien appelé depuis un squelette. Je te renvoie à la lecture de spip.net
      -  si tu ne veux plus l’utiliser, il te faudra ou modifier tes (ton) squelettes, ou modifier tes (ton) articles.
      -  l’utilisation de #PIPELINE{ton_pipeline} se gère depuis l’interface de gestion des plugins. (on/off). Une case à cocher/décocher.

      La souplesse de spip est en effet les différentes possibilités qui sont offertes pour effectuer parfois la même action. L’imagination ders utilisateurs fait le reste.

    • Le 13 décembre 2007 à 11:49, par ? En réponse à : Mise en oeuvre de la balise #PIPELINE

      dans le debut de ton article, tu dis bien que tu inserre ta balise Spip dans un article ;
      donc comme je le disais, c’est comme un modele ou une balise simple de spip ou que tu as créé.

      C’est vrai que si tu retire le plugin dans l’administration, on a pas besoin de retoucher au squelette, alors qu’avec un modele il faudra le faire

      Cordialement

    • Le 13 décembre 2007 à 13:25, par Jacques J. En réponse à : Mise en oeuvre de la balise #PIPELINE

      Effectivement il y a une petite confusion de ta part. Je cite « Permet, d’insérer du code à-peu-près là où on le souhaite dans un squelette ».

      Dans un article, un modèle suffirait, sachant quand même qu’un modèle peut bien évidemment se gérer avec un plugin.

      L’utilité d’un tel pipeline est peut-être discutable, mais ce n’est pas l’objet de cet article, qui se veut juste de vulgarisation. La discussion sur ce thème est à faire auprès des créateurs de la balise #PIPELINE

    Répondre à ce message

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

  • Réservation d’événements

    16 mars 2015 – 243 commentaires

    Ce plugin permet d’offrir aux visiteurs de s’inscrire pour un évènement du plugin Agenda et de gérer les réservations enregistrées. Installation Le plugin s’installe comme n’importe quel plugin. il nécessite : Agenda API de vérification (...)

  • Passer un site SPIP sous https://

    23 février – commentaires

    Comment migrer simplement votre site SPIP de http:// vers https:// Le protocole https:// devient de plus en plus courant : C’est mieux pour la vie privée de tous La plupart des grands sites l’a déjà adopté Certains navigateurs commencent à afficher (...)

  • Hébergeurs payants

    24 janvier 2009 – 31 commentaires

    Cet article en encore à réorganiser / scinder en deux selon le type (mutualisé ou pro). À priori, SPIP fonctionnera sur tout hébergeur payant traditionnel (qui propose PHP et MySQL). Merci de ne pas mettre des remarques du genre « l’hébergeur truc (...)

  • Moulinette

    17 juillet 2015 – 35 commentaires

    Un squelette qui monte et qui descend ! Moulinette est un squelette basé sur le thème Grayscale (documentation) pour Bootstrap 3. Le type de site attendu est un site en une seule page : une rubrique avec quelques articles, des titres courts, des (...)

  • CleverMail

    20 janvier 2010 – 632 commentaires

    CleverMail est un plugin permettant d’envoyer des lettres d’informations à des abonnés depuis SPIP. Issu au départ d’un développement libre complètement indépendant de SPIP, il a connu une première version pour SPIP 1.9 avant d’être complètement réécris (...)