Une jauge graphique

Ce filtre permet de rajouter une jauge graphique pour représenter la popularité des articles.

La balise #POPULARITE qui indique la popularité d’un article, est calculée automatiquement par SPIP ; il s’agit d’un pourcentage, et son affichage standard dans une boucle se fait sous forme de texte.
Le filtre jauge permet de créer une petite barre graphique de longueur proportionnelle à la valeur du résultat. Celà donne un rendu visuel plus parlant, voire plus esthétique.

Voici concrètement un type d’utilisation de ce filtre :

Exemple d’utilisation
Un nouvel article publié en ligne n’a pas de « popularité » ; dans ce cas il n’y a pas de barre.
En revanche pour tous les articles visités, la barre s’affiche, proportionnellement à la valeur de la balise.

Utilisation

Synopsis :
[(#BALISE|jauge{arg})]

Le filtre prend un argument qui correspond à la couleur désirée de la barre. Trois couleurs sont livrées pour coller au mieux à votre charte graphique : « rouge », « vert », « orange ». La couleur par défaut est orange.
Le filtre s’applique donc ainsi :

#POPULARITE|jauge  // Applique la jauge par défaut (orange)
#POPULARITE|jauge{orange}  // applique la jauge orange
#POPULARITE|jauge{vert}  // Applique la jauge verte

Installation

-  Copiez le code ci-dessous dans votre fichier mes_fonctions.php3 ;
-  Créez un répertoire /IMG2/ [1] à la racine de votre site SPIP ;
-  Copiez les images contenues dans le fichier zip attaché dans le répertoire IMG2.

Code à recopier :

/*
 *   +-------------------------------------------------+
 *    Nom du Filtre : jauge
 *   +-------------------------------------------------+
 *    Date   : 1er janvier 2004
 *    Auteur : Bastian (seb at planetenice.com)
 *   +-------------------------------------------------+
 *    Fonctions de ce filtre :
 *    Permet de créer une petite barre graphique de 
 *    longueur proportionnelle à la valeur du résultat.
 *
 *    Exemple :
 *    [Popularité : (#POPULARITE|jauge{rouge})<br>]
 *   +-------------------------------------------------+ 
 *  
 * Pour toute suggestion, remarque, proposition d'ajout
 * reportez-vous au forum de l'article :
 * http://www.uzine.net/spip_contrib/article.php3?id_article=xxx
*/
function jauge ($popularite, $couleur='orange') {
        $texte = "";
        if ($popularite > 0) {
            $texte = "<img src='./IMG2/barre_${couleur}_gauche.gif' border='0' width='2' height='8' align='middle' alt=''><img src='./IMG2/barre_${couleur}.gif' border='0' width='$popularite' height='8' align='middle' alt=''><img src='./IMG2/barre_${couleur}_droite.gif' border='0' width='2' height='8' align='middle' alt=''>";
        }
        return $texte;
}

Exemple de boucle

Afficher du plus récent au plus ancien les 10 derniers articles, avec leur popularité (texte et barre) :

<BOUCLE_articles(ARTICLES){0,10}{par date}{inverse}>
  [<a href="#URL_ARTICLE">(#TITRE)</a><br>]
  <small>Popularit&eacute;&nbsp;:<b>(#POPULARITE)%</b></small><br>]
[(#POPULARITE|jauge{rouge})<br>]
</BOUCLE_articles>

Notes

[1...ou tout autre nom/chemin de répertoire qui vous convient. Dans ce cas, modifiez le code de la fonction php en conséquence (remplacer tous les IMG2 par votre propre chemin).

Ce filtre peut tout aussi bien être appliqué à la balise #POINTS qui donne la pertinence des résultats d’une recherche, bien que la documentation officielle précise que « dans l’absolu cette valeur n’est pas très explicite, elle est surtout utile pour le classement des résultats ».

Discussion

6 discussions

  • salut
    je suis débutant avec spip. j’ai copié le texte dans mes-fonctions, mais comment afficher la barre dans tous mes articles ? ou dois-je insérer la boucle ?
    merci

    Répondre à ce message

  • jean-noel

    J’utilise cette contribution sur l’ensemble des pages avec la boucle popularité pour l’ensemble du site.

    merci encore cordiales salutations

    jean-noël

    Répondre à ce message

  • Cela fonctionne très bien !

    Dans la boucle en exemple, il manque juste un ’[’ avant ’small’

    Sinon, c’est parfait !

    Répondre à ce message

  • 2

    Ca marche très bien, bravo et merci !
    Je viens de découvrir SPIP et je suis ébahi par la puissance et la simplicité de ce système.
    Un grand bravo à tous pour la disponibilité et l’inventivité.

    Répondre à ce message

  • ça marche pour moi aussi, j’en suis très content. Merci pour cette contrib !

    Une question : comment faire pour réinitialiser les pourcentages - et donc la jauge ?

    D’avance merci à celui (ou celle) qui voudra bien éclairer mon chemin...

    Répondre à ce message

  • 1

    J’ai bien mis la fonction dans mon fichier mes_fonctions.php3, mais voilà, il me dit que la fonction n’existe pas... J’ai recopié les images dans le dossier /IMG2/ comme indiqué..

    http://www.clampin.com/test.php3

    J’ai peut être fait une erreur quelque part... :(

    • Bastian

      La page que tu mets en lien a un drôle de squelette...

      <b>Tous les sites rŽfŽrencŽs dans chaque rubrique<b><br><br>
      
       <BOUCLE_secteurs(RUBRIQUES){racine}{par titre}>
       [Rubrique: <br><br><a href="#URL_RUBRIQUE">(#TITRE)</a><br><br>]
      
       Ê Ê Ê Ê<BOUCLE_sitesp(SITES){id_rubrique}{par date}{inverse}>
       Ê Ê Ê Ê Ê Ê Ê Ê[<a href="#URL_SITE"target="_blank">(#NOM_SITE)</a><br>]
       Ê Ê Ê Ê</BOUCLE_sitesp>
       Ê Ê Ê Ê </b_sitesp>
      
       Ê Ê Ê ÊAucun site dans cette rubrique principale.
       Ê Ê Ê Ê<//b_sitesp>
      
       <BOUCLE_sous_rub(RUBRIQUES){id_parent}{par num titre}>
       [Rubrique: <br><br><a href="#URL_RUBRIQUE">(#TITRE)</a><br><br>]
      
       Ê Ê Ê Ê<BOUCLE_sitese(SITES){id_rubrique}{par date}{inverse}>
       Ê Ê Ê Ê Ê Ê Ê Ê[<a href="#URL_SITE"target="_blank">(#NOM_SITE)</a><br>]
       Ê Ê Ê Ê </BOUCLE_sitese>
       Ê Ê Ê Ê </b_sitese>
      
       Ê Ê Ê ÊAucun site dans cette sous-rubrique.
       Ê Ê Ê Ê<//b_sitese>
      
       Ê Ê Ê Ê<BOUCLE_enfants(BOUCLE_sous_rub)></BOUCLE_enfants>
       </BOUCLE_sous_rub>
      
       <br><br>
      
       </BOUCLE_secteurs>
       </B_secteurs>
      
       Aucune rubrique dans ce site.
       <//B_secteurs>

      Visiblement ya un souci, bien avant le filtre (qui d’ailleurs n’est pas appelé).

    Répondre à ce message

Ajouter un commentaire

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

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom

Dernière modification de cette page le 5 décembre 2006