Nous avons déjà vu comment gérer des shortcodes sous WordPress pour faciliter l’insertion de certains contenus récurrents dans vos pages ou articles. Nos shortcodes utilisaient jusque-là différents attributs qui pouvaient d’ailleurs aussi être sans nom comme on l’a vu la dernière fois. Mais vous pensiez réellement qu’on avait fait le tour de l’API ? En réalité il nous faut encore voir quelques détails pour être sûrs d’avoir vu tout ce dont nous avons besoin, et c’est justement ce qu’on va faire ici.

Du contenu dans nos shortcodes

Si vous êtes familier de WordPress, vous avez sûrement déjà croisé des shortcodes comme on en crée depuis les premières parties, mais pas seulement. Car un shortcode peut posséder une autre forme que celle utilisée jusque maintenant, une forme qui rappelle un peu les balises HTML : [shortcode]contenu[/shortcode].

Plutôt que de n’utiliser qu’une forme simple comme on le fait depuis le début, on peut en effet choisir d’utiliser une forme ouvrante / fermante. Ça a plusieurs avantages et inconvénients, et il vous revient de faire la part des choses pour savoir quelle solution vous conviendra le mieux.

Quoiqu’il en soit, gérer du contenu est d’une simplicité enfantine, tellement que c’en est presque risible de l’aborder : il suffit en effet de modifier notre fonction de callback, celle qui est appelée chaque fois que WordPress trouve l’un de nos shortcodes. Cette fonction peut en effet supporter un deuxième attribut qui contiendra justement le contenu envoyé. Peut-on seulement faire plus simple ?

function transformer_hello($atts, $contenu) {
	return 'Hello World! ' . $contenu;
}
?>

Dans cet exemple tiré de la première partie, nous modifions ce qui sera affiché en concaténant simplement le contenu du shortcode à « Hello World!« . Ainsi, si l’utilisateur envoie [hello]toto[/hello], alors le shortcode affichera automatiquement « Hello World! toto« .

C’est tout ce qu’il y a à savoir sur la gestion d’un contenu dans les shortcodes. Le détail intéressant, c’est que vous pouvez bien sûr utiliser du contenu et des attributs, afin de créer un shortcode des plus puissants. Et ça c’est cool.

Plusieurs shortcodes pour une même fonction de callback

Nous arrivons ici dans une situation qui pourrait paraître plus délicate, à savoir la gestion de plusieurs shortcodes dans une seule et unique fonction de callback. C’est effectivement possible et peut être utile si plusieurs shortcodes font presque la même chose par exemple. Mais c’est très loin d’être insurmontable à gérer.

Imaginons deux shortcodes [hello] et [plop] (admirez l’imagination dans ces noms, c’est tout simplement remarquable) et faisons en sorte que ce soit la même fonction qui soit appelée :

add_shortcode('hello', 'gerer_shortcode');
add_shortcode('plop', 'gerer_shortcode');
?>

Si on ne fait rien de plus, nos deux shortcodes seront exactement les mêmes, ce qui est un peu inutile. C’est pourquoi il existe un troisième (et dernier, enfin pour l’instant) argument possible pour les fonctions de callback : le nom du shortcode.

Dans l’appel de add_shortcode(), nous n’avons rien à faire, tout change dans la fonction de callback en question, où vous devez ajouter un troisième paramètre :

function transformer_hello($atts, $contenu, $tag) {
	return 'Hello World! ' . $contenu;
}
?>

Et c’est à peu près tout en fait. Le paramètre $tag contiendra le nom du shortcode choisi par l’utilisateur et vaudra dans notre cas « hello » ou « plop« . La suite dépend donc de vous et de la différence que vous voulez donner aux shortcodes.

À noter que le WordPress Codex référence un comportement étrange lorsqu’on gère plusieurs noms. Selon cette page, si deux shortcodes utilisent la même fonction de callback et que le nom du shortcode diffère de celui de la fonction, alors l’entrée 0 de l’argument $atts vaudra la chaîne de caractère repérée par WordPress, c’est-à-dire tout le shortcode envoyé par l’utilisateur. Je n’ai cependant pas réussi à reproduire ce comportement et il semblerait donc qu’il ait été corrigé depuis. Quoiqu’il en soit, il ne vous affectera que si vous devez gérer des attributs sans nom.

Un shortcode dans un shortcode dans un shortcode…

… dans un shortcode. Vous l’aurez compris, nous allons aborder ici la question de shortcodes imbriqués, qui ne se pose que si vous gérez du contenu pour vos shortcodes. Un exemple ? Prenons deux shortcodes, dont notre bon vieux [hello] accompagné d’un shortcode [monde] qui affiche le mot « monde« . Parce que faire compliqué ne sert à rien.

Modifions notre shortcode [hello] qui ne dira plus que « Hello contenu!« , désormais, avec « contenu » remplacé par le contenu du shortcode. Notre shortcode [monde], lui, affichera simplement le mot « monde » là où il est. Je pense qu’il est inutile de vous montrer comment faire ces choses-là…

Si l’utilisateur écrit « [hello]World[/hello] [monde]« , tout va bien, nous afficherons « Hello World! monde » et c’est tout. C’est con, ça sert à rien, mais on s’en fout. Imaginons plutôt que l’utilisateur choisisse d’écrire « [hello]le [monde][/hello]« . Là, tout va mal.

WordPress ne fait qu’un seul tour pour gérer les shortcodes, et indiquer la chaîne précédente produira donc le résultat « Hello le [monde]! » : le shortcode [monde] n’a tout simplement pas été interprété !

Bien sûr, peut-être ne voudrez-vous pas qu’ils le soient justement. Mais selon les besoins, c’est un peu ennuyeux. Heureusement, WordPress a pensé à tout et nous fournit la fonction qu’il nous faut : do_shortcode().

Cette fonction s’utilise de façon très simple, en indiquant en paramètre la chaîne que WordPress doit traiter, celle où il faut éventuellement aller chercher des shortcodes. Aussi, nous pourrions l’utiliser comme ceci dans notre cas :

function hello($atts, $contenu) {
	return 'Hello ' . do_shortcode($contenu) . '!';
}
?>

Et là, tout va bien : utiliser la chaîne qui posait problème jusque maintenant produira le résultat « Hello le monde!« , exactement comme on le souhaitait.

A-t-on vraiment fait le tour ce coup-ci ?

Pas vraiment. En fait, il reste encore toute une multitude de petits détails que je n’ai pas abordé. Cependant, ce sont vraiment de tout petits détails qui ne nécessitent guère d’explications et je vous laisse donc vous débrouiller seul pour ceux-ci. Bien sûr, n’hésitez pas à laisser un commentaire si jamais vous avez des questions concernant un détail à rajouter, ou si vous avez une idée de comportement qui nécessiterait un tutoriel entier.

Avec tout ce que nous avons vu, vous êtes normalement capable de créer des shortcodes très puissants. Pensez-y un peu, l’espace d’un instant : nous pouvons créer des shortcodes simples, sans aucun paramètre à indiquer, ou nous pouvons gérer des attributs plus complexes, avec du contenu et des attributs, avec ou sans nom.

Notez pour finir que vous pouvez bien sûr mixer les shortcodes avec des boutons, nous avons déjà vu comment insérer du contenu dans les éditeurs de WordPress. D’ailleurs, pour ceux qui se posent la question, c’est exactement ce qui est fait pour WP Photo Sphere : le bouton média « Ajouter un panorama » permet de sélectionner un panorama, inséré sous forme de shortcode lui-même géré par l’API de WordPress. Comme quoi, on peut en faire des choses.

Original post of Tasse de Café.Votez pour ce billet sur Planet Libre.

Parmi les arguments avancés pour l’utilisation de DisquS figure celle-ci :

Je crois que l’intérêt de Disqus est pour les utilisateurs, qui peuvent suivre facilement les conversations autour des commentaires qu’ils ont laissés. Combien de fois avez-vous laissé un commentaire sur un blog, vérifié une ou deux fois s’il y avait des réponses intéressantes, puis oublié cette page. Avec Disqus, si quelqu’un répond trois mois plus tard, l’utilisateur peut en obtenir une notification et rebondir.

Et bien vous devriez savoir que pour chaque article publié avec WordPress on peut avoir un flux RSS particulier des commentaires. Ex : http://tuxicoman.jesuislibre.net/2014/05/disqus-pourquoi.html/feed

En bonus, pas besoin de laisser son mail pour s’inscrire ni de prier pour que vos démarches de désinscriptions soient bien prises en compte.

J'aime(5)Ferme-la !(1)

Original post of Tuxicoman.Votez pour ce billet sur Planet Libre.

Hachette vs Amazon : Filippetti agite le chiffon d'une enquête en Europe - Next INpact

Campagne "Adopte le libre" - Logiciels libres & open-source et autour du libre

Chantage : Google, Apple et Amazon, les tontons écrabouilleurs - Le nouvel Observateur

Yes, your smartphone camera can be used to spy on you… | Naked Security - Liens en vrac de sebsauvage

Vers une mise à l'écart de la NSA lors de la conception des normes de chiffrement - Numerama

Surveillance : la Cnil dénonce l'argument "simpliste" de Valls et Sarkozy - Le Point

Original post of Planet Libre.Votez pour ce billet sur Planet Libre.

Original post of Goffi.Votez pour ce billet sur Planet Libre.

Si nous devions citer 2 logiciels présents par défaut dans (quasiment) tous les OS, les environnements de bureau et les distributions de la planète, nous pourrions dire sans trop nous tromper qu’il y a un terminal et une calculatrice. Après la lecture de ce billet la calculette traditionnelle va vous paraître bien fadasse et vous lui préférerez peut-être Concalc, une application sympa conçue dans le but vous permettre d’effectuer vos opérations mathématiques depuis votre terminal. Il s’agit plus précisément d’une adaptation de l’analyseur d’algorithme d’Extcalc (une calculatrice Qt), empaqueté pour en faire un programme de console simple. À ce titre d’ailleurs, Concalc est capable d’exécuter des scripts en langage C.

Comme vous pouvez le voir sur l’image d’illustration, l’utilisation de Concalc est vraiment un jeu d’enfant. Une fois installé il suffit d’ouvrir votre terminal, d’entrer la commande de base « concalc » suivie de l’opération à effectuer et d’appuyer sur la touche ENTER.

Exemple :

$ concalc 2+2 [Enter]

Qui devrait vous renvoyer la bonne réponse.

$ concalc 2+2 [Enter]
4

Vous pouvez aller plus loin et entrer des opérations nécessitant une syntaxe plus complexe :

Exemple :

$ concalc "2*(3+7/2)" [Enter]
13

Voilà, ce n’est pas plus compliqué que ça. Pour prendre connaissance des autres options utilisez l’argument « -h ».

Bien entendu vous avez Calc qui fait la même chose (certains diront sans doute « en mieux »), mais dans tous les cas ça peut s’avérer pratique et ça fait très geek. Alors pourquoi faire comme tout le monde et utiliser une calculatrice traditionnelle, quand nous avons un terminal et Concalc dans la machine ?!!

Si ça vous tente vous pouvez en savoir plus sur Concalc en visitant le site du projet.

Pour l’installer sur Archlinux, Manjaro et dérivés il suffit de passer par AUR et pour Debian et Ubuntu apt fera l’affaire.

sudo apt-get install concalc

Amusez-vous bien.

source

Original post of La vache libre.Votez pour ce billet sur Planet Libre.