SPIP - Contrib

[ar] [en] [es] [fr] [it]



Accueil du site > Documentation > Archives documentation > Bidouilles pour avant SPIP 1.9

TARGET manuel ou automatique, au choix... v2.0

lundi 8 septembre 2003, par Led. Dernier ajout lundi 8 septembre 2003


Cette fonction permet d’attribuer automatiquement ou manuellement une cible à un lien (fonction TARGET en HTML).


Tenant compte des remarques que l’on m’avait faite ;-) j’ai essayé de simplifier un peu mise en place de ce filtre par rapport à sa version 1.0. Maintenant le choix de rediriger ou non les liens extérieurs se fait dans les squelettes en argumentant le filtre. Plus besoin de modifier le code de la fonction. J’ai aussi raccourci le tag en supprimant le _ mais les tag de la v1.0 fonctionnent quand même avec cette v2.0. La redirection automatique, lorsqu’elle est validée par l’argument, se fait sur toutes les balises SPIP et non plus que sur #URL_SITE.

Le filtre s’utilise avec les balises #URL_SITE, #CHAPO, #TEXTE, #PS, #NOTES, #INTRODUCTION, #DESCRIPTIF et #BIO.

La syntaxe dans les squelettes doit être du type :
- <a href="[(#URL_SITE|cibles_liens)]">...</a>
- <a href="[(#URL_SITE|cibles_liens{tag})]">...</a>
- [(#TEXTE|cibles_liens)]
- [(#TEXTE|norm_liens{tag}]
tag doit avoir comme valeur blank, self, parent ou top.
Ce tag par défaut sert uniquement à spécifier le target qui sera appliqué automatiquement aux liens sans tag et pointant à l’extérieur. Si aucun tag n’est spécifié la balise HREF de ces liens n’aura pas de target.

La syntaxe à l’édition doit être :
1. Pour le champ "URL" dans l’édition d’une brève ou le champ "Adresse du site" pour le référencement d’un site :
- #tag#URL
2. Pour le champ "Texte" dans l’édition d’une brève, les champs "Chapeau ", "Texte" et "Post-Scriptum" dans l’édition d’un article ou tous les champs "Description" :
- #tag#[texte->URL]
- #tag#[texte->n°d'article]
- #tag#[texte->rubxxx]
- #tag#[texte->brxxx]
#tag# doit avoir comme valeur #blank#, #self#, #parent# ou #top#.

Texte coller dans le fichiers "mes_fonction.php3" :

/* Filtre CIBLES_LIENS v2.0 - 23 juillet 2003 - Par Led

  Permet d'attribuer automatiquement ou manuellement une cible à un lien
  (fonction TARGET en HTML).
  Le filtre s'utilise avec les balises #URL_SITE, #CHAPO, #TEXTE, #PS, #NOTES,
  #INTRODUCTION, #DESCRIPTIF et #BIO.

  SYNTAXE DANS LES SQUELETTES:
  <a href="[(#URL_SITE|cibles_liens)]">...</a>
  <a href="[(#URL_SITE|cibles_liens{tag})]">...</a>
  [(#TEXTE|cibles_liens)]
  [(#TEXTE|norm_liens{tag}]
  Où tag doit avoir comme valeur blank, self, parent ou top.
  Ce tag par défaut sert uniquement à spécifier le target qui sera appliqué
  automatiquement aux liens sans tag et pointant à l'extérieur. Si aucun tag
  n'est spécifié la balise HREF de ces liens n'aura pas de target.

  SYNTAXE A L'EDITION:
  Pour le champ "URL" dans l'édition d'une brève
  ou le champ "Adresse du site" pour le référencement d'un site:
    - #tag#URL
  Pour le champ "Texte" dans l'édition d'une brève, les champs "Chapeau ",
  "Texte" et "Post-Scriptum" dans l'édition d'un article ou tous les champs
  "Description":
    - #tag#[texte->URL]
    - #tag#[texte->n°d'article]
    - #tag#[texte->rubxxx]
    - #tag#[texte->brxxx]
  Où #tag# doit avoir comme valeur #blank#, #self#, #parent# ou #top#.
*/

function cibles_liens($texte, $target='') {

   /* COMPABILITE AVEC LA VERSION 1.0 */
   $texte = eregi_replace('#_blank#', '#blank#', $texte);
   $texte = eregi_replace('#_self#', '#self#', $texte);
   $texte = eregi_replace('#_parent#', '#parent#', $texte);
   $texte = eregi_replace('#_top#', '#top#', $texte);

   /* TRAITEMENT SUR LA BALISE #URL_SITE */

   /* Insertion du TAG par défaut si TAG non présent et si lien pointe vers l'extérieur */
   if ( substr($texte, 0, 7) == 'http://' or
        substr($texte, 0, 6) == 'ftp://' ) {

        if ( $target != '' ) $texte = '#'.$target.'#'.$texte;
        }

   /* Détection du TAG et réécriture du code HREF */
   if ( substr($texte, 0, 7) == '#blank#' or
        substr($texte, 0, 6) == '#self#' or
        substr($texte, 0, 8) == '#parent#' or
        substr($texte, 0, 5) == '#top#' ) {

       $texte = eregi_replace('#(.*)#([^>]*)', '\\2" target="_\\1', $texte);
       }

   else {

       /* TRAITEMENT SUR LES AUTRES BALISES COMPATIBLES */

       /* Insertion du TAG par défaut si TAG non présent et si lien pointe vers l'extérieur */
       if ( $target != '' ) {
           $texte = eregi_replace('([^#])<a href="http://', '\\1#'.$target.'#<a href="http://', $texte);
           $texte = eregi_replace('([^#])<a href="ftp://', '\\1#'.$target.'#<a href="ftp://', $texte);
           }

       /* Détection du TAG et réécriture du code HREF */
       $texte = eregi_replace('#blank#<a href="([^>]*)>', '<a href="\\1 target="_blank">', $texte);
       $texte = eregi_replace('#self#<a href="([^>]*)>', '<a href="\\1 target="_self">', $texte);
       $texte = eregi_replace('#parent#<a href="([^>]*)>', '<a href="\\1 target="_parent">', $texte);
       $texte = eregi_replace('#top#<a href="([^>]*)>', '<a href="\\1 target="_top">', $texte);
       }

   return $texte;
}

Pour les mêmes raisons que sur la v1.0 il vaut mieux éviter d’utiliser ce filtre sur le texte des forums.
Mon filtre "spécial forum" cité dans l’article sur la v1.0 s’est transformer en filtre qui normalise les liens orphelins. Il arrive bientot....

Led

Documents joints

  • cibles_liens_v2.0.txt cibles_liens_v2.0.txt (texte - 3.1 ko)

    Fichier texte contenant la fonction cibles_liens v2.0 à coller dans le fichier "mes_fonctions.php".


Répondre à cet article



Suivre la vie du site RSS 2.0 | Plan du site | Espace privé | Charte et vie SPIP-Contrib | SPIP | L'autre.net