Une jauge graphique

Published : 7 April 2004 – updated on 21 December 2021 – by Bastian – 9 commentaires

1
2
3
4
5
0 vote
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>

Footnotes

[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

5 years 1 year 3 months Without limit
par date
Filter

6 discussions

  • eric

    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

    Reply to this 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

    Reply to this message

  • michaël

    Cela fonctionne très bien!

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

    Sinon, c’est parfait!

    Reply to this message

  • 2
    Arno

    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é.

    Reply to this message

  • Phil

    ç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...

    Reply to this 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 rfrencs 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é).

    Reply to this message

Add a comment

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Who are you?
[Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom