Starbox Voting ajoute un système de vote dans vos pages et articles

Voici une petite extension tout fraichement sortie dans la banque de plugins de WordPress, puisqu’elle ne date que du 25 février dernier. Depuis cette date, elle a déjà subi plusieurs mises à jour, en grande partie par ma faute vu que je n’arrivais pas à la faire fonctionner correctement.

Alors, comme le blog de l’auteur, jingen.he, est principalement en chinois et partiellement en anglais et qu’il y a quelques erreurs sur sa présentation de l’extension, je vais vous le faire en français.

Pour télécharger l’archive de l’extension, c’est ici. Pour l’installer, c’est comme d’habitude. Soit vous décompressez l’archive et glissez le répertoire starbox-voting dans votre répertoire wp-content/plugins/ via votre FTP, soit vous utilisez le système d’installation d’extensions automatique de WordPress.

ATTENTION : cette extension crée une nouvelle table dans votre base de données. Normal, les votes doivent bien être enregistrés quelque part !

Une fois l’extension installée et activée, un onglet Starbox apparait dans le menu Réglages (WordPress 2.7.1). Voici la page sur laquelle vous tombez dans votre administration :

Ah oui, là la page est en français parce que j’ai traduit l’extension. Comme j’ai envoyé les fichiers de traduction à l’auteur, je pense que d’ici très peu de temps l’archive contiendra le fichier de langue française en natif, je ne le mets donc pas en téléchargement.

Donc, cette page de configuration vous permet de choisir le style de votre système de vote. Il n’y a pas grand chose à expliquer, les images parlent d’elles-mêmes.

Toutefois, le vote ne fonctionne pas comme ça. Il faut appeler la fonction correspondante là où vous souhaitez qu’elle apparaisse à l’aide de la ligne de code suivante :

<?php if(function_exists('starbox_voting')){starbox_voting(get_the_ID());} ?>

Pour ma part, je ne l’ai mise que dans les articles (fichier single.php) de la façon suivante :

<div class="post_content">
<?php the_content("<br />" . "Lire la suite de&nbsp;" . "&quot;" . the_title('', '', false) . "&quot;"); ?>

<?php if(function_exists('starbox_voting')){starbox_voting(get_the_ID());} ?>
</div>

<?php if ( function_exists('the_tags') ) { the_tags( '<p>Tags : ', ', ', '</p>'); } ?>

</div>

Et vous pouvez voir ci-dessous que ça fonctionne très bien. Libre à vous de placer le code où bon vous semble (index.php, page.php).

Quelques remarques :

1/ Concernant la base de données, la version 2.0.1 de Starbox Voting crée une table nommée wp_starboxvoting. Si vous êtes dans le même cas que moi, à savoir que le préfixe des tables de votre blog n’est pas wp_, pensez à modifier le nom de la table en question dans votre base de données sinon les votes ne seront pas enregistrés.

Cette broutille a été remontée à jingen.he qui fera sans nul doute la modification nécessaire dans la prochaine version de l’extension.

MAJ : la version 2.0.2 corrige le bug de la création de la table. Belle réactivité de la part de l’auteur !

2/ Dans star_view.php à la ligne 39, afin d’avoir le vote en français dans mes articles, j’ai remplacé :

$style .= "indicator: '#{average} rating from #{total} votes',";

par :

$style .= "indicator: 'Note moyenne : #{average} (#{total} votes)',";

Voilà, c’est tout, votez bien !