Inclusione degli stili immagine predefiniti con il tuo tema

02/10/2025, by Ivan

Drupal dispone di un potente sistema di gestione delle immagini, che consente di creare stili immagine in grado di applicare vari effetti a un’immagine e generare derivati a partire dall’immagine originale. Questa funzionalità può essere utilizzata nei temi che vogliono includere un set di stili immagine predefiniti, creati per funzionare con il tema stesso, invece di fare affidamento su quelli forniti dal core.

Il processo di inclusione di uno stile immagine nel tuo tema è simile al processo di inclusione della configurazione predefinita in un modulo.

Crea lo stile immagine che vuoi includere usando l’interfaccia utente
Esporta lo stile immagine in formato YAML
Includi lo YAML esportato nella cartella config/install del tuo tema, seguendo le regole di denominazione appropriate.

Inizia creando uno stile immagine tramite l’interfaccia amministrativa in «Configurazione» > «Multimedia» > «Stili immagine» (admin/config/media/image-styles). Una volta creato e salvato lo stile immagine, la configurazione che lo definisce sarà salvata nella configurazione attiva del tuo sito.

Questa configurazione può essere esportata tramite:

lo strumento di importazione/esportazione singola in Configurazione > Gestione configurazione > Importazione/Esportazione singola > Esporta (admin/config/development/configuration/single/export).
dal menu a tendina seleziona «Stile immagine» come tipo di configurazione
poi seleziona il tuo stile immagine dall’elenco dei nomi di configurazione.

La rappresentazione YAML dello stile immagine sarà mostrata in un’area di testo e potrà essere copiata e incollata in un file .yml nella cartella config/install del tuo tema. I file di configurazione seguono uno schema di denominazione specifico: image.style.{nome stile immagine}.yml. Se non sei sicuro di quale nome usare per il tuo file, esso sarà mostrato sotto l’area di testo con la configurazione esportata.

Nota che la configurazione esportata conterrà una chiave UUID come prima riga. Questo UUID deve essere rimosso prima di copiare la configurazione in un nuovo file image.style.{nome stile immagine}.yml.

Esempio THEMENAME/config/install/image.style.black_white.yml

langcode: en
status: true
dependencies: { }
name: black_white
label: 'black & white'
effects:
  8d4f85cc-9a2d-4a30-af15-21b0833dc06d:
    uuid: 8d4f85cc-9a2d-4a30-af15-21b0833dc06d
    id: image_desaturate
    weight: 1
    data: { }
third_party_settings: { }

Puoi includere qualsiasi numero di stili immagine con il tuo tema. Tutti verranno importati nella configurazione attiva al momento dell’installazione del tema.

Nota bene: dopo l’installazione del tema, modificare il file YML dello stile immagine in config/install non avrà alcun effetto, così come non avrà effetto aggiungere un ulteriore file YML di stile immagine in config/install.

Extra Block Types (EBT) - Nuova esperienza con Layout Builder❗

❗Extra Paragraph Types (EPT) - Nuova esperienza con Paragraphs

Inclusione degli stili immagine predefiniti con il tuo tema

Menu