Extension:W4G Rating Bar/fr

W4G Rating Bar fournit un système de notation des pages. La barre de vote peut soit être inclue sur les pages manuellement, en utilisant une fonction de parser, soit ajoutée automatiquement en bas de toutes les pages, en configurant le paramètre  en true. Diverses "top lists" peuvent ensuite être générée. W4G Rating Bar est une réécriture complète de Extension:Rating Bar, qu'elle remplace (un script de migration est fourni, cf la section correspondante).

Résumé des fonctionalités
Pour la privacité de vos utilisateurs, le paramètre $wgW4GRB_Settings['show-voter-names'] (booléen) peut être utilisé pour activé ou désactivé les fonctions permettant de faire le lien entre un utilisateur et ses votes.
 * affiche la barre de vote pour [nom de page], pour une notation de 0 to 100%.
 * affiche la note de [nom de page].
 *  permet d'afficher de nombreux types de liste:
 * Pages les mieux notées
 * Utilisateurs ayant le plus voté
 * Derniers votes pour une page, une catégorie, ou globalement
 * Derniers votes d'un utilisateur

Fonctions retirées par rapport à la version précédente

 * Vote anonyme. Ré-implémenté dans la version 2.1.0.
 * Notation par étoiles.
 * Personalisation de la note maximale (forcée à 100 maintenant).

MAJ de 2.0.1 vers 2.1.0
La structure de la base de données a été légèrement modifiée afin de supporter le vote anonyme. Il est nécessaire de lancer la requête suivante pour la mettre à jour. ALTER TABLE `w4grb_votes` DROP PRIMARY KEY , ADD PRIMARY KEY ( `uid`,  `pid` ,  `ip` );
 * NB: n'oubliez pas d'ajouter votre propre préfixe de table le cas échéant.

Dans tous les cas

 * 1. Créez un nouveau dossier dans votre dossier.
 * 2. Téléchargez l'archive et décompressez-là dans le dossier précédement créé.
 * 3. Lancez la requête SQL suivante pour créer les tables nécessaires dans la base de données de votre wiki:

CREATE TABLE IF NOT EXISTS `wik_w4grb_votes` ( `uid` int(11) unsigned NOT NULL,  `pid` int(11) unsigned NOT NULL,  `vote` tinyint(4) unsigned NOT NULL,  `ip` varbinary(39) NOT NULL,  `time` int(11) unsigned NOT NULL,  PRIMARY KEY  (`uid`,`pid`,`ip`) ) ENGINE=InnoDB DEFAULT CHARSET=binary;

CREATE TABLE IF NOT EXISTS `wik_w4grb_avg` ( `pid` int(10) unsigned NOT NULL,  `avg` float unsigned NOT NULL,  `n` int(10) unsigned NOT NULL,  PRIMARY KEY  (`pid`) ) ENGINE=InnoDB DEFAULT CHARSET=binary;
 * NB: n'oubliez pas de remplacer wik_ avec votre propre préfixe de table.
 * 4. Ajoutez le code suivant à la fin de LocalSettings.php:
 * (bien entendu, remplacez le chemin par celui qui convient!)
 * (bien entendu, remplacez le chemin par celui qui convient!)
 * (bien entendu, remplacez le chemin par celui qui convient!)

Migrer à partir Rating Bar v1.1
Si vous utilisez actuellement l'extension Rating Bar 1.1, vous allez devoir convertir la base de donnée à la nouvelle architecture. Un outil de migration est disponible depuis la version 2.0-b2. Cet outil de migration n'est pas (et ne sera pas) capable de combiner des anciennes données avec des nouvelles. D'autre par, puisque cette version ne supporte pas les votes anonymes, les votes anonymes ne sont pas importés par l'outil. Pour migrer depuis Rating Bar v1.1:
 * 1. Suivez les instructions  ci-dessus.
 * 2. Allez dans le dossier de l'extension et éditez les paramètrs lignes 25-32 de.
 * 3. Ajoutez  dans LocalSettings.php juste après
 * 4. Allez sur la page spéciale de votre wiki Special:W4GRBMigrate. La migration va se faire automatiquement.
 * 5. Supprimez  de LocalSettings.php et (optionnel, après avoir vérifié que tout marche bien) supprimer l'ancienne table ratingbar.

Configuration
Vous pouvez définir les paramètres suivants dans LocalSettings.php (ajoutez-les après la ligne qui inclut l'extension): Exemple: $wgW4GRB_Settings['ajax-fresh-data']=true; $wgW4GRB_Settings['allow-unoptimized-queries']=true; $wgW4GRB_Settings['auto-include']=false; $wgW4GRB_Settings['fix-spaces']=true; $wgW4GRB_Settings['max-bars-per-page']=1; $wgW4GRB_Settings['max-items-per-list']=200; $wgW4GRB_Settings['max-lists-per-page']=5; $wgW4GRB_Settings['show-voter-names']=false; Enfin, vous pouvez aussi controler qui peut voter à l'aide du droit. Les valeurs par défaut sont: $wgGroupPermissions['*']['w4g_rb-canvote'] = false; $wgGroupPermissions['user']['w4g_rb-canvote'] = true; $wgGroupPermissions['autoconfirmed']['w4g_rb-canvote'] = true; $wgGroupPermissions['bot']['w4g_rb-canvote'] = false; $wgGroupPermissions['sysop']['w4g_rb-canvote'] = true; $wgGroupPermissions['bureaucrat']['w4g_rb-canvote'] = true;
 * $wgW4GRB_Settings['ajax-fresh-data']: booléen, si vous voulez utiliser AJAX pour afficher la note en temps réel aux visiteurs. Mettez en false si vous avez besoin de diminuer le nombre de requêtes à la base de données (ne concerne que les bases exclaves). Valeur par défaut: true.
 * $wgW4GRB_Settings['auto-include']: booléen, si vous voulez inclure automatiquement la barre en page de toutes les pages. Valeur par défaut: false.
 * $wgW4GRB_Settings['allow-unoptimized-queries']: booléen, si vous voulez autoriser les requêtes un peu plus gourmandes en calcul dans la base de données. Ce ne sont pas non plus des requêtes excessivement lourdes, ce paramètre est plus là en tant qu'interrupteur d'urgence si besoin. Valeur par défaut: true.
 * $wgW4GRB_Settings['fix-spaces']: booléen, si vous voulez activer le remplacement automatique des espaces par des underscores (et inversement) quand cela est nécessaire pour les données entrées en nom de page ou de catégorie, afin que les espaces et underscores puissent être utilisé indifféremment (sinon l'utilisateur doit parfois utiliser l'un et parfois utiliser l'autre - potentiellement un peu agaçant). Valeur par défaut: true.
 * $wgW4GRB_Settings['max-bars-per-page']: nombre maximum de barres sur une page (sans compter la barre auto-incluse le cas échéant). Valeur par défaut: pas encore figée, peu changer.
 * $wgW4GRB_Settings['max-items-per-list']: nombre maximum d'entrée dans une top list. Valeur par défaut: pas encore figée, peu changer.
 * $wgW4GRB_Settings['max-lists-per-page']: nombre maximum de listes sur une page. Valeur par défaut: pas encore figée, peu changer.
 * $wgW4GRB_Settings['show-voter-names']: booléen, autorisé ou non les fonctions faisant le lien entre un utilisateur et ses votes. Valeur par défaut: false.

Utilisation
La liste des fonctions et paramètres ainsi que des exemples de syntaxe sont disponibles ici: http://www.wiki4games.com/Wiki4Games:W4G_Rating_Bar/syntax.

Qui l'utilise?
cf la liste sur la VO de cette page.