Par contre, grosse grosse déception durant la mise à jour depuis les dépôts SVN: plus moyen de mettre à jour les plugins directement via la commande svn up. Elle renvoie une demande de logon (celle de chaque dev de chaque plugin apparemment car pour les miens mon pass a fonctionné). Bref, j’imagine qu’ils ont trifouillé un truc tout foireux dans la configuration du serveur de svn.wp-plugins.org et j’espère sincèrement que ce sera très rapidement résolu. Parce que me remettre à gérer les mises à jour de plugins à la main, ça me fatigue rien que d’y penser :p

Présent jusqu’à la version 2.3.1, le bookmarklet WordPress était un grand absent dans la version 2.5. Il devrait marquer son grand retour dans la 2.6 dans une nouvelle version améliorée. Vous trouverez ce bookmarklet dans la fenêtre de rédaction d’articles et il vous suffira de le glisser dans votre barre personnelle (Firefox) pour pouvoir ensuite vous en servir.

Un clic sur ce bookmarklet vous permettra donc de publier le plus simplement et rapidement du monde :

• du texte
• une photo
• une citation
• une vidéo

Et comme vous avez pu le voir dans les captures précédentes, à chaque fois l’éditeur s’adapte au contenu à publier en proposant les options les plus utiles. Voilà donc une fonctionnalité bien pratique pour bloguer rapidement depuis une page web qui revient sous une forme largement améliorée et qui devrait en ravir plus d’un. Ce n’est clairement pas une des killer features de cette future mouture de WordPress mais j’ai trouvé les nouveautés qui lui ont été apportées vraiment bien vu.

Plus qu’à attendre le 7 juillet 2008 pour pouvoir en profiter pleinement.

Déjà, pour ceux non-habitués à ce genre d’outils, on pourrait dire grossièrement que le versioning de documents représente le procédé permettant de conserver les différents états d’un document à travers le temps afin de pouvoir les comparer et éventuellement revenir à une version précédente après une modification indésirable. C’est le genre de procédé qu’on utilise par exemple sur les wiki.

WordPress 2.6 intégrera donc la possibilité de garder les différentes versions de vos billets ce qui sera, à mon avis, une fonctionnalité très appréciée par les blogs collectifs par exemple. Mais aussi par l’auteur pointilleux qui appréciera de pouvoir comparé les différentes versions de son billet longuement travaillé et revu avant ou après sa publication.

Voyons concrètement comment cela se présente dans la version actuelle (la fonction pouvant encore très largement évoluée d’ici la sortie de la version finie).

1. dans un premier temps, j’ai rédigé un court billet que j’ai enregistré et publié
2. j’ai ensuite édité ce billet publié pour y apporter quelques modifications et le ranger dans la bonne catégorie et enregistré les modifications
3. désormais, on peut voir afficher tout en bas de la page de rédaction la liste des versions (post revisions) existantes du billet
4. si vous cliquez sur un des liens, vous pourrez consulter la révision concernée dans la page de gestion des révisions du billet
5. de là vous pourrez restaurer votre texte à une version antérieur et surtout, sélectionner une version à comparer à l’actuel. WordPress affichera alors les différences en marquant les ajouts et les retraits entre le texte actuel et la version sélectionnée

Voilà brièvement le fonctionnement actuel de ce futur outil fort sympathique et déjà plus qu’utilisable en l’état (belle performance). L’impact sur la base ne devrait pas être dramatique mais alourdira quand même sensiblement le tout car en fait, chaque version et même restauration (?) correspond à un enregistrement dans la table wp_posts. Je n’ai pas trouvé d’options actuellement permettant de limiter le nombre de révisions maximum pour un article ou d’en supprimer facilement. Ceci dit, j’espère que ça sera inclus dans la version finale de WordPress 2.6 (et sinon je ne doute pas qu’un plugin se chargera de cette délicate mission de nettoyage :p).

C’est de la musique d’avenir proche mais j’espère que cette petite incursion dans la future version de notre plateforme de blogs préférée vous aura plu.

Pour les plus téméraires curieux d’entre vous, vous pouvez tester cette version de WordPress depuis les dépôts Subversion. Mais prenez bien garde de réserver ceci à un test en local et surtout pas sur un blog en production, c’est une version en développement très hautement instable et ce serait à vos risques et périls !!!!

Imaginons que nous souhaiterions utiliser deux styles spécifiques dans nos articles :

• un premier qui permet d’insérer un encart aligner à gauche ou droite de notre page pour y insérer des données complémentaires au contenu, un peu à la façon des encarts dans les journaux. Nous appellerons ce style encart
• un second pour mettre en évidence un contenu. Nous l’appellerons warning.

Dans le fichier style.css de notre thème, nous allons créer les règles pour ces deux classes :

.encart{
	width: 150px;
	border: 1px solid black;
	margin: 5px;
}

.warning{
	background: #ffb49d;
	font-weight: bold;
}

Dans notre fichier functions.php, nous allons créer une première fonction pour le shortcode de nos encarts. La fonction devra prendre pour paramètre le type d’alignement souhaité (gauche ou droite) et récupérer le contenu situé entre les balises du shortcode pour le mettre en forme. Soit la fonction suivante :

// [encart align=left|right]
function encart_func($atts, $content = null){

    // s'il n'y a pas de contenu, on s'arrête là...
    if (is_null($content))
    return false;

    // on extrait les paramètres pour savoir si on aligne le bloc à droite ou à gauche. Par défaut, à gauche
    extract(shortcode_atts(array('align' => 'left'), $atts));

    if ( 'left' == $align ){
        $class = "alignleft";
    } elseif ( 'right' == $align ) {
        $class = "alignright";
    }

    // on crée notre encart
    $output = '<div class="encart '. $class .'">' . $content . "</div>\n";

    // on affiche le tout
    return $output;
}
add_shortcode('encart', 'encart_func');

C’est le second paramètre de notre fonction, $content qui va permettre de récupérer le contenu compris entre les balises du shortcode. Il est initialisé avec une valeur null par défaut ce qui permettra d’exécuter la fonction quand même (si besoin est) en l’absence de contenu et/ou de tester ceci à l’aide de is_null($content) et de déterminer un comportement approprié. Dans mon cas, sans contenu, j’arrête la fonction car elle n’aurait plus aucun sens (créer un div vide ne me servirait à rien).

Le paramètre $align permettra quand à lui d’ajouter la classe alignleft ou alignright qui fera “flotter” le contenu du côté désiré dans notre article.

Pour insérer un encart dans nos billets, il suffira désormais d’écrire [encart align="right"]Ceci est un petit encart de test… Qu’en pensez-vous ?[/encart]. Ci-dessous, un exemple du résultat obtenu :

Nous allons maintenant faire sensiblement pareil pour le shortcode warning :

// [warning]$content[/warning]
function warning_func($atts, $content = null){
    if ( is_null($content) )
    return false;

    $output = '<div class="warning">'. $content ."</div>\n";
    return $output;
}
add_shortcode('warning', 'warning_func');

Voilà, nos deux shortcodes sont opérationnels. Maintenant, il se pourrait très bien que nous souhaitions mettre du contenu de type “warning” dans un encart ! Cependant, si on tente d’écrire dans un billet le code [encart align="right"][warning]ceci est un encart auquel il faut prêter attention ![/warning][/encart], nous risquons d’être surpris. En effet, seul le shortcode [encart] sera correctement interprété et pas le warning. Le résultat ne correspondra donc pas à notre attente.

Pour imbriquer des shortcodes, nous devons explicitement autoriser les “parents” à exécuter les shortcodes qui pourraient leur être imbriqués à l’aide de la fonction do_shortcode(). Nous allons donc modifier la fonction encart_func() pour que son contenu puisse avoir des shortcodes. Changeons la ligne $output = ... ainsi :

$output = '<div class="encart '. $class .'">' . do_shortcode($content) . "</div>\n";

Cette simple modification nous permettra d’obtenir le résultat attendu : [encart] peut contenir des [warning] (mais pas l’inverse !).

Il existe toutefois une limitation à cette technique ! Il est en effet impossible d’imbriqué des shortcodes du même nom actuellement, ainsi [encart][encart]mon test[/encart][/encart] par exemple ne fonctionnera pas correctement !

Voilà, nous avons terminé notre tour d’horizon des shortcodes dans WordPress 2.5. Il reste bien sûr quelques fonctionnalités à découvrir (je vous renvoie à la documentation officielle pour ça) mais nous avons déjà de quoi bien nous amuser avec ça ! N’hésitez pas à tester et à me faire part de vos remarques, questions ou commentaires…

articles précédents sur les shortcodes :

• WordPress 2.5 et les ShortCodes #1 - Présentation
• WordPress 2.5 et les ShortCodes #2 - les paramètres

Imaginons à nouveau une fonctionnalité totalement inutile en soit à titre d’exemple : un shortcode pour insérer rapidement et “proprement” une vidéo issue de Youtube dans nos billets ! Pour que ce code soit ré-utilisable, nous devrons pouvoir passer en paramètre de notre shortcode l’identifiant de la vidéo à afficher.

À titre d’exemple (et contribuer à la bonne cause), je vais utiliser la vidéo du 118 project dont j’avais déjà parlé et dont l’identifiant sur Youtube est gcHsyatfDhc (vous pouvez trouver ce code dans l’URL des vidéos).

Nous allons donc ré-ouvrir le fichier functions.php de notre thème et y insérer le code suivant :

// Ce code est indicatif et non-optimisé pour être utilisé tel quel en production !
// [youtube vid="vid_code"]
function youtube_func($atts){
    extract(shortcode_atts(array('vid' => ''), $atts));

    if ( '' == $vid ){
        return "<span class=\"error\">Vous n'avez pas donné de lien valide !</span>\n";
    } else {
        return '<object type="application/x-shockwave-flash" width="425" height="350" data="http://www.youtube.com/v/' . $vid . '&hl=en"><param name="movie" value="http://www.youtube.com/v/' . $vid . '" /></object>';
    }
}
add_shortcode('youtube', 'youtube_func');

C’est tout ! Désormais pour insérer une vidéo issue de Youtube dans nos billets, il suffira d’insérer le shortcode [youtube] avec l’identifiant de la vidéo en paramètre. Par exemple : [youtube vid="gcHsyatfDhc"].

Alors détaillons un peu cet extrait de code car il mérite quelques éclaircissements. Vous remarquerez tout d’abord qu’on ne va pas passer à notre fonction youtube_func notre attribut vid directement mais un tableau $atts d’où sera extrait notre attribut par la suite. En fait, les fonctions définissant un shortcode n’acceptent que deux arguments précis : $atts qui sera un tableau contenant tous les attributs que l’on veut passer à notre fonction et $content qui servira à stocker le contenu situé dans le shortcode (nous verrons cela dans un prochain article ;)).

Pour extraire notre attribut, nous allons donc utiliser la fonction extract() (chose à laquelle on est habitué si on a déjà codé des widgets par exemple) et la fonction shortcode_atts(). shortcode_atts() sert à définir les valeurs par défaut des attributs (dans mon cas, j’ai défini $vid comme étant vide par défaut) et de nettoyer les attributs non-reconnus ou non-prévus par la fonction. Elle a donc deux attributs obligatoires et se présente sous la forme shortcode_atts($default_array, $atts) où $default_array est le tableau associatif contenant les noms des attributs attendus et leur valeur respective par défaut et $atts représente le tableau passé à notre fonction.

Afin de bien mesurer l’impact de ce système, imaginons la fonction suivante :

// [testAttributes]
function testAttributes_func($atts){
    extract(shortcode_atts(array(
        'title' => 'default_title',
        'att1' => 'mon attribut'
    ), $atts));

    return $title . ' ' . $att1;
}
add_shortcode('testAttributes', 'testAttributes_func');

Et appelons-le dans un billet en mettant ceci [testAttributes att1="c'est excellent !" att2="cet attribut sera supprimé"]. Si vous publiez cet billet, vous verrez que le titre aura été inséré avec sa valeur par défaut puisque non défini dans l’appel, l’attribut att1 sera affiché comme attendu et l’attribut att2 aura été “nettoyé” car il n’était pas prévu par la fonction. Tout fonctionne donc comme prévu !

Pour terminer, vous aurez remarquez que j’utilise des return et non des echo dans cet article pour le rendu à afficher par les shortcodes. Si vous utilisez echo pour les sorties de vos shortcodes, attendez-vous à des surprises ! En effet, comme les shortcodes sont parsés par WordPress 2.5 au début de l’exécution de la boucle, tout ce qui sera en “echo” sera injecté au début du billet et ce quelque soit l’endroit où vous avez insérer votre shortcode dans l’article. Pensez donc à toujours bien utiliser return pour vos codes de sorties…

Voilà, c’est tout pour cette seconde partie sur les shortcodes dans WordPress 2.5.

autres articles sur les shortcodes :

• WordPress 2.5 et les ShortCodes #1 - Présentation
• WordPress 2.5 et les ShortCodes #3 - contenu et imbrication

Le but de cette API est de proposer un ensemble de fonctions pour faciliter l’insertion de macro-commandes dans le contenu d’un billet. Ok j’en conviens, dis comme ça c’est assez abstrait, alors nous allons illustrer cela en codant une première petite fonction parfaitement inutile : un shortcode pour insérer un “Hello World” (histoire de faire original).

Il faut tout d’abord savoir qu’on peut programmer le code “exécutable” associé à un shortcode aussi bien au niveau du thème en éditant le fichier “functions.php” que dans un plugin. Pour se facilier la tâche, nous allons travailler dans le fichier “functions.php” de notre thème.

Dans votre fichier “functions.php” donc, ajoutez le code suivant :

// function associée au shortcode [hello]
function hello_func(){
    echo "Hello World !";
}
add_shortcode('hello', 'hello_func'); // ajout du shortcode hello appellant la fonction hello_func()

La fonction hello_func() représente le code qui sera exécuté lorsqu’on insérera le shortcode [hello] dans nos billets. La fonction add_shortcode quand à elle sert à définir le shortcode qui sera utilisé dans nos billets. Elle a deux arguments obligatoires, le premier étant le tag qui sera utilisé dans nos billets et le deuxième la fonction à exécuter : add_shortcode('tag_à_insérer', 'fonction_à_exécuter')

Donc si maintenant vous écrivez un nouveau billet, tapez dans votre texte le shortcode [hello] (notez bien l’utilisation des crochets pour délimiter le nom de la commande) et publiez votre billet.

Comme vous pouvez le constater, le shortcode [hello] a bien été remplacer par le texte “Hello World !” dans notre billet.

Voilà pour cette introduction aux shortcodes dans WordPress 2.5. Nous verrons dans un prochain billet des exemples de shortcodes plus complexes et les applications un peu plus concrètes que l’on pourra en faire.

autres articles sur les shortcodes :

• WordPress 2.5 et les ShortCodes #2 - les paramètres
• WordPress 2.5 et les ShortCodes #3 - contenu et imbrication

Apparemment tout fonctionne plutôt bien, ça porte ses fruits de tester les versions svn avant la sortie d’une finale Si toutefois vous trouviez des petits bugs ou autres qui vous sembleraient dûs à ce changement de version, n’hésitez pas à m’en faire part, je vous en serais vraiment reconnaissant !

Au passage, j’ai désactivé mon plugin replacebsbytr car celui-ci n’est plus utile sur WP 2.5 ! Mais je vais travailler sur une nouvelle mouture de celui-ci car si le nouveau système de liens entrants permet de suivre d’autres fils que BlogSearch pour traquer les liens entrants, leur présentation laisse vraiment à désirer. En effet, il semblerait que le nouveau widget, sous des airs “personnalisables”, ait été pensé et optimisé pour le flux proposé par le moteur de Google.

téléchargement

le téléchargement se fait désormais depuis le dépôt WordPress.org

[bhJaikuWidget]

installation

1. décompressez l’archive dans votre répertoire ‘/wp-content/plugins’. Si vous uploadez, soyez sûr d’uploader le dossier racine. N’envoyez que les fichiers php dans ‘/wp-content/plugins’.
2. Activez le plugin depuis le menu ‘Plugins’ de votre console WordPress
3. Allez dans le sous-menu ‘Thème » Widgets’ et ajoutez les widgets ‘Jaiku’ à votre sidebar
4. Configurez les widgets (n’oubliez pas de préciser combien de widgets vous désirez ni votre identifiant Jaiku)
5. Rien de plus

capture d’écran

changelog

• 0.2.2 - utilisation de l’adresse directe du flux RSS pour éviter un problème de timeout mettant le plugin en échec quand les serveurs de Jaiku sont saturés
• 0.2.1
  • bug des “5 mises à jours” corrigé - le réglage revenait à la valeur par défaut (5) quand on éditait la configuration du widget
  • bug “espace dans le compte corrigé” - mettre un espace en début ou fin du nom d’utilisateur renvoyait une erreur “compte jaiku inconnu”
  • ajout de captures d’écran dans la description du plugins dans le dépôt
• 0.2 - ajout du support “mult-widgets”, désormais vous pouvez ajouter jusqu’à 9 widgets dans votre sidebar pour suivre plusieurs comptes Jaiku simultanément
• 0.1.1 - corrections mineures : ajout de la limite de 30 mises à jour maximum (limite du flux RSS public) et avertissement dans le champ “Votre identifiant Jaiku” en cas de nom de compte erroné ou ne générant pas de flux RSS valide
• 0.1 - initial release

notes

Ce plugin est prêt pour l’internationalisation. Il existe actuellement en anglais et en français, n’hésitez pas à me faire parvenir vos corrections éventuelles ou vos propres fichiers de langues si vous désirez que je les ajoute au paquet.

N’hésitez pas à me laisser un commentaire ou à me contacter pour me faire part de vos impressions, critiques, remarques et autres suggestions concernant ce plugin.

Faire un don

Ainsi, les composants du futur dashboard étant des widgets, ils seront plus facilement paramétrable et c’est ce qui permettra de modifier la source RSS des liens entrants comme vous pouvez le voir sur la capture d’écran ci-après.

Cette nouveauté est vraiment une bonne chose et je l’applaudis des deux mains. Le seul regret c’est que dès avril prochain mon plugin replacebsbytr n’aura plus de raison d’être, sniff… C’est ça qu’on appelle un dommage collatéral non ?

Après quelques tests et échange d’emails, il a ensuite repris cette base qu’il a largement optimisé en utilisant la classe PagerankSeo au lieu d’un fournisseur externe comme utilisé dans le hack de départ et dans l’ébauche du plugin.

Il a ainsi publié la version 1.0 du plugin “View posts Pagerank” aujourd’hui et si vous voulez pouvoir suivre l’évolution du Pagerank de vos articles en toute simplicité depuis votre console, je vous invite à le télécharger et le tester au plus vite !