Depuis Paragraphs.

Apprendre DXPR BuilderCommencer iciQuitter un autre builder

Vous reconstruisez les paragraphes de chaque page en éléments DXPR Builder, dans un nouveau champ sur le même type de contenu. Les paragraphes restent en ligne jusqu’à ce que chaque page soit terminée. Ensuite, les contributeurs conçoivent la page sur la page même au lieu de remplir des formulaires de paragraphes. Aucun outil ne convertit les paragraphes, mais Drush peut écrire du HTML préparé dans beaucoup de pages à la fois.

Avant de commencer

  • DXPR Builder est installé et votre clé de produit est enregistrée, voir Réglages généraux.
  • Vous pouvez gérer les champs et l’affichage du type de contenu.
  • Chaque page du type de contenu compte comme un contenu dès que son affichage utilise le formateur DXPR Builder. Vérifiez votre limite sur l’onglet Content Items.

Configuration

  1. Accédez à Structure > Content types (/admin/structure/types) et cliquez sur Manage fields pour le type de contenu.
  2. Ajoutez un champ : choisissez Formatted text, puis Long text, par exemple « Page content ».
  3. Cliquez sur Manage display et réglez le Format du nouveau champ sur DXPR Builder.
  4. Laissez le champ Paragraphs où il est et cliquez sur Save.

Reconstruire chaque page

  1. Ouvrez la page. Le champ DXPR Builder vide s’affiche à côté des paragraphes.
  2. Reconstruisez chaque paragraphe avec l’élément correspondant du tableau ci-dessous.
  3. Copiez le texte de chaque paragraphe dans les nouveaux éléments.
  4. Cliquez sur Save dans la barre d’outils de DXPR Builder.
Type de paragraphe Élément DXPR Builder
Texte Texte
Image Image
Texte avec image Ligne à deux colonnes : Texte et Image
Accordéon Panneau repliable dans l’onglet Mise en page
Appel à l’action Bouton
Vidéo Vidéo
Galerie Carrousel d’images
Formulaire web Le bloc de formulaire web dans l’onglet Drupal Blocks
Tout le reste HTML, ou une combinaison d’éléments

Reconstruire beaucoup de pages avec Drush

DXPR Builder transforme le HTML Bootstrap 5 en éléments à glisser et modifier. Si vous pouvez exporter l’ancien contenu en HTML, écrivez-le dans chaque page avec Drush. Essayez d’abord avec --dry-run, qui montre le changement sans enregistrer :

drush dxb:page:update 42 --markup=@/tmp/page-42.html --dry-run
drush dxb:page:update 42 --markup=@/tmp/page-42.html

La commande trouve le champ DXPR Builder sur l’affichage par défaut du type de contenu. Elle enregistre une nouvelle révision, pour revenir en arrière au besoin.

Terminer le déplacement

  1. Sur Manage display, déplacez le champ Paragraphs vers Disabled et cliquez sur Save.
  2. Vérifiez les pages reconstruites, aussi sur téléphone.
  3. Supprimez le champ Paragraphs sur Manage fields seulement quand son contenu ne sert plus. Le supprimer retire les paragraphes pour de bon.

Ce que vous voyez

Chaque page affiche le contenu du champ DXPR Builder, et les paragraphes n’apparaissent plus. Les contributeurs avec la permission Edit with DXPR Builder voient les contrôles d’édition sur la page. L’onglet Content items liste chaque page du type de contenu.

Si vous ne voyez pas l’éditeur

  • La page affiche l’ancien et le nouveau contenu. Le champ Paragraphs est encore sur l’affichage. Déplacez-le vers Disabled sur Manage display.
  • Drush signale « No DXPR Builder field found ». L’affichage par défaut n’utilise pas le formateur DXPR Builder. Réglez le Format sur Manage display du mode d’affichage par défaut.
  • Drush signale « Multiple DXPR Builder fields found ». Le type de contenu en a plus d’un. Nommez le champ, par exemple --field=field_page_content.
  • Le champ s’affiche, mais sans contrôles d’édition. Votre compte n’a pas la permission Edit with DXPR Builder, ou vos limites de licence sont atteintes. Voir Erreurs de licence et de clé de produit.

Et ensuite ?