ajouter_onglets

Ce pipeline permet d’ajouter des onglets dans les pages exec de l’espace privé. Il n’a plus vraiment d’utilité depuis la création du tag <onglet> dans le fichier plugin.xml (voir Définir des onglets).

  1. return pipeline('ajouter_onglets', array('data'=>$onglets,'args'=>$script));

Le pipeline « ajouter_onglets » reçoit un tableau associatif « identifiant de l’onglet / description de l’onglet » (classe PHP Bouton), mais aussi un identifiant de barre d’onglet (dans args).

  1. // ajout d'un onglet sur la page de configuration de SPIP
  2. function plugin_ajouter_onglets($flux){
  3. if ($flux['args']=='identifiant')
  4. $flux['data']['identifiant_bouton']= new Bouton("mon/image.png", "titre de l'onglet"), 'url');
  5. return $flux;
  6. }

Télécharger

Le troisième paramètre url de la classe Bouton est optionnel. Par défaut ce sera une page « exec » de même nom que l’identifiant donné (ecrire/?exec=identifiant).

Dans les pages exec, une barre d’outil s’appelle avec deux arguments : l’identifiant de la barre désirée et l’identifiant de l’onglet actif :

  1. echo barre_onglets("identifiant barre d'onglet", "identifiant de l'onglet actif");
  2. echo barre_onglets("configuration", "contenu");

Télécharger

Exemple

Le plugin « Agenda » modifie les onglets par défaut du calendrier de SPIP en utilisant ce pipeline :

  1. function agenda_ajouter_onglets($flux) {
  2. if($flux['args']=='calendrier'){
  3. $flux['data']['agenda']= new Bouton(
  4. _DIR_PLUGIN_AGENDA . '/img_pack/agenda-24.png',
  5. _T('agenda:agenda'),
  6. generer_url_ecrire("calendrier","type=semaine"));
  7. $flux['data']['calendrier'] = new Bouton(
  8. 'cal-rv.png',
  9. _T('agenda:activite_editoriale'),
  10. generer_url_ecrire("calendrier", "mode=editorial&type=semaine"));
  11. }
  12. return $flux;
  13. }

Télécharger

Migration vers la nouvelle écriture
Pour migrer cet exemple dans la nouvelle écriture, il faut séparer 2 choses : la déclaration du bouton et l’autorisation de le voir ou non. La déclaration s’écrit dans le fichier plugin.xml :

  1. <onglet id="agenda" parent="calendrier">
  2. <icone>img_pack/agenda-24.png</icone>
  3. <titre>agenda:agenda</titre>
  4. <url>calendrier</url>
  5. <args>type=semaine</args>
  6. </onglet>
  7. <onglet id="calendrier" parent="calendrier">
  8. <icone>cal-rv.png</icone>
  9. <titre>agenda:activite_editoriale</titre>
  10. <url>calendrier</url>
  11. <args>mode=editorial&type=semaine</args>
  12. </onglet>

Télécharger

L’autorisation passe par une fonction spécifique (utiliser le pipeline autoriser pour la définir) :

  1. function autoriser_calendrier_onglet_dist($faire, $type, $id, $qui, $opt) {
  2. return true;
  3. }
  4. function autoriser_agenda_onglet_dist($faire, $type, $id, $qui, $opt) {
  5. return true;
  6. }

Télécharger

Auteur Matthieu Marcillaud Publié le : Mis à jour : 01/02/10

Traductions : English, français