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 suis en version 0.9.6 et je n’arrive pas à mettre à jour mon top ten modéré lorsque je change mon facteur de pondération.
Les 10 meilleurs articles pondérés dans l’interface privée ne change pas.
J’ai vidé le cache san résultat.
Faut-il intervenir dans la base.
Merci d’avance de votre aide.
Mon site : http://www.edition999.info
Répondre à ce message
le fichier modeles/inc-notation-preferee-breve.html n’existe pas par défaut dans le plugin. SI vous utilisez NOTATION sur les brèces, ceci génère une erreur en allant sur la page /ecrire/ ?exec=notation.
Simple à corriger en créant le fichier avec le code
Messages aux développeurs : pouvez-vous l’ajouter au plugin ?
Merci
Bonjour
tu peux le rajouter dans le plugins ;)
Euh... Pas simple pour un novice. Il faut dire que sur les pages « how to », il y a plein de liens cassés. J’ai installé tortoise et quand j’ai fait SVN commit, on m’a demandé un login/mot de passe.
J’ai cherché et j’ai trouvé : il faut devenir « committer », ce qui n’est pas franchement mon but.
Franchement pour uploader un malheureux fichier, c’est un peu lourd...
il ne s’agit pas d’uploader, mais de versionner, donc de pouvoir garder un historique en cas de pépin :-)
ceci dit, je reconnais que l’explication n’est pas forcément des plus aisés quand on débute. Néammoins le jour où l’on apprend à se servir de SVN y compris pour des projets perso on gagne en productivité et en méthodologie.
Pour revenir à tes moutons, pour avoir les droits de faire un commit sur la zone il suffit
1) de s’inscrire sur http://listes.rezo.net/mailman/listinfo/spip-zone
2) d’envoyer un email demandant un accès ;
Répondre à ce message
Ayant bien galéré 2 heures avant de comprendre ce qu’il fallait faire, je me permets de donner la solution pour afficher une liste d’articles triés par notation avec l’affichage des étoiles (sans possibilité de voter) et le tout avec une pagination (par 10 articles)...
Voilà :
Le critère important ici était
{#NOTATION_MOYENNE_PONDEREE}(et surtout pas{NOTE}) sur la champ/balise#NOTATION_ETOILEE.En espérant que cela vous fera gagner du temps...
Et merci pour ce superbe plugin (qui fonctionne parfaitement avec les critère precedent et suivant via le plugin adéquate) :D
Répondre à ce message
Ola.
J’aimerai que le codage suivant affichant les notations des auteurs soit automatiquement inclue dans un nouvel article écrit par tous les rédacteurs.
<notationXXX|tableau|id_auteur=1,2,3,4,5,6,7,8,9,10>le XXX devra lui aussi correspondre automatiquement au numéro de l’article.
Si quelqu’un a une idée je suis preneur. Merci d’avance.
Salut, dans ce cas le mieux serait d’insérer le modèle en question directement dans ton squelette article.html.
++
Merci pour ta réponse b b. Peux tu être plus précis.
Ou se trouve ce fichier ?
Ou coller le modèle ?
comment faire pour que XXX soit automatiquement égale au numéro de l’article en cours de création.
Merci d’avance.
C’est l’été, les vacances. J’ai pris le temps de lire les différentes aides sur spip.net puis de bidouiller article.html avec la balise #ID_ARTICLE et ça fonctionne.
Un novice dans spip te remercie b_b.
Répondre à ce message
Bonjour, j’ai un soucis avec ce plugin. Je place juste le #FORMULAIRE_NOTATION dans ma boucle article, comme indiqué, mais j’obtiens des chiffres en colonne :
-1
1
2
3
4
5
et aucune image (d’étoile ou autre) ne s’affiche. Est ce que je m’y prend mal ? Ou est ce du a SPIP 3.0 .
Désolé pour cette question, mais j’ai vraiment l’impression de ne pas comprendre le fonctionnement de ce plugin :-S ...
Salut, avec une url vers la page qui pose problème je pourrai te le dire de façon certaine, mais je pense qu’il te manque la css et le script du plugin dans ta page. Vérifie que ton squelette comporte bien la balise
#INSERT_HEAD, c’est par là que le plugin insère les éléments nécessaires.++
Merci de votre réponse aussi rapide. Effectivement c’était ce #INSERT_HEAD qui me manquait. Je suis débutant, je ne connais donc pas toutes les ficelles de SPIP. Je suppose que pour d’autres plugins, se positionnant également sur du HTML, je dois aussi inscrire cette indication ??
En tout cas, merci encore ! Si j’ai d’autres questions, je répondrais à ce message.
Cordialement !
Répondre à ce message
Bonsoir, une petite question sur ce plugin ;
Est il possible de noter des documents ? (Photos dans mon cas)
Merci pour vos réponses.
Claude
Salut, comme indiqué en débit de cet article :
Donc tout est possible ;)
++
Merci b_b,
Donc je peux faire :
Sans avoir a modifier mon squelette a part la balise #FORMULAIRE_NOTATION ?
Répondre à ce message
Bonjour
Après analyse des traces sur les messages d’erreur du serveur de base de données (SHOW CREATE TABLE
article), je remonte jusqu’au plugin notation et je trouve dans les scripts /inc/notation.php des appels sur des tables qui ne prennent pas en compte le préfix des tables spip : ligne 179 144 128 ...Est-ce normal de trouver des appels en dur vers les tables spip_notations spip_notations_objets ? ne devrait-on pas trouver la variable global ’table_prefix’ ?
Merci de vos éclairages !
Non, les fonctions sql_* sont normalement capables de modifier les préfixes. De sorte qu’on écrit systématiquement « spip_xx » mais SPIP remplacera par le bon nom de table.
Il y a peut être une erreur quelque part, mais il faudrait la requete précise en erreur
Répondre à ce message
bonjour,
est il possible d’arriver à faire fonctionner plusieurs formulaires de vote sur la meme page indépendamment les uns des autres ? Pour obtenir ce que font certains plugins wordpress avec les multi rating comme sur l’image
sinon je ne vois pas d’autres possibilité que de dupliquer x fois le plugin, bien que cela va transformer la chose en usine a gaz !!!
je suis anxieux de votre réponse car j’ai vraiment besoin de cette fonction.
merci
C’est pas prévu à ma connaissance par ce plugin.
Répondre à ce message
Oui c’est vrai que c’est intéressant de le savoir, d’ailleurs c’est déjà dans le doc :
Tout va bien donc ;)
Répondre à ce message
Il serai intéressant de préciser les dépendance du plugin car se dernier dépends du plugin CFG. Si ce dernier n’est pas installer, on ne peut pas configurer le plugin et l’on se retrouve avec un message d’erreur.
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 :
|
