Ce plugin est une mise à jour majeure du plugin Notation d’articles destiné à SPIP 2.0. Les principales nouveautés sont les suivantes :
- plugin basé sur les nouveaux formulaires ajax de SPIP 2
- utilisation du script Jquery Star Rating
- notation des articles, des messages de forum ou tout autre autre élément de SPIP (auteurs, rubriques...)
Correctement installé (voir http://www.spip.net/fr_article3396.html), le plugin permettra aux visiteurs de noter les éléments de SPIP directement depuis l’espace public.
La notation se fait de façon classique sous forme d’étoiles cliquables, à l’apparence et au nombre paramétrable (jusqu’à 10).
Mise à jour en spip2
Ce plugin fonctionne à partir de SPIP 2.0beta2. Si vous utilisiez le plugin Notation d’articles (à jour !) avec un SPIP 1.9.2, vous pouvez (après avoir effectué les sauvegardes nécessaires de la base de données) :
- désactiver les plugins,
- mettre à jour votre SPIP en version 2,
- mettre à jour les plugins (CFG et notations) notamment et les activer. Les tables du plugin notations seront alors mises à jour.
Attention : SPIP2 est une version obsolète, c’est désormais SPIP3 qu’il faut utiliser !
Comment ça marche ?
Le plugin gère 2 tables :
- NOTATIONS : qui contient les notes saisies par visiteur, avec les champs suivant :
-
#OBJET: le type d’objet noté ; (exemple : article) -
#ID_OBJET: identifiant de l’objet noté (exemple : 28) ; -
#ID_AUTEUR: l’auteur ayant voté (s’il est identifié) -
#IP: l’adresse IP (utile si le visiteur ne s’est pas identifié) -
#NOTE: la note attribuée ; -
#MAJ: la date de saisie de la note
-
- NOTATIONS_OBJETS : qui contient les statistiques des votes par élément de SPIP :
-
#OBJET: le type d’objet noté ; -
#ID_OBJET: identifiant de l’objet noté -
#NOTE: la note moyenne (utiliser le filtre[(#NOTE|round)]pour avoir la note arrondie) ; -
#NOTE_PONDEREE: la note pondérée (voir plus loin) ; -
#NOMBRE_VOTES: le nombre de votant.
-
Vous pouvez afficher le contenu de ces tables via les BOUCLEs de SPIP.
Comportement :
- On limite à un vote par article et par utilisateur (ou adresse IP lorsqu’on n’est pas enregistré).
- Une personne non enregistrée vote donc sur son adresse IP. Si une même adresse IP vote plusieurs fois, le nouveau vote remplace l’ancien sauf s’il correspond au vote d’un utilisateur identifié qui reste prioritaire (non mais).
- Si l’utilisateur s’est identifié, on enregistre son id_auteur, ce qui permet de gérer un vote des auteurs (vote de la rédaction, critiques...).
- Vous pouvez limiter le vote aux personnes enregistrées au préalable, aux auteurs, aux seuls administrateurs ou l’ouvrir à tous.
Proposer un vote
Il suffit d’indiquer dans ses squelette d’afficher le formulaire de notation :
<BOUCLE_art(ARTICLES){!par date}{0,10}>
#TITRE -- notez cet article #FORMULAIRE_NOTATION<br />
</BOUCLE_art>#FORMULAIRE_NOTATION s’applique automatiquement sur le type de boucle dans lequel il est inscrit, ainsi, il s’appliquera sur un auteur dans une boucle AUTEURS, ou permettra de voter un message de forum sur une boucle FORUMS.
Il est cependant possible de forcer le type et l’identifiant de l’objet à noter en indiquant les deux paramètres objet et id_objet : #FORMULAIRE_NOTATION{rubrique,#ID_RUBRIQUE}
Le plugin propose les variantes de formulaires suivantes :
-
#FORMULAIRE_JAIME_JAIMEPASpermet aux visiteurs de voter pour ou contre et de retirer leur vote (suivant la configuration). -
#FORMULAIRE_JAIMEpermet aux visiteurs de voter pour ou de retirer leur vote (suivant la configuration).
Afficher un vote
Par défaut, la balise #FORMULAIRE_NOTATION affiche une note de la moyenne pondérée de l’élément. Une personne pouvant voter peut cliquer une étoile pour enregistrer son vote. Une personne ne pouvant pas voter ou ayant déjà votée (selon la configuration) pourra simplement voir la moyenne sans pouvoir cliquer.
Il est possible d’afficher des notes données sans utiliser le formulaire en utilisant la balise #NOTATION_ETOILE{#NOTE}, à laquelle on transmet la note à afficher.
Affichons la liste des derniers votes de visiteurs enregistrés (id_auteur>0) de l’article en cours :
<BOUCLE_dernieres_notes_article(NOTATIONS){!par maj}{0,5}{id_article}{id_auteur>0}>
- <BOUCLE_a(AUTEURS){id_auteur}>#NOM</BOUCLE_a>, Note #NOTATION_ETOILE{#NOTE}<br />
</BOUCLE_dernieres_notes_article>Qu’on peut simplifier en forçant une jointure sur la table auteurs :
<BOUCLE_dernieres_notes_article(NOTATIONS auteurs){!par maj}{0,5}{id_article}>
- #NOM, Note #NOTATION_ETOILE{#NOTE}<br />
</BOUCLE_dernieres_notes_article>Etre dans la moyenne
Pour trier les articles (ou autre élément) selon les critères de notation, par nombre de vote, moyenne ou moyenne pondérée, il est conseillé d’utiliser un critère spécifique {notation}. Ce critère effectue la jointure (liaison entre les tables) et les calculs.
Ainsi, la présence de {notation} permet d’utiliser {!par moyenne} :
<BOUCLES_messages(FORUMS){id_article}{notation}{!par moyenne}>
#TITRE du message, #NOTATION_NOMBRE_VOTES votes, #NOTATION_ETOILE {#NOTATION_MOYENNE}<br />
</BOUCLES_messages>La boucle précédente va lister tous les messages de forums d’un article, même ceux qui n’ont pas reçu de notes (d’un point de vue SQL, c’est un LEFT JOIN qui est effectué). Pour afficher uniquement les messages ayant reçu des votes, il est possible de transmettre une comparaison au critère notation, ici {notation nombre_votes>0} :
<BOUCLES_messages(FORUMS){id_article}{notation nombre_votes>0}{!par moyenne}>
#TITRE du message, #NOTATION_NOMBRE_VOTES votes, #NOTATION_ETOILE{#NOTATION_MOYENNE}<br />
</BOUCLES_messages>Pour certains cas, vous devrez utiliser la table NOTATIONS_OBJETS pour afficher vos statistiques. Vous pouvez utiliser les modèles prédéfinis (dans le dossier /modeles du plugin) ou vous en inspirer selon vos propres besoins.
Qu’est-ce que la pondération ?
Le but est d’accorder une meilleure note aux articles ayant reçu plus de votes : il est injuste qu’un article ayant reçu 1 seul vote de 5 soit mieux classé qu’un article ayant reçu 100 votes et une moyenne de 4,99 (non ?)...
On choisit la formule :
moy_ponderee = moy * (1-EXP(-5*nb_votes/ponderation)))Si nb_votes>ponderation, on a moy_ponderee~moy, ;
sinon moy_ponderee<moy, .
Le principe de la pondération est de pénaliser les articles ayant eu peu de votes... et faire sortir en premier ceux ayant suscité le plus d’intérêt.
Le facteur de pondération est le nombre de votants que vous jugez pertinent, en fonction de la fréquentation et du nombre de votes sur votre site (tout article ayant un nombre de votes inférieur au facteur de pondération verra sa note pénalisée), il est réglable dans l’espace privé.
Pour désactiver la pondération, choisissez un facteur de pondération de 1.
Configuration dans l’espace privé
Une nouvelle icône vient s’ajouter au menu Activité [1]. Elle permet d’accéder au paramétrage du plugin : facteur de pondération, ouvrir la notation aux administrateurs, aux auteurs, aux personnes enregistrées ou à tous. Une option permet de définir si une personne peut modifier sa note après avoir voté ou non.
Le nombre d’étoiles que vous désirez afficher (la valeur max de la note, entre 1 et 10) doit être fixée en début de vote afin de ne pas créer d’incohérences dans la notation.
Les modèles du plugin
Le plugin propose un certain nombre de modèles à utiliser directement dans vos articles ou squelettes, regardez les, modifiez les pour les adapter à vos propres besoins :
- <aut33|notation|id_article=10|left>
affiche la note de l’auteur 33 pour l’article 10
- <notation|topten|max=10|titre=le TopTen>
affiche le topten (les 10 articles les mieux notés)
- <notationxx|statistiques|left|titre=Statistiques>
affiche les statistiques (nombre de votes) pour l’article xx.
- <notationxx|tableau|id_auteur=yy,zz,...>
affiche la note donnée par un groupe d’auteurs (yy,zz...)
- <notation|preferee|titre=TOPTen|max=10|id_auteur=1|left>
affiche les 10 meilleures notes de l’auteur 1
FAQ
Comment gérer des critiques ?
Historiquement (issu du plugin notations d’articles), il est possible de gérer des critiques au travers des forums de l’article : dans ce cas, le titre du post doit contenir le texte [notation]. Les points positifs doivent être précédés de [+] et les points négatifs de [-].
À ce titre, un filtre est disponible : notation_critique pour supprimer les balises et remplacer [+] et [-] par une image d’img_pack (notation-plus.gif et notation-moins.gif), par exemple [(#TITRE|notation_critique)] permet de supprimer [notation] du titre du post.
Un exemple d’utilisation est donné par le modèle <autxx|critique|id_article=yy> qui affiche la critique de l’auteur xx pour l’article yy...
Dernières évolutions du plugin
Ajoûts du dec 2010 :
Les balises #NOTATION_NOMBRE_VOTES, #NOTATION_MOYENNE et #NOTATION_MOYENNE_PONDEREE peuvent s’écrire avec une référence de boucle :#_toto:NOTATION_MOYENNE_PONDEREE
Elles peuvent être utilisées en dehors du contexte d’une boucle ayant le critère {notation} . Il faut alors leur passer le contexte en paramètre :#NOTATION_MOYENNE_PONDEREE{article,12}
Discussions par date d’activité
158 discussions
Bonjour,
Je n’arrive pas à mettre en place le plug-in parce que j’obtient une erreur :
Table ’mabasecom.spip_notations_objets’ doesn’t exist
Effectivement elle n’existe pas mais le plugin n’est pas censé la créer ?
Merci
Si le plugin est censé créer les tables dont il a besoin à l’installation. Essaye de désactiver et de re-activer celui-ci pour qu’il relance la création des tables.
++
Non ça ne veux pas.
J’utilise également l’ancien plug-in, Notation d’article (sans soucis)
Mais notation ne veut pas créer cette table.
Pour info je suis sur SPIP 2.0.9
Merci
J’ai le même problème : d’autres plugins sont installés (et désinstallés sans aucun problème) notamment tickets...
... mais celui là ne veut pas créer ses bases.
J’utilise SPIP 2.0.9.
Répondre à ce message
Merci pour ce plugin !
Par contre je n’ai pas trouvée pour par exemple faire un top ten des articles d’une rubrique particulière.
Une manip est t’elle possible pour cela ?
Merci encore :)
Répondre à ce message
notation1722|statistiques|left|titre=Statistiquesm’affiche un lien « notation 1722 » qui me renvoie à la page sommaire...
Qu’est-ce que j’ai mal fait ?
Merci
PS/ J’ai bien mis « <" au début et "> » à la fin
Je ne reproduis pas. Tu mets bien cela dans le texte d’un article ? pas dans le code d’un squelette ?
Oui, bien dans le corps...
J’ai pensé que dans le chapeau c’était ça qui causait problème... Mais non.
Je suis en 2.09 et squelette @Brest
En ligne : http://www.centre-lecture.com/loisirs/spip.php?article1722
Oui, oui...
Un exemple en ligne :
http://www.centre-lecture.com/loisirs/spip.php?rubrique908
et
http://www.centre-lecture.com/loisirs/spip.php?article1722
Vous pouvez me dire ?
Répondre à ce message
salut, peut on utiliser le submit d’annulation du vote dans le formulaire_notation ? j’y arrive pô, tout ce que ça fait c’est de diminuer la note d’un point jusqu’à la note1. Bon week end
Répondre à ce message
Mise à jour de la documentation (version 0.6 du plugin pour SPIP 2.0) faite aujourd’hui.
Il est maintenant possible :
{notation}ou un critère plus une comparaison{notation moyenne>2}et de permettre de trier les tables ayant ce critère{par nombre_votes}, par moyenne ou moyenne_ponderee.#NOTATION_ETOILE{nombre}#FORMULAIRE_NOTATIONdans une boucle sur l’élément.Il est maintenant possible de voter n’importe quel élément de spip. Est ce que ça veut dire que si on a des images en documents joints pour une petite galerie photos par ex on peut attribuer des notes pour chaque image.
Oui, il suffit j’ajouer #FORMULAIRE_NOTATION dans la boucle document qui affiche tes images.
MM.
Merci, ça c’est super.
J’ai vu aussi que pour les icônes (car je voulais les changer, tout au moins la couleur) qu’il n’y avait qu’un seul fichier pour les 3 couleurs et que dans la feuille de style on jouait sur le décalage. Est-ce qu’on aura bientôt un nouveau pack d’images pour choisir autre chose que les étoiles ?
Je n’avais pas vu que le paramétrage était dans la case forum car là je viens de constater que lorsque je fais afficher les notes j’ai un message d’erreurs
Error(s) in template
1 No available template ’modeles/inc-notation-preferee-document’...
2 Compilation error
3 No available template ’modeles/inc-notation-preferee-document’...
4 Compilation error
5 No available template ’modeles/inc-notation-preferee-document’...
par contre j’ai bien accès à l’onglet paramètres, pas de soucis
Quelqu’un d’autre a t’il le même souci ?
Non, c’est normal...
En fait, on a juste codé l’affichage de 3 objets dans la page de notations (articles, forum et auteurs)... alors qu’on peut voter n’importe quoi...
Il suffit de créer le code qui va bien dans modeles/inc-notation-preferee-YY.html ... là, tu as du noter des documents , et il manque le fichier... Par ailleurs, je vois pour les autres qu’on n’a pas pris le temps d’utiliser les chaines de traductions de SPIP au passage ’Article : ’ est écrit en dur dans ces fichiers.
J’ajoute l’affichage pour document (version 0.6.1), très vite fait.
Ah merci, justement j’étais en train de regarder le modele topten pour faire un topten de la galerie et j’ai vu qu’il n’y avait pas la boucle documents.
Par contre si on utilise le modèle dans le squelette et pas dans un article, on écrit quoi exactement.
Attention cependant, les deux écritures ne font pas exactement la même chose (je ne sais plus exactement les différences) mais pour ce que tu souhaites, l’une ou l’autre devrait aller.
ben voilà mon erreur, j’avais marqué topten entre parenthèses au lieu des guillemets. (au passage on fait comment pour rentrer du code dans les commentaires ??)
Sinon ce serait intéressant de proposer le modéle topten avec comme paramètre l’objet ou par défaut ts les objets si pas de paramètres.
Merci, maintenant l’affichage des notes dans l’interface privée marche nickel !!!
aloa, je vois sur ce thread que tu utilises les votes sur les documents, peux tu tester cette boucle stp, je galère sec, merci
ce problème est résolu
Un peu d’explications sur les causes du problème et la technique employée pour le résoudre pourraient aider les autres personnes qui le rencontreront un jour...
http://zone.spip.org/trac/spip-zone/changeset/31060
Tout simplement ^^
Cool, avec ça plus personne ne risque de rencontrer le problème en question. Merci Matthieu
Répondre à ce message
bonjour, je bloque depuis plusieurs jours sur cette boucle en 2.09 vierge, ne trouvant pas d’explication si ce n’est la poisse ;-), merci de me dire si vous l’utilisez avec succès,
Répondre à ce message
Bonjour et bravo !
Je vous fais part d’un problème que j’ai rencontré et qui est facilement contournable.
Pour des raisons obscures, avec FireFox 3.0 et 3.5, des chiffres rouges apparaissaient surimprimés sur les étoiles dans le formulaire de notation.
J’ai simplement retiré le moins qui précède la valeur 999 à la ligne 2 du fichier spip/plugins/auto/notation/css/jquery.rating.css
est donc devenu
En espérant que cette bidouille soit utile à quelqu’un... :)
Bonjour et merci de partager la solution à ton problème. À noter qu’elle est valable pour ceux et celles qui comme ça devait être le cas chez toi ont appliqués un style text-align : right ; sur un des conteneurs u formulaire de notation. C’est ça qui fait que tu te retrouvais avec les chiffres correspondant à chaque étoile en surimpression de celles-ci.
++
Répondre à ce message
Bonjour,
Je ne sais pas pourquoi, mais pour voter j’ai des boutons à cocher et je dois cliquer sur un bouton pour valider. Ce n’est qu’après que les étoiles s’affichent pour me donner le résultat. Il m’est donc impossible de voter en cliquant sur les étoiles directement. Pourquoi ? Qu’est-ce qui ne va pas ?
Eddy.
Bonjour, peux-tu nous donner :
- l’url du site enquestion
- la version de SPIP installée
- la révision du plugin notation utilisé (info disponible dans le fichier svn.revision à la racine du plugin).
Avec ça on devrait pouvoir t’aider ++
Bonjour,
dans le fichier SVN de notation déléments SPIP :Revision : 27606
Pour l’URL : http://www.mdes.org/Le-Graje-de-Guyane.html
La version SPIP : 2.0.6
Eddy.
Héhé, il manque tout simplement l’appel à jQuery dans le head de ton squelette. Tu peux l’ajouter à la main ou ajouter la balise
#INSERT_HEADdans le head du squelette pour que SPIP y ajoute l’appel tout seul.++
Bonjour,
Héhéhé. Bien vu que je n’avais pas vu ! Effectivement avec #INSERT_HEAD ça coule tout seul. Merci beaucoup pour ton aide.
Eddy.
Répondre à ce message
Bonjour
Je trouve intéressant ce plugin, par contre je trouve que si c’est pas mal l’utilisation de la moyenne pondérée pour classer des articles selon la représentativité de leurs notation, par contre pour l’affichage de la note moyenne (avec la balise #FORMULAIRE_NOTATION), ce serait mieux d’avoir la moyenne simple.
Je m’explique :
j’ai donné un 8 à un article et je suis le seul à avoir noté.
Sa moyenne normale est 8 (ch’ui balèze en calcul mental ^^ )
Mais ça affiche 3 étoiles, ce qui correspond à la moyenne, pondérée par un de tes coefficients de représentativité.
C’est bien pour classer, mais ça donne une mauvaise image de l’article en tant que tel, quand on ne cherche pas à le mettre en comparaison avec d’autres.
N’est-il pas possible d’envisager un double affichage avec la moyenne simple et la moyenne « pondérée » ?
N’est-il pas possible que le coefficient de représentativité soit calculé par rapport au nombre moyen de notation par article, et par rapport à l’âge de l’article ?
(une formule du style :
« moyenne pondérée » = (moyenne de l’article) x ( (nbre de votes sur l’article)/(nbre de votes le plus grand parmi les articles) ) x ( ( (âge de l’article noté le plus vieux)/(âge de l’article en cours) ) exposant (alpha))
où (alpha) est un réel fixé par le webmestre, ce qui lui permet de choisir l’importance qu’il donne aux variation d’âges pour établir la représentativité d’une moyenne)
Tu peux très bien faire ça sur ton site (car c’est bien sur celui là que tu as ce besoin) en utilisant la balise #NOTATION_ETOILE et en lui passant la valeur que tu souhaites.
Pour ce qui est de la formule que tu proposes j’ai l’impression que ça ne serait pas terrible au niveau des temps de calcul. Il faudrait à chaque vote parcourir tous les articles notés pour extraire la plus grande note, puis l’âge de l’article le plus vieux. C’est tout de même à tester, tu peux le faire de ton côté et nous dire ensuite ce que ça donne ?
++
ok, merci, je n’avais pas compris comment ça marchait.
Pour l’âge, il pourrait être enregistré dans une variable une fois pour toute (le plus vieux reste le plus vieux), la plus grande note aussi (avec une procédure de mise à jour conditionnelle à chaque nouvelle notation).... En tout état de cause, je suis bien incapable de mettre en place de telles choses : en math, j’ai été un peu formé, en informatique pas du tout :-(
Désolé
Répondre à ce message
Wow, le délire, je suis justement en train de bosser sur un site pour ajouter ce plugin, j’allais venir demander un truc et je vois que le système de notation de spip-contrib a changé !
C’est une évolution de ce plugin ou c’est un autre ?
Parce que là c’est quand même moins précis comme note et ça ne m’arrange pas pour le site sur lequel je bosse…
Ah ué au fait ma question de départ : est-il possible d’afficher la note qu’à donner un visiteur sous la forme d’étoiles ? Parce que #NOTE ne donne que la note sous forme d’un chiffre…
C’est un nouveau formulaire proposé par le plugin mais pas encore documenté, patience...
Par contre ça c’est déjà bien documenté. Comme indiqué plus haut dans cette page dans la partie Afficher un vote :
Zut, j’ai du lire trop vite, désolé !
Je me disais bien que c’était bizarre de ne pas pouvoir faire ça… Merci pour les infos !
Répondre à ce message
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
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.
Suivre les commentaires :
|
