Mode d'affichage des paragraphes – Révision d'un module pour Drupal

Créer des composants en utilisant le module Paragraphs offre une flexibilité incroyable pour construire des pages basées sur Drupal. L'une des restrictions courantes est la question de réutiliser les mêmes paragraphes dans des composants très similaires. Si la seule chose qui vous limite est l'ensemble et la disposition des champs, le module Paragraph View Mode vous aidera.

Les toutes premières lignes de code du module ont été créées en tant que module dédié pour l'un des projets que nous avons mis en œuvre. J'ai rapidement remarqué, cependant, à quel point une telle fonctionnalité pourrait être utile dans l'ensemble de l'écosystème de modules Paragraphs. Actuellement, le module a une version stable 1.4 et est couvert par la Politique de conseil en sécurité.

Dates 

La première version du module a été publiée en juillet 2019. Depuis lors, je suis activement la liste des problèmes, en implémentant des correctifs et de nouvelles fonctionnalités. Les derniers correctifs ont été introduits dans la version développeur en juillet 2020.

Popularité du module

Selon les données statistiques publiées sur la page du module : https://www.drupal.org/project/paragraph_view_mode, il est actuellement utilisé par environ 450 sites, ce qui se traduit par environ 10 utilisations par semaine.

Créateurs du module

Le premier jet du module a été créé afin de répondre aux besoins d'un projet en cours. Après sa sortie initiale sur le site drupal.org, j'ai introduit quelques améliorations supplémentaires et de nouvelles fonctionnalités. La communauté a également aidé, par exemple en rendant le module compatible avec Drupal 9.
Actuellement, je suis la seule personne à avoir travaillé directement sur le code du module. Le module lui-même est supervisé par deux mainteneurs qui répondent à tous les problèmes aussi rapidement que possible.

À quoi sert le module ? 

Paragraph View Mode est un sous-module pour le module Paragraphs. Ses avantages seront appréciés par les développeurs et les personnes chargées de l'édition de contenu sur un site web. Il peut être nécessaire lorsque :

• vous construisez un site web à partir de nombreux composants, et certains d'entre eux sont très similaires, par exemple ils utilisent un ensemble de champs similaire ;
• vous souhaitez minimiser le nombre de composants en ce qui concerne l'administration ;
• vous pensez à rationaliser la partie frontend ;
• vous voulez assurer une meilleure organisation des templates en ce qui concerne l'interface utilisateur et directement dans le code ;
• vous voulez éviter d'utiliser de nombreux modificateurs complexes basés sur les champs, par exemple des listes.

Comme vous pouvez le voir, ce module peut offrir plusieurs fonctions utiles, et tout cela va de pair avec la simplicité de cette solution conformément au "Drupal Way".

Déballage

Vous pouvez télécharger le module depuis la https://www.drupal.org/project/paragraph_view_mode page web ou via composer :

composer require drupal/paragraph_view_mode

Après l'installation, allez à l'édition du type de paragraphe sélectionné, le chemin par défaut est généralement :
 
[votre_domaine]/admin/structure/paragraphs_type/[votre_paquet_paragraphe]
 
Dans la section déroulante "Paragraph View Mode", sélectionnez l'option "Activer le champ de mode de visualisation des paragraphes sur ce type de paragraphe" puis sauvegardez le formulaire.

Le module créera automatiquement un champ "Mode de visualisation des paragraphes" avec un widget de configuration (disponible dans l'onglet afficher le formulaire de gestion).
 
La configuration du widget consiste en deux champs. Le premier champ est la sélection des modes d'affichage disponibles. Le module reçoit automatiquement une liste de ceux qui sont débloqués sur le type de paragraphe actuel, tandis que vous pouvez décider lesquels d'entre eux vous souhaitez afficher sur la liste des options du formulaire.

Le second champ est utilisé pour définir la valeur par défaut du champ en l'absence de sa valeur (par exemple pour un paragraphe nouvellement créé).

Avec le module configuré de cette manière, vous pouvez passer dynamiquement d'un mode d'affichage à l'autre directement dans le formulaire d'ajout/édition de la page.

Plans pour l'avenir

La fonctionnalité de base du module est déjà terminée, et il est difficile d'imaginer de nouvelles fonctionnalités. Récemment, cependant, j'ai créé un nouveau problème https://www.drupal.org/project/paragraph_view_mode/issues/3150153, dans lequel je prévois (avec un peu d'aide de la communauté) de développer la fonctionnalité de liaison de la valeur du champ avec le mode d'affichage du formulaire et sa substitution dynamique. J'ai également l'intention de continuer à soutenir Drupal 9 et les versions futures.

Résumé

Le module Paragraph View Mode, malgré sa faible complexité, offre beaucoup en termes d'efficacité, de commodité et – surtout – de flexibilité dans le travail des éditeurs. De plus, il permet aux développeurs Drupal ou à la personne responsable du site de réduire la quantité de travail nécessaire pour organiser et maintenir les composants sur le site, réduisant ainsi le coût global de maintenance du site.