Extension:W4G Rating Bar/fr

From MediaWiki.org
Jump to navigation Jump to search
Manuel des extensions MediaWiki
OOjs UI icon advanced.svg
W4G Rating Bar
État de la version : stable
W4G Rating Bar - screenshot.png
Implémentation Parser function , Tag , Ajax, Special page , Database
Description Permet aux utilisateurs de noter les pages, lister les pages par note moyenne (globalement ou par catégorie), lister les derniers votes, etc.
Auteur(s) David et Franck Dernoncourt
Dernière version 2.1.1 (2011-03-20)
MediaWiki 1.16 (ne marche pas avec 1.15)
PHP 5.2, 5.3 (non testé avec des versions antérieures)
Licence CC BY-NC-ND
Téléchargement Page officielle | Lien direct (NB: vérifiez sur la VO de cette page si la dernière version indiquée ici est correcte)
Exemple Manuel de syntaxe (EN)

$wgW4GRB_Path, $wgW4GRB_Settings['ajax-fresh-data'], $wgW4GRB_Settings['allow-unoptimized-queries'], $wgW4GRB_Settings['auto-include'], $wgW4GRB_Settings['fix-spaces'], $wgW4GRB_Settings['max-bars-per-page'], $wgW4GRB_Settings['max-items-per-list'], $wgW4GRB_Settings['max-lists-per-page'],

$wgW4GRB_Settings['show-voter-names']
<w4grb_ratinglist/>
w4g_rb-canvote
Traduisez l’extension W4G Rating Bar sur translatewiki.net
Vérifiez la matrice des utilisations et des versions.

Template:Extension/archived

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 ({{#w4grb_rate}}), soit ajoutée automatiquement en bas de toutes les pages, en configurant le paramètre $wgW4GRB_Settings['auto-include'] 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[edit]

  • {{#w4grb_rate:[nom de page]}} affiche la barre de vote pour [nom de page], pour une notation de 0 to 100%.
  • {{#w4grb_rawrating:[nom de page]}} affiche la note de [nom de page].
  • <w4grb_ratinglist/> 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

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.

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

  • 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[edit]

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.

Installation[edit]

Dans tous les cas[edit]

1. Créez un nouveau dossier dans votre dossier dossier-du-wiki/extensions/.
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:
require_once( $IP.'/extensions/[le dossier que vous avez créé]/w4g_rb.php');
$wgW4GRB_Path='/extensions/[le dossier que vous avez créé]';
(bien entendu, remplacez le chemin par celui qui convient!)

Migrer à partir Rating Bar v1.1[edit]

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 #Dans tous les cas ci-dessus.
2. Allez dans le dossier de l'extension et éditez les paramètrs lignes 25-32 de SpecialW4GRBMigrate.php.
3. Ajoutez require_once( $IP.'/extensions/[le dossier que vous avez créé]/SpecialW4GRBMigrate.php'); dans LocalSettings.php juste après require_once( $IP.'/extensions/[le dossier que vous avez créé]/w4g_rb.php');
4. Allez sur la page spéciale de votre wiki Special:W4GRBMigrate. La migration va se faire automatiquement.
5. Supprimez require_once( $IP.'/extensions/[the folder you created]/SpecialW4GRBMigrate.php'); de LocalSettings.php et (optionnel, après avoir vérifié que tout marche bien) supprimer l'ancienne table ratingbar.

Configuration[edit]

Vous pouvez définir les paramètres suivants dans LocalSettings.php (ajoutez-les après la ligne qui inclut l'extension):

  • $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.

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 w4g_rb-canvote. 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;

Utilisation[edit]

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?[edit]

cf la liste sur la VO de cette page.

Autres langues : English  • français