Programmer avec SPIP 3.0
Documentation technique sur SPIP 3.0

> > > Utiliser les pipelines

Utiliser les pipelines

Pour utiliser les pipelines de SPIP ou d’un plugin, il faut explicitement déclarer leur utilisation dans le fichier plugin.xml :

  1. <pipeline>
  2. <nom>nom_du_pipeline</nom>
  3. <action>nom de la fonction a charger</action>
  4. <inclure>repertoire/fichier.php</inclure>
  5. </pipeline>

Télécharger

Le paramètre action est optionnel, par défaut, il vaut le même nom que le pipeline. Cette déclaration indique de charger un fichier particulier au moment de l’appel du pipeline (déterminé par inclure) et de charger une fonction prefixPlugin_action(). Notons que le paramètre action est rarement renseigné.

On indique plusieurs pipelines en les listant de la sorte :

  1. <pipeline>
  2. <nom>nom_du_pipeline</nom>
  3. <inclure>repertoire/fichier.php</inclure>
  4. </pipeline>
  5. <pipeline>
  6. <nom>autre nom</nom>
  7. <inclure>repertoire/fichier.php</inclure>
  8. </pipeline>

Télécharger

Exemple

Le pipeline insert_head ajoute du contenu dans le <head> des pages publiques. Le plugin « Messagerie » (ayant « messagerie » comme préfixe) s’en sert pour ajouter des styles CSS :

  1. <pipeline>
  2. <nom>insert_head</nom>
  3. <inclure>messagerie_pipelines.php</inclure>
  4. </pipeline>

Télécharger

Et dans le fichier messagerie_pipelines.php :

  1. function messagerie_insert_head($texte){
  2. $texte .= '<link rel="stylesheet" type="text/css" href="'.find_in_path('habillage/messagerie.css').'" media="all" />'."\n";
  3. return $texte;
  4. }

Télécharger