*********************************
*** Notation des articles SPIP **
*********************************

Ce plugin installé correctement dans votre répertoire /plugins/ vous permettra d'affecter des notes aux articles 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é.
• Si l'utilisateur s'est identifié, on enregistre son id_auteur, ce qui permet de gérer un vote des auteurs (gestion du vote de la rédaction, critiques...).
• Vous pouvez limiter le vote aux personnes enregistrées au préalable, aux auteurs, aux seuls adminisatrateurs ou l'ouvrir à tous.

INTEGRATION :

La notation s'intègre dans la partie publique à l'aide de la balise #NOTATION.
Cette balise est à intégrer directement dans le fichier article.html de votre squelette (ou dans le fichier article-xx.html pour limiter la notation aux articles de la rubrique xx).

Cette balise affiche :

• La note sous forme d'une image de 5 etoiles (img_pack/notation-on.gif et img_pack/notation-off.gif)
• le formulaire permettant de noter l'article (un vote par article et par adresse IP ou par auteur).

Dans les articles, on peut afficher :

• la note donnée par un auteur : <autxx|notation|id_article=yy>
• la note donnée par un groupe d'auteurs : <notationxx|tableau|id_auteur=yy,zz,...>
• le top ten : <notation|topten|max=10|titre=le TopTen>
• la répartition des votes pour l'article xx : <notationxx|statistique|left|titre=Statistiques>

Le plugin définit les boucles :

• NOTATIONS : #ID_ARTICLE, #ID_AUTEUR, #NOTE, #IP, #MAJ
• NOTATIONS_ARTICLES : #ID_ARTICLE, #NOTE (moyenne), #NOTE_PONDEREE, #NB
  Pour accéder à la note moyenne arrondie, utiliser le filtre [(#NOTE|round)]

GESTION DE CRITIQUES :

Les critiques sont gérées dans le forum de l'article.
Le titre du post dans le forum doit contenir le texte [notation].
Les points positifs doivent être précédés de [+], les points négatifs de [-].

Le plugin définit :

• un filtre 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)].
• un modèle pour afficher la critique de l'auteur xx (lorsqu'il a voté et laissé sa critique dans le forum) <autxx|critique|id_article=yy>

PONDERATION :

Le but est d'accorder une meilleure note aux articles ayant reçu plus de vote :
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...

On choisit la formule :
moy_ponderee = moy * (1-EXP(-10*moy/(2*coef)))
Si moy > coef, on a moy_ponderee ~ moy ;
sinon moy_ponderee < moy.

Cela nous permet de descendre les articles les moins notés.
Ainsi, pour un coef de :
coef=100

nb vote	moy	moy_ponderee
1	5	0,24
10	5	1,97
100	4,99	4,97

coef=10

nb vote	moy	moy_ponderee
1	5	1,97
10	4,99	4,97
100	4,99	4,99

A vous de choisir votre coef en fonction de votre site et de sa fréquentation...

PERSONALISATION :

L'affichage de la note est paramétrable : pour cela, il vous suffit de définir une image notation-on.gif et notation-off.gif dans le répertoire img_pack/ de votre squelette.
Vous pouvez également définir une image différente pour chaque indice de notation : notation-on1.gif, notation-on2.gif, ... et leur pendant : notation-off1.gif, notation-off2.gif, ...

Pour modifier le libellés des notes, surchargez note_1, note_2,... dans le fichier de langue de votre squelette (lang/local_fr.php).

La valeure maximale des votes peut ètre comprise en 1 et 10. Il est toutefois conseillé de ne pas modifier cette valeur une fois le vote démarré

TODO :

• Créer une jointure avec la table des articles pour permettre un tri directement sur la note