{"id":51,"date":"2008-01-18T17:25:25","date_gmt":"2008-01-18T15:25:25","guid":{"rendered":"http:\/\/nyams.planbweb.com\/blog\/2008\/01\/18\/refgenerator-mon-premier-plugin-wordpress\/"},"modified":"2008-01-18T17:25:25","modified_gmt":"2008-01-18T15:25:25","slug":"refgenerator-mon-premier-plugin-wordpress","status":"publish","type":"post","link":"https:\/\/nyamsprod.com\/blog\/refgenerator-mon-premier-plugin-wordpress\/","title":{"rendered":"RefGenerator, mon premier plugin WordPress"},"content":{"rendered":"<div class=\"message warning\">\n<p><strong>Attention:<\/strong> Les informations de ce billet sont susceptibles d'&ecirc;tre obsol&egrave;tes car vieux de plus 2 ans.<\/p>\n<p><strong>Warning: <\/strong> The information you are reading may be obsolete, this post was published more than 2 years ago.<\/p>\n<\/div><p class=\"alert\"><strong>Attention une nouvelle version du plugin est maintenant <a href=\"http:\/\/nyams.planbweb.com\/blog\/refgenerator\/\">t\u00e9l\u00e9chargeable<\/a>.<\/strong><\/p>\n<p>Apr\u00e8s avoir cr\u00e9\u00e9 un template quasiment <em>from scratch<\/em> pour mon blog, je me suis dis que je ne m&#8217;arr\u00eaterais pas en si bon chemin et j&#8217;ai donc \u00e9cris mon premier <a title=\"Comment cr\u00e9er un plugin WordPress\" href=\"http:\/\/codex.wordpress.org\/Plugin_API\">plugin WordPress<\/a>. En fait je pourrais faire facilement 5 articles pour expliquer comment RefGenerator a \u00e9t\u00e9 \u00e9crit mais je n&#8217;ai pas le temps pour l&#8217;instant. Peut-\u00eatre qu&#8217;un autre jour j&#8217;expliquerais ma d\u00e9marche, mais pas aujourd&#8217;hui, pas maintenant.<!--more--><\/p>\n<h3>La conception<\/h3>\n<p>G\u00e9n\u00e9ralement, lorsque je code un script ou une application, je me demande toujours si<\/p>\n<ol>\n<li>cela vaut la peine ;<\/li>\n<li>cela n&#8217;a pas d\u00e9j\u00e0 \u00e9tait fait ;<\/li>\n<li>et finalement si j&#8217;ai les reins solides pour commencer et surtout finir ce que j&#8217;ai entamer \ud83d\ude09 ;<\/li>\n<\/ol>\n<p>Pour ce script, il m&#8217;a fallu r\u00e9ellement 3 jours (pas \u00e0 100%) pour le coder mais pr\u00e8s de 2 \u00e0 3 mois pour vraiment me mettre en condition pour le r\u00e9aliser. Au d\u00e9but ce n&#8217;\u00e9tait qu&#8217;une extension de mon template, et maintenant c&#8217;est un plugin totalement ind\u00e9pendant de celui-ci et \u00e7a c&#8217;est cool. Cela veut dire qu&#8217;il est utilisable par n&#8217;importe qu&#8217;elle blog WordPress 2+.<\/p>\n<h3>RefGenerator<\/h3>\n<p>Bon tr\u00e8ves de bavardage, \u00e0 quoi sert RefGenerator ? <strong>C&#8217;est un plugin 2 en 1<\/strong> qui sert \u00e0 lister en fin d&#8217;article tous les liens externes utilis\u00e9s dans celui-ci. En fait, il g\u00e9n\u00e8re la liste des r\u00e9f\u00e8rences externes utilis\u00e9es pour \u00e9crire votre article, et l&#8217;ajoute en fin d&#8217;article trier dans l&#8217;ordre d&#8217;apparition du lien dans l&#8217;article.<\/p>\n<p>Pourquoi est-ce un plugin 2 en 1 ? Tous simplement par ce que RefGenerator peut \u00eatre utilis\u00e9 de 2 mani\u00e8re distinctes, via PHP ou via le javascript pour g\u00e9n\u00e9rer la liste des r\u00e9f\u00e9rences. Chacune de ces m\u00e9thodes ayant des avantages et des inconv\u00e9nients.<\/p>\n<p>Est-ce que ce plugin est pour moi ? Cela d\u00e9pend de la finalit\u00e9 de votre blog et surtout de votre besoin ou non d&#8217;un tel plugin. Personnellement je l&#8217;ai d\u00e9velopp\u00e9 parce qu&#8217;on me la demand\u00e9 gentiment et que je voulais comprendre comment fonctionner les plugins sous WordPress. Du coup, j&#8217;ai retir\u00e9 l&#8217;extension de mon template et je l&#8217;ai r\u00e9-implanter via RefGenerator dans mon blog.<\/p>\n<h3>Comment \u00e7a marche<\/h3>\n<ol>\n<li>T\u00e9l\u00e9charge le fichier compress\u00e9 qui se trouve en fin d&#8217;article et d\u00e9compresse-le sur ton ordinateur.<\/li>\n<li>Transfert le dossier d\u00e9compress\u00e9 dans le r\u00e9pertoire <code>plugins <\/code>de ton installation wordpress.<\/li>\n<li>Rend-toi ensuite dans la partie administration de ton wordpress, dans l&#8217;onglet Plugins et active RefGenerator.<\/li>\n<li>Puis, toujours dans la partie administration sous l&#8217;onglet Options de WordPress clique sur le sous-onglet RefGenerator qui vient de se rajouter.<\/li>\n<li>Configure RefGenerator en fonction de la m\u00e9thode utilis\u00e9e pour g\u00e9n\u00e9rer la liste des liens externes de tes articles.<\/li>\n<\/ol>\n<h3>Quelle m\u00e9thode choisir ?<\/h3>\n<p>Si vous venez d&#8217;installer WordPress et que vous n&#8217;avez pas l&#8217;habitude de bidouiller dans les templates, la m\u00e9thode PHP vous conviendra, <em>c&#8217;est le cas, je pense, de la majorit\u00e9 des gens qui vont t\u00e9l\u00e9charger ce plugin<\/em>. En revanche, si vous \u00eates un utilisateur chevronn\u00e9 de WordPress et que modifier vos templates ne vous fait pas peur, alors la m\u00e9thode javascript vous sera plus utile. Quelque soit la m\u00e9thode utilis\u00e9e, j&#8217;esp\u00e8re que le plugin r\u00e9pondra positivement \u00e0 vos attente.<\/p>\n<h3>Last but not least<\/h3>\n<p>Si vous changer le nom de l&#8217;attribute <code>class <\/code> de la balise qui contient la liste de liens, n&#8217;oubliez pas de modifier les fichiers CSS qui se trouvent dans le sous dossier <code>css <\/code> du r\u00e9pertoire du plugin. Veuillez trouver ci-dessous le dossier compresser de refGenerator au format <code>zip<\/code> et au format <code>tgz<\/code>, choisissez le format de compression que vous pr\u00e9f\u00e9rez.<\/p>\n<p class=\"alert\"><strong>Attention une nouvelle version du plugin est maintenant <a href=\"http:\/\/nyams.planbweb.com\/blog\/refgenerator\/\">t\u00e9l\u00e9chargeable<\/a>.<\/strong><\/p>\n<p><small><del datetime=\"2008-01-23T06:12:16+00:00\">La page d&#8217;administration du plugin contient des  fautes d&#8217;orthographe du \u00e0 mon empressement \u00e0 sortir le plugin.<\/del> Pour traduire dans votre langue le plugin, il vous suffit. de vous rendre dans le dossier <code>langs<\/code> dans lequel vous retrouverez les fichiers de langues. <del datetime=\"2008-01-23T06:12:16+00:00\">Si vous avez l&#8217;\u00e2me d&#8217;un professeur de fran\u00e7ais<\/del>, Vous devez d&#8217;abord copier le fichier (.po) en le renommant en fonction de votre langue <del datetime=\"2008-01-23T06:12:16+00:00\">et corriger les fautes d&#8217;orthographe<\/del> et ensuite mettre \u00e0 jour son fichier .mo via la commande <code><a title=\"explication de la traduction dans WordPress\" href=\"http:\/\/fr.wikipedia.org\/wiki\/Gettext\">msgfmt<\/a> refgen-xx_XX.po -o refgen-xx_XX.mo<\/code> sous Unix\/linux\/BSD ou en utilisant <a title=\"PoEdit : Programme de traduction de logiciels libres\" href=\"http:\/\/www.poedit.net\/download.php\">PoEdit<\/a> sous Windows. Le suffixe <code>xx_XX<\/code> est l&#8217;identifiant de la langue de votre WordPress. Envoyez-moi les fichiers modifi\u00e9s et je mettrai \u00e0 jour RefGenerator le plus rapidement possible pour la joie de tous.<\/small><\/p>\n","protected":false},"excerpt":{"rendered":"<p>RefGenerator, mon premier plugin pour wordpress. Il permet de cr\u00e9er une liste de tous les liens externes utilis\u00e9s dans un article et de les affich\u00e9s en fin d&#8217;article.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[5],"tags":[138,292,421,452,574],"class_list":["post-51","post","type-post","status-publish","format-standard","hentry","category-web","tag-css-layout","tag-javascript","tag-plugin","tag-refgenerator","tag-wordpress"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/posts\/51","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/comments?post=51"}],"version-history":[{"count":0,"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/posts\/51\/revisions"}],"wp:attachment":[{"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/media?parent=51"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/categories?post=51"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/nyamsprod.com\/blog\/wp-json\/wp\/v2\/tags?post=51"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}