WordPress: changer simplement le rendu des templates tags

Je vous livre vite fait en passant une petite astuce pour WordPress pour changer très simplement le rendu des templates tags. Je dis vite fait en passant parce que ce mois-ci je suis assez chargé (en travail hein) et mon rythme de publication ici s’en ressent.

Attention la lecture de cet article pour les non techos peut piquer très fort les yeux. Âmes sensibles s’abstenir.

Vous le savez très probablement si vous avez déjà utilisé WordPress, il existe tout un tas de fonctions (template tags) pour récupérer du contenu de votre base de données. Vous pouvez même si ça vous chante lancer votre propre requête sql. Mais pourquoi s’embêter à le faire lorsqu’une équipe de développeurs chevronnés a mis en place pour nous des fonctions toutes faites voire même carrément des tags ? Et bien parfois, quand même, les fonctions et les templates tags sont limités. La plupart retournent un contenu formaté, souvent sous forme de listes, en ul, li. Or parfois, il vous faut autre chose, genre un div ou même rien du tout. Alors avant de vous attaquez à la requête sql je dis halte là ! Le barbablog est là pour vous venir en aide. Le barbablog et les expressions régulières.

Je ne m’étendrais pas ici sur les expressions régulières, mais il faut savoir que c’est un truc assez standard qui vous permet grosso modo de faire des rechercher remplacer puissance 10. Elles vous permettent très simplement de changer un tag ou de le supprimer tout en conservant les attributs qui s’y rattachent. Voici un exemple avec la fonction wp_list_categories qui permet de récupérer comme son nom l’indique la liste de vos catégories :

Magie : changer les li en div

<?php
$categories = wp_list_categories('title_li=&orderby=id&echo=0&exclude=1');
// change li to div
$oldTag = "li";
$newTag = "div";
$regExp = "<" . "li" . "[^>]*>";
$regExp = "<" . $oldTag . "[^>]*>";
$categories = str_replace("</$oldTag>", '</' . $newTag . '>', $categories);
$categories = ereg_replace($regExp, '<' . $newTag . '>', $categories);
// display
echo $categories;
?>

Explication vite fait et baclée

1. Dans un premier temps je range dans une variable le retour de la fonction wp_list_categories. Je peux le faire grâce au paramètre echo=0 qui indique  à la fonction qu’on ne eut pas faire un ‘display’ de la liste. Les autres paramètres indiquent le tpe de classement des catégories : par id (order=id) et le titre que l’ondonne à la liste, en l’occurence aucun (title_li=)
2. Ensuite je remplace grâce  à la fonction ereg_replace de php et via le motif de mon expression régulière les tags li ouvrants puis je remplace les tags li fermants avec une autre fonciton plus basique celle-là : str_replace, laquelle permet de remplacer une chaîne simplement. Dans le cas des tags fermants, pas la peine d’utiliser d’expression régulière puisque un li fermant sera toujours indqiué </li> – on ne lui passe pas d’attributs, le rechercher remplacer est donc beaucoup plus simple.
3. Enfin, une fois ces deux opérations effectuées, j’affiche le résultat : echo $categories. Et le tour est joué !

En terme de performance, si vous pouvez éviter d’avoir recours à ce genre de tour de magie c’est mieux, mais parfois, on n’a pas le choix.