GSA

Drupal

Parte della documentazione esiste già https://test-gsa.ms3dev.it/documentazione/docs/intro/

Tema

Il tema è custom.

Struttura del tema

• css
• js
• templates:
  • block: blocchi
  • content: file relativi a tipi di contenuto specifici
  • field: file relativi a specifiche field
  • layout: pagine parenti, la più rilevante è page, chiaramente il file parente di tutte le pagine
  • navigation: c'è solo il menu
• gsa.theme: In questo file c'è la parte PHP del sito (tipo functions.php su Wordpress). Al momento ci sono tutte le query che riguardano i blocchi, ogni if è relativo ad un blocco quindi if ($variables['plugin_id'] == 'block_content:31078cdc-4a55-4e0f-aa7c-5910b62e1a6e') vuol dire che sto controllando che nella pagina corrente ci sia il blocco con quell'id (che sarebbe anche il nome del file presente nella carterlla block del tema).

Creazione di un blocco

Un blocco è formato da 2 parti, il blocco e il tipo di blocco.

Il tipo di blocco definisce i campi (fields) che saranno utilizzabili nel blocco. Diciamo che è la parte astratta.

Il blocco sarebbe la parte concreta, che avrà i campi del tipo di blocco scelto.

note

Ricordarsi di controllore il Tab Gestione Visualizzazione, da qui bisogna nascondere le etichette e scegliere il tipo di ritorno del dato. Si possono guardare esempi già esistenti da cui copiare questi dati.

Una volta creato il blocco e compilati i suoi campi, questo dovrà essere messo nel layout della pagina in cui si vuole mostrarlo. Il Layout si trova all'interno della pagina nel backoffice di Drupal, in una tab in alto.

Una volta aggiungo il blocco al Layout vedrai che non hanno una grafica, ma ci saranno solo i dati inseriti nel blocco mostrati come un testo semplice.

Per dare una grafica al blocco, andare nel frontend del sito ed ispezionare la pagina in corrispondenza del blocco. All'interno di alcuni commenti HTML ci sarà il percorso del file da creare per stilizzare il blocco.

I blocchi si trovano nella cartella block all'interno del tema, una volta creato il file con il nome riportato nel commento si può creare l'HTML del blocco. Per mostrare i dati delle fields del blocco bisogna stampare nel twig le variabili relative. (es. nel blocco c'è una field che si chiama field_titolo, nel twig sarà content.field_titolo)

tip

Il modo in cui vanno stampate le variabili nel twig cambia a seconda del tipo della field, guardare sempre esempi esistenti in altri blocchi, nel sito ce ne sono tanti, di tutti i tipi.

Anche il tipo di ritorno citato in precedenza cambia il codice da scrivere nel twig, per questo bisogna fare attenzione a Gestione Visualizzazione.

Se si hanno difficoltà con la stampa di questi dati, purtroppo c'è poco da fare, bisogna cercare e fare varie prove. Una documentazione precisa su questo aspetto non l'ho mai trovata.

Lista blocchi

Nella cartella block del tema c'è un file .txt con la lista dei blocchi cosi da poterli trovare più facilmente, sarebbe bene tenere aggiornata questa lista.