insert_head

Le pipeline insert_head permet d’ajouter des contenus dans la partie <head> d’une page HTML :

  • au moment de l’appel à #INSERT_HEAD si la balise est définie,
  • sinon juste avant la fin du header (avant </head>) si la fonction f_insert_head est définie dans le pipeline affichage_final, par exemple avec ceci dans mes_options.php :
  1. $GLOBALS['spip_pipeline']['affichage_final'] .= '|f_insert_head';

Le pipeline reçoit le contenu à ajouter et retourne donc un contenu :

  1. function prefixPlugin_insert_head($flux){
  2. $flux .= "<!-- un commentaire pour rien ! -->\n";
  3. return $flux;
  4. }

Télécharger

Exemple

Ajouter un appel à une fonction jQuery, ici pour afficher une barre d’outil sur les balises textarea des formulaires de Crayons (avec le plugin Porte Plume) :

  1. function documentation_insert_head($flux){
  2. $flux .= <<<EOF
  3. <script type="text/javascript">
  4. <!--
  5. (function($){
  6. $(document).ready(function(){
  7. /* Ajouter une barre porte plume sur les crayons */
  8. function barrebouilles_crayons(){
  9. $('.formulaire_crayon textarea.crayon-active').barre_outils('edition');
  10. }
  11. barrebouilles_crayons();
  12. onAjaxLoad(barrebouilles_crayons);
  13. });
  14. })(jQuery);
  15. -->
  16. </script>
  17. EOF;
  18. return $flux;
  19. }

Télécharger

La fonction JavaScript onAjaxLoad permet de rappeler la fonction donnée en paramètre lors d’un rechargement AJAX d’un élément de la page.

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

Traductions : English, français