Definizione di un tema tramite il file .info.yml

Per creare un tema in Drupal 8, devi prima creare un file THEMENAME.info.yml, che fornisce i metadati del tuo tema a Drupal. È simile al modo in cui vengono definiti i moduli e i profili di installazione, ed è quindi importante impostare la chiave type nel file file.info.yml su theme, per distinguerlo.

Questa pagina contiene un esempio di file THEMENAME.info.yml e una panoramica delle informazioni che il file può contenere.

Crea il file .info.yml

Crea un file .info.yml nella radice della cartella del tuo tema. La cartella deve avere lo stesso nome del file .info.yml. Quindi, se il tuo tema si chiama “Fluffiness”, la cartella sarà fluffiness/ e il file .info.yml sarà fluffiness/fluffiness.info.yml. Se il file è presente con le proprietà minime richieste (name, type e core), il tuo tema verrà visualizzato sul tuo sito Drupal nella sezione Gestione > Aspetto (http://example.com/admin/appearance). Ricorda di scegliere un nome tema che non sia già usato da un modulo o da un altro tema. Il nome del tema deve essere univoco nella configurazione di Drupal. Altrimenti, i componenti del tema non verranno caricati correttamente.

Sostituisci gli spazi nel nome del tema con trattini bassi (_) nel nome della cartella (e nel nome del file .info.yml).

Se non conosci la struttura dei file YAML, leggi questa breve introduzione al formato YAML.

• Le tabulazioni NON sono consentite. Usa SOLO spazi.
• Proprietà ed elenchi DEVONO avere un'indentazione di due (2) spazi.

Esempio

name: Fluffiness
type: theme
description: 'A cuddly theme that offers extra fluffiness.'
core: 8.x
libraries:
  - fluffiness/global-styling
base theme: classy
regions:
  header: Header
  content: Content
  sidebar_first: 'Sidebar first'
  footer: Footer

Nel tuo sito Drupal puoi trovare altri esempi di file .info.yml guardando i temi forniti dal core. Ad esempio, apri la cartella core/themes/stark e cerca il file stark.info.yml.

Coppie chiave/valore

Le seguenti coppie chiave/valore forniscono metadati sul tuo tema e definiscono alcune funzionalità di base. (Vedi \Drupal\Core\Extension\InfoParserInterface::parse().)

• name (obbligatorio)
• type (obbligatorio)
• description (opzionale)
• package (opzionale)
• core (obbligatorio)
• php (opzionale)
• version (opzionale)
• libraries (opzionale)
• libraries-override (opzionale)
• libraries-extend (opzionale)
• base theme (consigliato)
• hidden (opzionale)
• engine (opzionale)
• logo (opzionale)
• screenshot (opzionale)
• regions (opzionale)
• regions_hidden (opzionale)
• features (opzionale)
• stylesheets-remove (sconsigliato)
• ckeditor_stylesheets (opzionale)

Ulteriori informazioni

• Aggiungere fogli di stile (CSS) e JavaScript (JS) al tema in Drupal 8
• Una descrizione completa di tutte le chiavi disponibili in un file *.info.yml si trova qui: Fai sapere a Drupal 8 del tuo modulo con il file .info.yml.
• Change record: i file .info sono ora file .info.yml