TYPO3 v14.0 — Ce n'est que le début

Nous sommes ravis d’annoncer la sortie de la version 14.0 de TYPO3. Plus de 2 000 modifications, petites et grandes, ont été intégrées au dépôt de code depuis le lancement officiel du développement il y a plus d’un an. Un grand merci à tous ceux qui ont contribué à ce projet open source.

Nous avons pris une mesure audacieuse en restructurant et en renommant plusieurs modules du menu de gauche de l'interface d'administration de TYPO3. Le DocHeader a également été remanié et propose désormais un fil d'Ariane interactif et adaptatif.

Mais la version 14.0 de TYPO3 ne se limite pas à des ajustements de l’interface d’administration. La première version d’un nouveau cycle de publication implique toujours une importante phase de nettoyage et de modernisation. La suppression des éléments obsolètes vise à moderniser l’architecture interne et ouvre la voie à de nouvelles fonctionnalités et innovations dans les prochaines versions. Par exemple, l’une des tâches de modernisation consiste à mettre à niveau le moteur de modèles Fluid vers la version 5.

Examinons de plus près les principaux changements de cette nouvelle version. Pour des informations plus approfondies et des détails techniques, consultez le journal des modifications de la v14.0.

L'interface d'administration TYPO3 est l'interface à laquelle les rédacteurs, les intégrateurs et les administrateurs se connectent pour mettre à jour le contenu du site web, configurer le système et gérer les traductions. En raison de son rôle central, nous améliorons constamment cet espace à chaque nouvelle version de TYPO3 et adoptons les technologies émergentes afin que l'interface d'administration reste à jour, rapide et facile à utiliser pour tous.

Les nouveaux utilisateurs peuvent parfois se sentir submergés par la multitude de fonctions, de modules et d’éléments d’interface proposés par TYPO3. Cette courbe d’apprentissage doit être améliorée. Notre objectif est de repenser l’interface d’administration de TYPO3 avec les prochaines versions TYPO3 v14 afin qu’elle offre une expérience plus intuitive et conviviale. La mise en page, la structure et les fonctionnalités disponibles sont en cours d’amélioration pour aider même les nouveaux utilisateurs à comprendre rapidement les concepts fondamentaux de l’expérience utilisateur et l’objectif de chaque fonctionnalité.

Il est important de noter que les utilisateurs expérimentés n’auront pas besoin de réapprendre l’ensemble du système. L’accent est mis sur le raffinement visuel et la modernisation plutôt que sur la création d’un backend entièrement nouveau. Avec les prochaines versions de TYPO3 v14, nous introduirons des améliorations significatives en matière d’interface utilisateur (UI) et d’expérience utilisateur (UX) qui élèveront l’expérience de travail avec TYPO3 à un nouveau niveau.

Ce travail s’inscrit dans le cadre de la feuille de route de TYPO3 v14, dont l’objectif n° 1 porte précisément sur la modernisation du backend avec un design rafraîchi et convivial. La feuille de route définit l’orientation générale : une navigation plus intuitive, une terminologie cohérente et une interface visuellement soignée.

Une étape concrète dans cette direction est le changement de nom des modules du backend dans le menu de gauche. Nous avons soigneusement comparé le nom de chaque module et sous-module à sa fonction, tout en tenant compte de la terminologie couramment utilisée dans d’autres systèmes de gestion de contenu et d’actifs numériques. En conséquence, plusieurs modules ont été renommés afin de mieux refléter leur objectif :

• « Web » s’intitule désormais Contenu
• « Fichiers » s’appelle désormais Médias
• « Outils d’administration » s’intitule désormais Administration

Outre le changement de nom, nous avons restructuré, regroupé et déplacé des modules afin de créer un flux de travail plus logique.

Le module « Rapports » utilise désormais le système de sous-modules natif de TYPO3 afin d’offrir une expérience utilisateur cohérente, et un nouveau module « Administration → Intégrations » sert de plaque tournante centrale pour connecter TYPO3 à des systèmes externes et à des services tiers.

L'en-tête du document (également appelé « DocHeader » dans chaque module) a été repensé afin d'offrir une expérience utilisateur plus cohérente et intuitive dans tous les modules du backend. La mise en page, désormais structurée de manière logique, intègre un fil d'Ariane et un sélecteur de langue unifié pour tous les modules du backend prenant en charge plusieurs langues.

La deuxième ligne est réservée aux menus déroulants d'actions et à une série de boutons tels que « Enregistrer », « Fermer », « Actualiser », « Ajouter aux favoris », etc.

L'index de référence de TYPO3 revêt une importance croissante pour les administrateurs depuis les améliorations apportées à la version 13 de TYPO3. L'index de référence est un composant essentiel du système qui assure le suivi des relations entre les enregistrements dans TYPO3. Sa vérification et sa mise à jour font désormais partie des tâches de maintenance courantes des administrateurs ; c’est pourquoi nous avons déplacé son module de gestion vers la section « Outils d’installation ». Il figure ainsi aux côtés d’autres tâches de maintenance courantes telles que les vérifications du schéma de la base de données, la gestion du cache et les vérifications de la structure des dossiers.

Le module backend « Relations de base de données » a été supprimé, car cette fonction était rarement utilisée et n’apportait qu’une valeur ajoutée limitée.

Nous comprenons que les utilisateurs expérimentés de TYPO3 puissent avoir besoin d’un peu de temps pour s’adapter aux nouveaux noms et à la nouvelle structure. Avec un peu de temps, vous constaterez que ces changements sont intuitifs et cohérents, contribuant ainsi à créer un flux de travail plus fluide tant pour les passionnés de longue date de TYPO3 que pour les nouveaux venus.

Fluid, le moteur de modèles par défaut de TYPO3, est au cœur du CMS depuis de nombreuses années. Son succès se poursuit dans TYPO3 v14 avec une mise à niveau vers la version 5 de Fluid. Cette nouvelle version apporte un code plus épuré et modernisé, un processus de préchauffage du cache simplifié et une gestion plus stricte des types pour les ViewHelpers, rendant ainsi le développement plus prévisible et plus robuste.

Noms de fichiers de modèles flexibles

Nous avons également revu la manière dont Fluid résout automatiquement les chemins d’accès aux fichiers de mise en page et de modèles. L’exigence de longue date selon laquelle les noms de fichiers devaient commencer par une majuscule a été supprimée. À la place, Fluid utilise désormais une chaîne de repli flexible qui recherche d’abord les fichiers en utilisant leur orthographe standard et se rabat sur la variante en majuscules si nécessaire. Cette amélioration simplifie non seulement la gestion des fichiers, mais nous permet également d’introduire une extension de fichier dédiée aux modèles Fluid, telle que *.fluid.html, *.fluid.txt ou une extension similaire à l’avenir. Grâce à cette chaîne de repli, la nouvelle extension de fichier est facultative et les modèles existants continueront de fonctionner.

Prise en charge des sections CDATA

Les développeurs qui ont rencontré des difficultés avec l’utilisation de CSS ou de JavaScript en ligne dans les modèles Fluid seront ravis d’apprendre que ces problèmes appartiennent désormais au passé. La version 5 de Fluid prend entièrement en charge les sections CDATA, ce qui vous permet d’inclure des styles et des scripts bruts sans les conflits causés par les accolades. Le contenu des sections CDATA est ignoré par l’analyseur syntaxique de Fluid, tandis que les variables, les ViewHelpers et les expressions peuvent toujours être utilisés avec des triples accolades « {{{ }}} » pour plus de flexibilité et de clarté.

Nouveaux ViewHelpers

Outre la mise à niveau vers la version 5 de Fluid, TYPO3 v14.0 propose plusieurs nouveaux ViewHelpers.

• Un nouveau ViewHelper PageTitle permet de définir plus facilement que jamais les titres de page directement dans les modèles Fluid. Les développeurs d’extensions peuvent désormais générer des titres de page dynamiques sans avoir à créer un fournisseur de titres de page personnalisé pour chaque extension. Cette amélioration simplifie considérablement certains cas d’utilisation, tels que les vues détaillées Extbase, où le titre de la page doit refléter automatiquement l’enregistrement affiché. En gérant cette logique directement dans Fluid, les développeurs peuvent maintenir un code plus propre avec moins de dépendances.
• Le nouveau PageMeta-ViewHelper permet de définir des balises méta directement via l’API API MetaTagManagerde TYPO3. La possibilité de modifier les attributs de page depuis Fluid est particulièrement utile pour les développeurs front-end, car elle réduit, voire supprime, le recours à du TypoScript personnalisé.
• Le PageHeader-ViewHelper et PageFooter-ViewHelper. Deux nouveaux ViewHelpers permettent aux développeurs d’injecter du contenu personnalisé dans la section HTML <head>, ou juste avant la balise de fermeture </body> d’une page affichée. Ces nouvelles fonctionnalités offrent davantage de flexibilité pour l’intégration dynamique de scripts, de métadonnées ou d’autres éléments.
• Le Date-ViewHelper a été enrichi d’une nouvelle option « timezone ». Cet ajout permet aux intégrateurs et développeurs TYPO3 d’afficher les dates et heures dans un fuseau horaire spécifique directement au sein de leurs modèles Fluid. Il s’agit d’une amélioration simple mais puissante qui offre une plus grande flexibilité pour afficher des informations de date et d’heure localisées ou spécifiques au contexte sans nécessiter de code supplémentaire.

TYPO3 offre des outils puissants pour la création et la gestion de sites web multilingues et est depuis longtemps conçu autour d’un flux de travail de traduction efficace. Dans TYPO3 v14.0, une approche modernisée remplace l’ancien système de localisation par un assistant guidé, étape par étape, qui accompagne les rédacteurs à chaque étape du processus de traduction.

Lorsqu’une traduction est lancée depuis n’importe quelle partie de l’interface d’administration, le nouvel assistant s’ouvre, garantissant ainsi un flux de travail cohérent dans tous les modules. Il parcourt les étapes nécessaires et ignore celles qui ne nécessitent aucune intervention, permettant ainsi aux éditeurs de se concentrer uniquement sur les décisions importantes. Cela offre une expérience plus claire et plus intuitive, avec des instructions structurées adaptées à la tâche à accomplir.

Le nouveau système de traduction permet également aux développeurs d’extensions d’intégrer des gestionnaires de localisation personnalisés, notamment des connexions à des services de traduction externes ou à des outils basés sur l’IA.

Amélioration de la sélection des langues dans le backend

Passer d’une langue à l’autre et choisir celles avec lesquelles un éditeur ou un traducteur souhaite travailler est désormais plus simple que jamais. Les utilisateurs du backend peuvent sélectionner plusieurs langues à la fois, masquer ou afficher des langues individuelles, et activer ou désactiver rapidement toutes les options disponibles. Leur sélection est conservée à la fois dans les modules « Page » et « Liste », garantissant une expérience fluide et cohérente lors du passage d’une vue à l’autre.

Architecture de localisation modernisée

Bien que TYPO3 offre des capacités multilingues exceptionnelles par rapport à d’autres systèmes de gestion de contenu open source, son traitement sous-jacent des étiquettes de traduction est devenu obsolète.

En conséquence, plusieurs modifications apportées à TYPO3 v14.0 affectent le système de localisation de TYPO3, que nous avons migré vers le composant Symfony Translation. Outre les méthodes standardisées d’analyse des fichiers XLIFF, les développeurs peuvent tirer parti de chargeurs de traduction personnalisés conformes aux normes Symfony, et TYPO3 prend désormais en charge les formats de fichiers de traduction XLIFF 1.2 et XLIFF 2.x.

La norme Symfony permet également aux intégrateurs et aux développeurs de référencer les étiquettes de langue de manière plus logique et plus flexible. Les traductions peuvent être organisées en groupes appelés « domaines ». L’exemple suivant montre à quel point une référence peut être simple, grâce à la nouvelle syntaxe des domaines :

• ANCIEN : « LLL:EXT:core/Resources/Private/Language/Form/locallang_tabs.xlf:general »
• NOUVEAU : « core.form.tabs:general »

Soyez assurés que vous n’avez pas besoin de mettre à jour tous vos fichiers TCA si vous souhaitez faire passer votre site à TYPO3 v14. Nous maintiendrons la rétrocompatibilité tout en fournissant une base moderne prête à être utilisée dès aujourd’hui et pour longtemps.

Mise à jour

La première version d'un nouveau cycle de publication s'accompagne toujours d'une importante opération de nettoyage et de modernisation. Dans la version 14.0 de TYPO3, nous avons supprimé les classes PHP, fonctions, appels CLI et autres composants obsolètes qui avaient été conservés pour des raisons de compatibilité avec les versions antérieures. Cette opération de nettoyage garantit une base de code plus propre, plus légère et plus facile à maintenir.

La suppression des éléments obsolètes, conformément à notre politique d’obsolescence, permet non seulement de moderniser l’architecture interne, mais aussi de préparer le terrain pour de nouvelles fonctionnalités et innovations dans les prochaines versions.

L’entrée du journal des modifications intitulée« Fonctionnalités obsolètes supprimées »fournit une liste exhaustive des classes PHP, méthodes, propriétés, options TypoScript et autres fonctionnalités qui ont été supprimées ou modifiées. Suivez les liens vers les « Entrées d’obsolescence » pour en savoir plus sur les options de migration pour chaque modification.

API des ressources système

Le code chargé de résoudre diverses ressources et de générer des URL est désormais encapsulé dans une API des ressources système, centralisée en un seul endroit. Dans ce contexte, les ressources peuvent être :

• Des fichiers situés dans une extension (ressources de package)
• Des éléments stockés et gérés dans la couche d’abstraction de fichiers (FAL) de TYPO3
• Des fichiers situés dans le dossier de projet TYPO3 (ressources d’application)
• Des ressources URI.

La nouvelle API des ressources système résout l’emplacement des ressources à l’aide de mots-clés tels que « PKG » ou « FAL » de manière cohérente dans toutes les parties du noyau TYPO3 (dans le code PHP, TypoScript, les modèles Fluid, etc.). Tous les endroits du cœur de TYPO3 où des URL sont générées à partir de ressources spécifiées ont été adaptés pour utiliser la nouvelle API. L’ancien mot-clé « EXT » reste inchangé pour le moment.

L’avantage est évident : TYPO3 résout désormais les ressources de manière cohérente dans l’ensemble du système. L’API des ressources système est facile à utiliser et aide les développeurs à éviter les erreurs susceptibles d’entraîner des failles de sécurité. Grâce à sa flexibilité, l’API peut être étendue, par exemple, pour gérer les ressources stockées dans les nœuds d’un réseau de diffusion de contenu (CDN).

Annotations et validation des données dans Extbase

Extbase, le framework de programmation utilisé par TYPO3, a également bénéficié de plusieurs mises à jour et améliorations. L’un des axes prioritaires est l’utilisation d’annotations pour valider les données transmises aux modèles, aux actions des contrôleurs et aux objets de transfert de données.

Dans TYPO3 v14.0, Extbase ne s'appuie plus sur la bibliothèque tierce doctrine/annotations, qui n'est plus maintenue en amont. PHP 8.2 étant désormais la version minimale requise pour TYPO3, les développeurs doivent migrer leurs implémentations vers les attributs PHP. TYPO3 prend en charge les attributs pour toutes les annotations liées à Extbase depuis la version 12.

Un deuxième changement important concerne les validateurs Extbase. Les modèles et contrôleurs Extbase prennent désormais en charge les validateurs Symfony. Symfony propose une large gamme de validateurs prêts à l’emploi. Combinés aux validateurs déjà disponibles dans Extbase, les développeurs TYPO3 ont désormais accès à plus d’options de validation que jamais.

Grâce aux attributs PHP décrits ci-dessus, la validation des entrées est devenue nettement plus simple et la nécessité de créer des validateurs personnalisés a été considérablement réduite.

Il est désormais possible de stocker les sessions d’Install Tool dans des systèmes de stockage de données tels que Redis ou de définir un chemin de stockage personnalisé pour les sessions basées sur des fichiers. Cette amélioration rend la gestion des sessions plus flexible, en particulier dans les environnements distribués ou conteneurisés. Elle améliore l’évolutivité et offre aux administrateurs un meilleur contrôle sur la manière dont les sessions d’Install Tool sont gérées.

Une autre amélioration concerne directement le backend de cache Redis. TYPO3 prend désormais en charge l’authentification à l’aide d’un nom d’utilisateur et d’un mot de passe lors de la communication avec un serveur Redis. Cela s’aligne sur le modèle d’authentification introduit dans la version 6 de Redis et rend les intégrations plus sécurisées.

Les déploiements automatisés et les installations par script sont désormais plus faciles et plus simples, puisque le hachage du mot de passe de l’outil d’installation peut être généré via l’interface de ligne de commande (CLI) de TYPO3. Plus besoin de modifier manuellement les fichiers ! La commande prend en charge à la fois une utilisation interactive et en mode silencieux, et améliore le flux de travail global lors de la préparation de nouveaux environnements TYPO3 ou de l’ajustement de systèmes existants.

Le noyau TYPO3 n’effectue plus de compression des réponses HTTP pour les sorties front-end ou back-end. Les options de configuration précédentes qui contrôlaient la compression ont été supprimées dans la version 14.0 de TYPO3. Les serveurs modernes fournissent généralement des algorithmes de compression plus efficaces et négocient directement avec les clients, ce qui évite les efforts redondants et prévient d’éventuels conflits.

L’outil d’installation étant désormais entièrement intégré au système de routage du backend de TYPO3, le fichier autonome « typo3/install.php » n’est plus nécessaire. Par conséquent, les installations TYPO3 basées sur Composer n’ont plus besoin du dossier « typo3/ ». Les administrateurs système n’ont aucune action à entreprendre, car la rétrocompatibilité totale est préservée.

Enfin, le modèle « .htaccess » par défaut fourni avec TYPO3 pour les environnements de serveurs web Apache a été mis à jour. Ces modifications tiennent compte de la structure de dossiers utilisée par les installations modernes basées sur Composer. La nouvelle version prend en compte la structure actuelle des ressources et contribue à garantir un routage correct des requêtes. Les administrateurs d’installations existantes sont invités à vérifier leurs fichiers .htaccess et à les adapter si nécessaire afin de les aligner sur le nouveau modèle.

TYPO3 v14 nécessite au minimum la version 8.2 de PHP, qui bénéficiera de mises à jour de sécurité jusqu'au 31 décembre 2026. TYPO3 v14 prend également en charge les versions 8.3, 8.4 et même la toute dernière version 8.5 de PHP, ouvrant ainsi la voie vers l'avenir.

Si vous effectuez une mise à niveau à partir d’une version antérieure de TYPO3, vous pouvez être assuré que la mise à niveau du noyau TYPO3 se déroulera sans encombre. Les versions TYPO3 v12, v13 et v14 présentent toutes des configurations minimales similaires. TYPO3 v12 et v13 prennent en charge la version 8.2 de PHP, tandis que les versions des moteurs de base de données MariaDB et MySQL sont également prises en charge par TYPO3 v14. Cela signifie que vous pouvez d’abord mettre à jour la plateforme, puis l’instance TYPO3.

Nous prendrons en charge chaque version « sprint » de TYPO3 (de la v14.0 à la v14.2) jusqu’à la publication de la prochaine version mineure. La version à support à long terme TYPO3 v14 LTS (également appelée version 14.3) bénéficiera de corrections de bogues jusqu’au 31 décembre 2027, et nous fournirons des correctifs de sécurité pour TYPO3 v14 LTS jusqu’au 30 juin 2029.

Pour en savoir plus sur les prérequis et les dépendances, rendez-vous sur get.typo3.org.

Vous trouverez toutes les informations concernant cette version, ainsi que les instructions de téléchargement et d'installation de TYPO3, sur get.typo3.org. Des instructions d'installation détaillées sont disponibles dans le Guide d'installation. Nous vous recommandons d'utiliser Composer pour configurer votre environnement TYPO3.

La version 14.1 de TYPO3 est la deuxième version « sprint » de la série v14, dont la sortie est prévue le 20 janvier 2026, et elle réserve de nombreuses nouveautés passionnantes.

Nous allons poursuivre la modernisation de l’interface utilisateur du backend. Cette tâche est une priorité absolue et nous avons à cœur de la mener à bien. De nouveaux points de terminaison API sont prévus pour cette version, et nous avons également pour objectif de créer un thème par défaut prêt à l’emploi, basé sur les concepts des « Site Sets ».