Ajouter une version audio à vos articles Craft CMS
Craft n'a pas de répertoire d'extensions grand public, mais l'audio s'ajoute sans refonte : embed dans le template Twig, flux, ou API. Les trois méthodes expliquées pas à pas pour un site Craft CMS.
Craft CMS est le choix des studios et des agences qui veulent un back-office sur mesure et un contrôle total sur le rendu. Le revers, c'est qu'il ne ressemble pas à WordPress : pas de répertoire d'extensions grand public où l'on clique pour installer une fonctionnalité, mais des templates Twig, des sections d'entrées, et une logique où chaque page est construite exactement comme le développeur l'a décidée. Ajouter une version audio de vos articles fait partie des cas où cette liberté joue en votre faveur : l'audio s'insère là où vous voulez, sans refonte et sans toucher à votre modèle de contenu. Voici les trois façons de procéder, de la plus rapide à la plus automatisée.
Le lecteur : un embed dans votre template d'entrée
Dans Craft, un article est une entrée rendue par un template Twig (typiquement dans templates/, un fichier par section). C'est là que tout se joue. Il suffit d'ajouter une ligne dans ce template pour afficher le lecteur audio sur toutes vos entrées d'un coup, sans modifier une seule entrée dans le back-office.
La ligne à insérer est la suivante :
``
<script src="https://wedispatch.fr/player.js"
data-article="{{ entry.id }}" defer></script>
Placez cet embed à l'endroit exact où vous voulez voir apparaître le lecteur, juste sous le titre, avant le premier paragraphe, peu importe. Comme il vit dans le template et non dans chaque entrée, vous ne le collez qu'une fois, et toute publication future hérite automatiquement du lecteur. Par défaut, le lecteur s'insère avant le premier paragraphe ; pour le placer ailleurs, ajoutez <div data-wedispatch></div> là où vous le souhaitez.
Relier le lecteur au bon article
Reste à indiquer quel audio correspond à quelle entrée. Deux approches selon votre confort avec Craft.
La première laisse la détection se faire sur l'URL de la page : vous fournissez à WeDispatch l'adresse de votre entrée, le texte est extrait de la page publiée, et l'audio est associé. Aucun champ à créer dans votre section.
La seconde, plus robuste, s'appuie sur l'identifiant d'entrée de Craft, stable dans le temps, que vous passez à data-article comme dans l'exemple ci-dessus ({{ entry.id }}). Vous gardez ainsi un rattachement fiable même si l'URL de l'entrée change lors d'une refonte. Cette méthode ne coûte rien de plus à mettre en place et vous évite des surprises le jour où vous réorganisez vos URL.
Trois façons de générer l'audio
Afficher le lecteur ne suffit pas : il faut produire le fichier. Sur Craft, trois voies s'offrent à vous.
Le flux est la plus simple. Craft ne publie pas de flux RSS par défaut, mais en produire un est l'affaire d'un petit template : vous créez une route qui rend vos entrées récentes au format XML, ou vous exposez du JSON via un plugin comme Element API. Vous nous communiquez cette adresse, les nouvelles entrées sont détectées au fil de leur publication, le texte est extrait et l'audio généré sans que vous ayez la moindre manipulation à faire. L'approche par plan de site fonctionne sur le même principe si vous préférez pointer vers votre sitemap.
Enfin, si vous avez besoin de contrôle (générer l'audio à un moment précis, choisir la voix, gérer des corrections), l'API reste ouverte. Craft se prête bien à cette approche : un module ou un plugin maison peut déclencher un appel au moment où une entrée passe au statut publié, via un écouteur d'événement. C'est un peu de travail au départ, mais cela donne la main sur toute la chaîne, ce qui est précisément la raison d'être de Craft. La logique est la même que pour n'importe quel CMS headless, et le flux RSS reste le chemin sans code quand vous préférez ne rien développer.
Lecture suivie et accessibilité
Quel que soit le mode retenu, vous pouvez activer la lecture suivie : le texte s'affiche et se surligne mot à mot au fil de l'audio. Sur un site d'agence ou un média de marque, ce détail change beaucoup pour les lecteurs dyslexiques ou malvoyants, et il s'inscrit dans une démarche d'accessibilité sérieuse plutôt que cosmétique. Rien de tout cela ne demande de toucher au code Craft une deuxième fois : ce sont des réglages de votre tableau de bord.
Quand une entrée change
Sur Craft, réviser une entrée après publication est courant. Si vous passez par le flux, la détection repère la mise à jour et marque l'audio comme « à régénérer » : vous relancez la génération quand le texte est stabilisé, et les corrections successives ne sont jamais refacturées. Si vous passez par l'API, il suffit de renvoyer le même identifiant externe avec le texte corrigé. Dans les deux cas, l'audio déjà en ligne continue d'être servi tant que vous n'avez pas relancé, donc aucune page ne se retrouve sans lecteur.
Par où commencer
Pour un site Craft, la voie la plus rapide reste le flux combiné à l'embed dans le template : une demi-heure de mise en place, et chaque nouvelle entrée part avec sa version audio. Si vous tenez à un contrôle fin, un plugin maison qui appelle l'API à la publication vous donne toute la chaîne. Si votre équipe gère aussi des sites WordPress, la logique d'intégration et le fonctionnement du module y sont détaillés sur la page WordPress, et elle éclaire les choix côté Craft. Les détails techniques figurent dans la documentation, et les formules par volume d'articles sur la page tarifs. Le plus simple pour se décider reste de voir le lecteur tourner sur vos propres pages : essayez sur un article et écoutez le résultat avant d'équiper tout le site.
Sonorisez vos articles avec WeDispatch
Ce blog sera lui-même sonorisé par WeDispatch. Envie de voir ce que ça donne sur vos contenus ?
Demandez une démo