Gérer l'affichage des erreurs dans Kirby CMS

Soyons honnêtes. Ce tutoriel ne vous servira probablement à rien puisque votre site tourne comme une horloge suisse, sans jamais afficher la moindre erreur 404 ou 500. Vous êtes ici par pure curiosité, peut-être pour enrichir votre culture technique ou simplement parce que le titre vous a intrigué. C'est compréhensible.

Mais pour ceux qui, comme votre serviteur, commettent parfois des erreurs de configuration ou des oublis malencontreux, ce guide sur le CMS Kirby pourrait s'avérer précieux.

D'ailleurs, j'avais publié une présentation détaillée de cette plateforme il y a quelque temps, accessible en un clic pour les curieux.

Affichage de l'erreur 404

Si vous souhaitez personnaliser la page 404; voici ci-dessous les étapes :

Ajouter le contenu dans votre dossier content

Commençons par le commencement avec la création du contenu dans votre installation. Il vous faudra d'abord créer un répertoire baptisé "error" directement dans votre dossier content. C'est là que viendra se loger votre fichier error.txt, qui contiendra le message destiné aux visiteurs égarés. Rien de compliqué, vous pouvez simplement y ajouter les champs classiques comme title et text :

Title: Erreur 404

----

Text: La page que vous souhaitez afficher n'est plus disponible ! 😱

Affichage de l'erreur au niveau du frontend

Direction le dossier site/templates où vous allez créer un fichier error.php. Le code reste simple et s'adaptera facilement à votre charte graphique :

<?php snippet('header') ?>

<h1><?= $page->title()->escape() ?></h1>

<p><?= $page->text()->escape() ?></p>

<?php snippet('footer') ?>

Ci-dessous un exemple de la page 404 du site avec un zeste d'humour :

Affichage de l'erreur 500

Modification du fichier de config

Ouvrez le fichier config.php depuis le répertoire site/config et rajoutez le code suivant :

'fatal' => function($kirby, $exception) {
        include $kirby->root('templates') . '/fatal.php';
    },

Affichage de l'erreur au niveau du frontend

Créez le fichier fatal.php dans le répertoire site/templates et ajoutez cet exemple (à adapter selon votre contexte) :

<?php snippet('header') ?>

<h1>Erreur 500</h1>

<p>Le serveur rencontre un problème temporaire. Rafraîchissez la page dans un moment ou contactez-nous si l'erreur persiste.</p>

<?php snippet('footer') ?>

Voici un exemple :

Conclusion

Vous avez maintenant toutes les cartes en main pour gérer proprement les erreurs 404 et 500 sur votre site Kirby.

Quelques fichiers bien placés, un peu de PHP et le tour est joué. C'est l'un des aspects souvent négligés dans le développement web, pourtant ces pages d'erreur font partie intégrante de l'expérience utilisateur.

Elles peuvent même devenir un atout si vous y mettez une touche personnelle.

La prochaine fois qu'un visiteur s'égarera sur votre site, il tombera sur votre création plutôt que sur un message technique incompréhensible. Un petit détail qui fait toute la différence.

Recommandations

Journal des modifications