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

Aucune discussion

Ajouter un commentaire

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.

Qui êtes-vous ?
[Se connecter]

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