Cos'e' Paragraphs
Paragraphs e' il modulo contrib più usato in Drupal per costruire contenuti modulari riusabili all'interno di un nodo. Mentre Layout Builder agisce sul layout di pagina, Paragraphs agisce sul contenuto: blocchi strutturati di tipi diversi inseribili in cascata dentro un campo.
Quando usare Paragraphs
Paragraphs eccelle quando gli editor devono comporre pagine assemblando "mattoni" predefiniti: hero, testo+immagine, CTA, gallery, accordion, FAQ. Ogni mattone (paragraph type) ha campi propri e template Twig dedicato. L'editor sceglie e ordina, senza toccare HTML.
Installazione
Via Composer:
composer require drupal/paragraphs drush en paragraphs
Si crea il primo paragraph type da /admin/structure/paragraphs_type, aggiungendo campi come per un content type.
Aggiungere il campo Paragraphs
Sul content type (es. Landing page) si aggiunge un campo di tipo Entity reference revisions verso Paragraph, cardinality unlimited, e si selezionano i bundle ammessi (es. solo hero, text, CTA per la landing).
Tipi paragraph comuni
- Hero: titolo, sottotitolo, immagine, CTA
- Text: rich text formattato
- Text + Image: due colonne con allineamento configurabile
- Gallery: collection di immagini con caption
- Accordion: paragraph nested con item child (nested paragraphs)
- Quote: testimonial con autore e ruolo
Nested paragraphs
Un paragraph può contenere altri paragraph (es. Accordion contiene N AccordionItem). Attenzione alla profondità: oltre 2-3 livelli l'editor si confonde. Considerare alternative come tabelle o Views.
Experimental Widget
Il modulo include il widget classico e un widget sperimentale più moderno. Considerare anche paragraphs_ee (Editor Enhancements) che migliora notevolmente l'UX con preview, drag-and-drop intuitivo e modale di selezione tipo.
Theming
Ogni paragraph type ha il proprio template Twig: paragraph--TYPE.html.twig. Esempio per Hero:
<section class="hero">
{{ content.field_image }}
<h1>{{ content.field_title }}</h1>
{{ content.field_cta }}
</section>Revisions
Paragraphs supporta revisioni: rollback di una pagina ripristina anche i paragraph nello stato corrispondente. Importante per workflow editoriali con Content Moderation.
Hai bisogno di aiuto?
Se vuoi un sito Drupal performante dal team di G Tech Group, scrivici tramite il modulo di contatto.