Article complet: Bookmarklet de mise en forme des traces de debug sous eZ Publish

Sous eZ Publish, on peut afficher des traces de debug directement en front-office.
Dans cet article je vous présente un petit Bookmarklet que j'ai fait pour améliorer leur rendu.

• Pour installer ce Bookmarklet, faîtes glisser ce lien dans votre barre de favoris : eZ Filter Debug
• Pour activer ce Bookmarklet, cliquez dessus lorsque vous êtes sur une page générée par eZ Publish avec les traces de debug activée
• Vous pouvez lire cette article, si vous voulez en savoir plus sur comment faire un Bookmarklet

Le Bookmarklet "eZ Filter Debug" se résume en 3 fonctionnalités qui peuvent vous intéresser :

1. Chargement de la feuille de style debug.css

Pour mettre en forme les traces de debug, il faut charger la feuille de style debug.css.
Mais on n'a pas forcément envie de la charger tout le temps, surtout en production.
C'était l'idée de départ : ce Bookmarklet charge à la volée la feuille de style de Debug.

2. Afficher les traces de debug à la demande

La deuxième idée est de pouvoir cacher les traces de debug par défaut.
Pour cela, il suffit de rajouter dans votre feuille CSS la ligne suivante :
#debug {display: none;}

Lorsque vous activerez le Bookmarklet, les traces de Debug s'afficheront, et vous serez redirigé vers elles.

Ceci n'est pas forcément utile, car eZ Publish vous permet déjà de n'afficher les traces de Debug que pour une certaine liste d'IP.
Mais ça peut être pratique dans certains cas : IP dynamique, client interne, site mobile, etc.

3. Permettre de filtrer les traces de debug

Les traces de Debug affichent également les traces de Notice, Timing, Warning et Error.
Pas toujours facile de s'y retrouver en un coup d’oeil.
Du coup le Bookmarklet "eZ Filter Debug" vous propose également une option de filtrage :

Note 1 : ce Bookmarklet a été testé sous eZ Publish 4.3 - 4.5.
Note 2 : Le code du Bookmarklet est diponible sur GitHub.
N'hésitez pas en me faire des remarques, soit par commentaire, soit par le formulaire de contact de mon site.

En espérant que ça puisse vous être utile,
Thomas.