Introduction

Refgenerator est un plugin wordpress qui sert à lister en fin d’article tous les liens externes utilisés dans celui-ci. En fait, il génère la liste des réfèrences externes utilisées pour écrire votre article, et l’ajoute en fin d’article trier dans l’ordre d’apparition du lien dans l’article.

Refgenerator est un plugin wordpress 2 en 1, pourquoi ? Tous simplement par ce que RefGenerator peut être utilisé de 2 manière distinctes, via PHP ou via le javascript pour générer la liste des références. Chacune de ces méthodes ayant des avantages et des inconvénients.

Est-ce que ce plugin est pour moi ? Cela dépend de la finalité de votre blog et surtout de votre besoin ou non d’un tel plugin. Personnellement je l’ai développé parce qu’on me l’a demandé gentiment et que je voulais comprendre comment fonctionner les plugins sous Wordpress. Du coup, j’ai retiré l’extension de mon template et je l’ai ré-implanter via RefGenerator dans mon blog.

Dernière précision, ce plugin peut-être trituré, torturé, soumis à la question ordinaire et extraordinaire et donc modifié à souhait par vous s’il ne répond pas exactement à vos besoins, un simple lien vers cette page me suffira amplement.

Les nouveautés dans RefGenerator 2.0

RefGenerator 2.0 est une ré-écriture complète du plugin précédent, mais ne vous inquiétez pas vous n’avez rien à changer dans votre configuration car il se comporte de la même manière que son prédécesseur, voire mieux :

Il y a d’abord les bugs suivants qui ont été corrigés :

  • J’ai corrigé un bug d’affichage lorsque le lien n’avait pas d’attribut title ;
  • J’ai enlevé les références double de la liste ;

En plus de corrigé ces bugs de nouvelles fonctionnalités ont été rajoutées :

  • On peut désormais décider dans quel template on désire voire le plugin fonctionner ( ex: RefGenerator fonctionnera pour le template : single.php mais pas pour archive.php ) ;
  • Le plugin s’active et se dé-active proprement dans votre blog en laissant votre configuration intacte ;
  • La section admin a été repensée pour qu’elle s’intègre mieux avec le nouveau design de Wordpress 2.5+;

Et bien sûr le code PHP et javascript utilisés ont été revu. Voila pour les nouveautés.

Installation

C’est très simple il suffit de :

  1. Téléchargez le fichier compressé et décompresse-le sur ton ordinateur.
  2. Transfert le dossier décompressé dans le répertoire plugins de ton installation wordpress.
  3. Rend-toi ensuite dans la partie administration de ton wordpress, dans l’onglet Plugins et active RefGenerator.
  4. Puis, toujours dans la partie administration sous l’onglet Plugins de Wordpress clique sur le sous-onglet RefGenerator qui vient de se rajouter.
  5. Configure RefGenerator en fonction de la méthode utilisée pour générer la liste des liens externes de tes articles.

Utilisation

Si vous êtes un utilisateur chevronné, et que le HTML, le javascript et le PHP, ne vous font pas peur, je vous recommande l’utilisation de la méthode avancé du plugin. Celle-ci génère la liste via javascript mais vous donne une grande liberté de présentation du résultat.

Si en revanche seul la présentation des références vous intéresse, alors optez pour la version simple, qui comme son nom le suggère et facile a utiliser.

Quelque soit la méthode utilisée, n’oubliez pas que vous pouvez modifier l’aspect de la liste en modifiant le CSS contenu dans le sous-dossier css qui se trouve dans le dossier refgenerator.

Internationalisation/Localisation

Bien que j’utilise la langue de molière pour présenter RefGenerator, son code et ses commentaire ont été rédigé en anglais afin de rendre le plugin plus accessible. Néanmoins, pour ceux qui voudrons le traduire dans leur langue j’ai mis à disposition les fichiers adéquats pour réaliser la localisation du plugin dans tout autre langue.  Si vous avez réaliser ce travail, n’hésitez pas à me faire parvenir la version localiser du plugin dans votre langue de prédilection je me ferais une joie de rajouter votre localisation dans le dossier compressé du plugin.

To all my international friends, even though I wrote this presentation page in french, RefGenerator is written and is configured to run by default in english . If you happen to translate the plugin in another language other than english and french, you can send me your translated version so I can include it in an updated package so that everyone can enjoy and configure this plugin with ease in their native tongue.

Téléchargements

  1. refgenerator.zip