Guida completa

Leggi questa Guida se hai deciso di installare Drupal sul tuo computer locale, altrimenti passa alla Guida per installare Drupal in cloud.

Per installare Drupal sul tuo computer locale, devi prima trasformarlo in un server e poi installarvi Drupal.

Come trasformo il mio pc in un server?

Per funzionare, Drupal richiede che sul computer siano presenti ed attivate i seguenti componenti software:

• un web server (es. Apache), che cura le comunicazioni tra Drupal e il pc o smartphone dell'utente
• un database server (es. MySQL o MariaDB), che gestisce il database in cui sono archiviate le informazioni necessarie a Drupal
• un interprete di linguaggio PHP, che esegue il codice sorgente di Drupal, scritto appunto in PHP
• composer, un tool che facilita l'installazione delle diverse librerie software di cui è composto Drupal

Se sei sul posto di lavoro, ti consiglio di rivolgiti all'informatico aziendale, che provvederà all'installazione di tutti questi componenti, probabilmente su un computer Linux, facendo riferimento a queste istruzioni nell sito di Drupal.

Se sei a casa o ti devi arrangiare con un computer Windows, la comunità Drupal raccomanda di usare DDEV, una procedura che installa e configura tutti i componenti necessari a Drupal. Semplificando un bel po', DDEV simula un server Linux sul tuo computer Windows. La procedura è guidata, ma richiede parecchie competenze sistemistiche e più di 250 GB di disco libero: per quest'ultimo motivo, non ho finora potuto provarla.

Qualcosa di più semplice?

Per computer Windows ci sono soluzioni più semplici e leggere di DDEV: anche se considerate meno stabili, sono ragionevolmente utilizzabili per app non troppo critiche. Queste soluzioni sono identificate con la sigla "WAMP" (dalle iniziali di Windows, Apache, MySQL/MariaDB e Php) e sono tutte dotate di una procedura di installazione semplificata. Dopo l'installazione, presentano tutte un pannello di controllo, attraverso cui configurare ed attivare i componenti software, ed un Terminale in cui digitare i comandi necessari all'installazione di Drupal. 

Tra le soluzioni WAMP più utilizzate ci sono XAMPP, WAMPserver, WAMP.NET e Laragon. Io ho utilizzato XAMPP fino alla versione 10 di Drupal, ma attualmente (settembre 2025) non è possibile usarla con la versione 11 di Drupal, perché XAMPP installa una versione di PHP (8.2) inferiore a quella richiesta da Drupal (8.3). WAMP.NET non installa composer. WAMPserver la conosco poco. Con Laragon ho installato Drupal 11 in pochi minuti sul mio portatile e quindi te la consiglio. La versione gratuita di Laragon non si autoaggiorna e all'avvio mostra un invito a comprare una licenza, però è un disturbo sopportabile. Le istruzioni che seguono sono esemplificate su Laragon, ma sono abbastanza simili per tutte le soluzioni WAMP.

Scaricato ed installato Laragon (o un'altra soluzione WAMP), occorre modificare la configurazione di Apache, MySQL e PHP per tener conto delle esigenze particolari di Drupal. In particolare:

CONFIGURAZIONE PHP: nel file di configurazione php.ini occorre impostare i seguenti parametri:

realpath_cache_size = 10M

memory_limit = 4G

In Laragon, si accede a php.ini col comando PHP - php.ini

Occorre inoltre attivare le estensioni di PHP 

gd (obbligatoria) 

opcache (raccomandata). 

In Laragon, per attivarle basta selezionarle dal menù PHP -  Estensioni 

Ok, ho trasformato il pc in un server. Come installo Drupal?

Una volta trasformato il pc in un server con tutti i componenti software sopra indicati, il pc è pronto ad ospitare Drupal.

Poiché sul tuo pc potresti voler ospitare più di una app costruite con Drupal, ti consiglio di fare una installazione separata di Drupal per ogni app, in modo che l'eventuale crash di una app non blocchi le altre. Inoltre questa scelta semplifica la futura migrazione delle singole app in cloud o su un altro server. Le istruzioni che seguono sono quindi da ripetere ogni volta che ti accingi a costruire una nuova app: 

1. Prepara in Apache una cartella in cui installare Drupal
2. Prepara in MySQL un database dedicato alla app
3. Prepara in Apache un indirizzo specifico per la app
4. Installa Drupal nella cartella
5. Configura Drupal per il primo utilizzo

Sono tanti passaggi, ma tutti abbastanza semplici (soprattutto con Laragon).

1. PREPARA LA CARTELLA DOVE INSTALLARE DRUPAL

Con l'aiuto del pannello di controllo della tua soluzione WAMP, identifica la cartella "base" in cui Apache memorizza le pagine da distribuire. Di solito si chiama www o htdocs. Trovata la cartella base, con Gestione Risorse di Windows crea in essa una sottocartella, dandole il nome della app (in minuscolo, senza spazi o caratteri speciali) che intendi costruire. Ad esempio, se la tua app si chiamerà "Gestione Prestiti", la sottocartella potrebbe chiamarsi "gestione-prestiti" o semplicemente "prestiti".

In Laragon, usa il comando Creazione veloce - blank e digita il nome della app. Laragon provvede non solo a creare la sottocartella nel posto giusto, ma crea subito anche il database omonimo in MySQL e crea l'indirizzo specifico per la app, semplificando le istruzioni successive. 

2.PREPARA IN MYSQL IL DATABASE DEDICATO ALLA APP

Se stai usando Laragon, il database è già stato creato nel passaggio precedente: col comando Attrezzi - HeidiSQL entra in MySQL, seleziona il database col nome della app, clicca l'icona Utenti, crea un utente con lo stesso nome della app e con password a tua scelta ed attiva tutti i privilegi dell'utente.

Con le altre soluzioni WAMP: dal pannello di controllo lancia la gestione di MySQL (di solito è phpmyadmin); entrato in MySQL, crea un nuovo utente dandogli il nome della app e con password a tua scelta, seleziona l'opzione per creare un database con lo stesso nome dell'utente ed attiva tutti i privilegi per quell'utente sul quel database.

3.PREPARA IN APACHE L'INDIRIZZO DELLA APP

Se stai usando Laragon, l'indirizzo è già stato creato nel primo passaggio ed è:

https://NOMEAPP.test

dove NOMEAPP è il nome che hai dato alla app. 

Con altre soluzione WAMP: DA SCRIVERE.

4.INSTALLA DRUPAL NELLA CARTELLA

Se stai usando Laragon, lancia il Terminale col comando Laragon - Terminale. Con le altre soluzioni WAMP, dal pannello di controllo lancia il Terminale.

Dentro il terminale, usando i comandi Windows cd e dir posizionati nella sottocartella della app e digita il comando:

Non dimenticare il punto finale "." perché dice a composer di installare Drupal nella cartella corrente.

5.CONFIGURA DRUPAL PER IL PRIMO UTILIZZO

Sul pc vai con un web browser sull'indirizzo della app aggiungendo web in fondo. Ad esempio, con Laragon è:

https://NOMEAPP.test/web

Nel web browser appare la procedura di prima configurazione di Drupal, in cui occorre specificare:

•  la lingua ("italiano")
• il tipo di installazione ("Standard")
• i tre parametri del database (utente, password, nome database) che hai definito nel passaggio 2
• l'indirizzo email del sito (la tua email)
• il nome utente dell'Amministratore Drupal (tipicamente "admin")
• la password dell'Amministratore (a tua scelta)
• l'indirizzo email dell'Amministratore (la tua email)
• il fuso orario ("Roma")
• se attivare le notifiche di aggiornamento (attivale) 

Ora Drupal è installato,  pronto all'uso e sei dentro Drupal come Amministratore. Prima di iniziare ad esplorare Drupal ti raccomando di installare anche l'utility Drush. 

Per installare Drupal in cloud, esegui questi passaggi:

1. Scegli il provider
2. Prepara presso il provider il sito che ospiterà Drupal
3. Installa Drupal nel sito

1. SCEGLI IL PROVIDER

Per scegliere il provider cerca "drupal hosting" e seleziona un servizio cloud con queste caratteristiche:

• per iniziare spendendo poco, è sufficiente un servizio del tipo "web hosting" o "condiviso", meno performante del noleggio di un server vero e proprio, ma molto meno costoso
• il servizio deve includere Apache, Php, MySql o MariaDB, che sono i componenti software necessari a Drupal
• In particolare, verifica che sia disponibile una versione PHP compatibile con quella richiesta Drupal (attualmente almeno PHP 8.3); per gli altri requisiti necessari vedi sul sito di Drupal
• il servizio deve fornire un Terminale in cui poter dare comandi; presso alcuni provider, è chiamato "Shell" o "ssh"; il Terminale è essenziale per poter installare Drupal e i suoi moduli aggiuntivi
• il servizio deve consentire di realizzare più "siti": per ogni app che vorrai costruire con Drupal ti serve un "sito" distinto, quindi più "siti" sono compresi nel servizio più app potrai realizzare con lo stesso abbonamento
• preferisci un servizio che mette a disposizione una procedura per l'installazione automatica di Drupal: non è strettamente necessario, ma se c'è ti semplifica la vita; presso molti provider, a questo scopo viene fornita l'applicazione Softaculous
• preferisci un servizio che mette a disposizione procedure di backup manuali o automatici, utilissime per ripristinare una app dopo un eventuale crash o hackeraggio.

Tra le offerte disponibili (luglio 2025), segnalo a titolo di esempio IONOS OVHcloud Netsons Infomaniak e Hostinger. Personalmente da anni uso Netsons e Infomaniak.

2. PREPARA IL SITO CHE OSPITERA' DRUPAL

Quando attivi un web hosting in cloud, normalmente ti viene assegnato anche un dominio internet, condiviso o tuo personale. Ad esempio, io ho comprato il dominio "bottasini.eu". Per ogni app che intendi ospitare nel cloud, devi prima predisporre il "sito" che la ospiterà e in cui installerai Drupal. Le istruzioni variano da provider a provider, però la procedura di creazione dei siti è solitamente molto guidata. Alla creazione di un nuovo sito, ti viene chiesto se intendi dedicargli l'intero dominio (es. "bottasini.eu") oppure un sottodominio (es. "buonivicini.bottasini.eu"): scegli questa opzione se intendi ospitare più app evitando di acquistare un dominio diverso per ogni app. Devi infine specificare la versione di PHP che intendi usare nel sito: ricordati che deve essere uguale o superiore a quella richiesta da Drupal (attualmente PHP 8.3)

3. INSTALLA DRUPAL NEL SITO

Dal pannello di controllo del provider entra nel sito che hai appena creato.

Se il provider ti mette a disposizione una procedura per l'installazione automatica di Drupal, usala: ti risparmierai una serie di attività. Ad esempio, col provider Infomaniak l'installazione di Drupal dentro un sito si presenta così:

La procedura di installazione automatica di Drupal crea il database dove la app memorizzerà le informazioni, installa nel sito i file che compongono Drupal e lo configura per il primo utilizzo. La procedura ti chiede solo alcune informazioni base, tra cui la lingua ("italiano"), la username dell'Amministratore (di solito si sceglie "admin"), la password dell'Amministratore (a tua scelta), l'email dell'Amministratore e del sito (normalmente, la tua email). Al termine della procedura automatica, Drupal è pronto all'uso. Prima però ti raccomando di installare anche l'utility Drush. 

Se il provider NON ti mette a disposizione una procedura per installare automaticamente Drupal nel sito, niente paura: ecco le istruzioni per installarlo manualmente. I passaggi sono questi:

• 3.1 Prepara il database
• 3.2 Installa Drupal nel sito
• 3.3 Configura Drupal per il primo utilizzo

3.1 Prepara il database 

Drupal necessita di un database per memorizzarvi la propria configurazione e le informazioni gestite dalla app. Dal pannello di controllo del provider, lancia il gestore di database (solitamente si chiama phpmyadmin). Le istruzioni che seguono valgono dentro phpmyadmin, ma non cambiano molto se l'applicazione offerta dal provider è un'altra.

• clicca Account utente e crea un nuovo utente
• Scegli come nome utente il nome della app che stai costruendo, per facilitarti l'abbinamento tra database e app
• Scegli una password non banale oppure chiedi di generarla automaticamente
• Accendi le opzioni per la creazione di un database con lo stesso nome dell'utente e per dare all'utente tutti i privilegi sul nuovo database
• Memorizza da qualche parte nome utente, password e nome del database, perché ti serviranno nell'ultimo passaggio
• Clicca "Esegui"

3.2 Installa i file di Drupal
Dal pannello di controllo del provider lancia il Terminale . In esso, usa i comandi Linux, per trovare la cartella che ha lo stesso nome del sito ed entrarvi:

• pwd (per sapere in che cartella sei)
• ls (per elencare il contenuto della cartella)
• cd (per spostarti di cartella)

Alcuni provider collezionano tutte le cartelle dei siti sotto un'unica cartella, ad esempio /sites, in questo caso, per entrare nella casella del sito digita nel Terminale:

dove NOMEAPP è il nome che hai dato al sito. Sempre nel Terminale digita il comando:

Il punto finale è importante perché dice a Composer di installare Drupal nella cartella corrente.

3.3  Configurare Drupal per il primo utilizzo

Al termine del precedente passaggio esci dal pannello di controllo del provider e lancia un web browser sul sito. Ad esempio, se hai creato il sito "buonivicini" nel dominio "bottasini.eu" lancia

https://buonivicini.bottasini.eu

Nel web browser appare la procedura di prima configurazione di Drupal, che chiede alcune informazioni per completare l'installazione, tra cui la lingua ("italiano"), la username dell'Amministratore (di solito si sceglie "admin"), la password dell'Amministratore (a tua scelta), l'email dell'Amministratore e del sito (normalmente, la tua email) e le tre informazioni definite al passo 3.2 (nome del database, nome dell'utente del database, password dell'utente del database).

Ora Drupal è installato e pronto all'uso. Prima però ti raccomando di installare anche l'utility Drush.

Cos'è Drush e a cosa mi serve?

Drush è una utility molto importante, perché ti permette di modificare la configurazione di Drupal da Terminale anziché da web browser. Quindi permette di agire sulla tua app anche quando, per qualche motivo, Drupal non risponde più da web browser. Oltre a fare da "salvagente" delle tue app, Drush consente di eseguire diverse operazioni di manutenzione su Drupal. 

Come installo drush?

Apri il pannello di controllo del tuo provider (se sei in cloud) o della tua soluzione WAMP (se hai installato Drupal sul tuo computer locale), lancia il Terminale, entra nella cartella dove hai installato Drupal e digita il comando:

Come si usa drush?

Una volta installato, verifica il funzionamento di Drush: apri il Terminale, entra nella cartella in cui hai installato Drupal e digita il comando:

Se sei in una installazione locale su Windows e ottieni un errore, prova con

I comandi che puoi dare a Drush sono elencati sul sito di drush. Qui sotto elenco quelli di uso più comune.

SALVARE LA TUA APP CON DRUSH

Se la tua app non risponde più nel web browser, puoi provare a recuperarla digitando il comando:

Questo comando pulisce la Cache (memoria temporanea di Drupal): talvolta basta questa semplice operazione per risolvere un crash di Drupal.

DISINSTALLARE UN MODULO

Se la tua app non risponde più dopo che hai installato un modulo aggiuntivo, con Drush puoi disinstallare quel modulo riportando la app in una situazione probabilmente funzionante. Col comando:

ottieni l'elenco di tutti i moduli installati. Identifica in esso l'esatto nome interno del modulo che vuoi disinstallare e poi digita il comando:

dove NOMEMODULO è il nome interno del modulo. che hai scoperto col comando precedente.

SBLOCCARE CRON

Se Cron non funziona più, puoi provare a sbloccarlo eseguendolo da Drush col comando:

Moduli aggiuntivi? Perché dovrei aver bisogno di altri moduli ?

Drupal è formato da un nucleo principale, detto Core e da moduli, ognuno dei quali aggiunge funzioni a Drupal. Ad esempio, la gestione di immagini e video è svolta dal modulo "Media". Quando installi Drupal, vengono installati il Core ed una ventina di moduli essenziali. Col comando Estendi del menù di Amministratore puoi vedere l'elenco di tutti i moduli presenti ed attivi. 

E' molto probabile che la tua app richieda funzionalità non offerte dalla installazione base di Drupal., quali ad esempio la gestione di calendari, mappe, mail ecc. Uno dei punti di forza di Drupal è che la comunità degli sviluppatori mette gratuitamente a disposizione migliaia di moduli aggiuntivi, in grado di soddisfare (quasi) tutte le esigenze. Anzi, talvolta la medesima esigenza è risolta con strategie differenti da moduli diversi e, col tempo, alcuni moduli vengono abbandonati a favore di quelli preferiti dagli utilizzatori di Drupal.

Dove trovo i moduli che mi servono?

Puoi esplorare l'elenco dei moduli disponibili sul sito di Drupal alla pagina:

https://www.drupal.org/project/project_module

Nel seguito di MieApp evidenzierò i moduli di utilizzo più comune per la creazione di app. Qui puoi vedere l'elenco completo dei moduli utilizzati nelle diverse Guide di MieApp. Ogni volta che cito un modulo, viene proposta una pagina con una breve illustrazione di cosa fa, col link alla pagina del sito Drupal che contiene una descrizione completa, i requisiti e le istruzioni per installarlo ed gli eventuali problemi noti. 

Come installo un modulo?

Con l'attuale versione di Drupal (11) non è possibile installare un modulo da web browser ma occorre agire da Terminale. Una volta identificato sul sito di Drupal il modulo che ti serve, per installarlo:

• Sul sito di Drupal vai nella pagina del modulo
• In quella pagina, copia l'istruzione mostrata a fianco di Install. L'istruzione è formata dal comando composer require seguito da nome e versione del modulo. Ad esempio

• è l'istruzione per installare il modulo EVA versione 3.1. Se la pagina mostra più versioni disponibili, installa la versione più recente compatibile con la versione di Drupal che stai usando (attualmente Drupal 11). Se un modulo non ha una versione compatibile con la tua versione di Drupal, non puoi usarlo e devi cercarne uno diverso che faccia quel che ti serve. Se possibile, non installare moduli in versione "alpha" perché sono instabili.
• Se hai trovato il modulo giusto ed hai copiato l'istruzione di installazione, passa al pannello di controllo del tuo provider cloud o della tua installazione locale, apri il Terminale, posizionati nella cartella dove hai installato Drupal ed incolla l'istruzione nel terminale.
• Al termine dell'installazione, lancia un web browser sulla tua app, entra come Amministratore, seleziona Estendi nel menù ed attiva il modulo appena installato. In alcuni casi, l'installazione di un modulo trascina con sé l'installazione di altri moduli necessari al suo funzionamento.

Ecco un video che mostra i passaggi per l'installazione di un modulo aggiuntivo, esemplificato sul provider Infomaniak:

Quali moduli aggiuntivi mi suggerisci?

La risposta dipende da cosa deve fare la tua app. Però ci sono moduli che, nella mia esperienza, mi ritrovo a installare praticamente sempre. Invece che elencarteli qui senza poter entrare nel merito, te li indicherò a mano a mano che servono nelle Guide che seguono. All'inizio di ogni Guida trovi elencati i moduli richiesti o consigliati in quella Guida. Ogni volta che citerò un modulo, cliccando su di esso potrai consultare una pagina con una breve spiegazione dello scopo del modulo stesso ed il link alla sua pagina nel sito Drupal, ad esempio vedi il modulo Token. Puoi anche consultare l'elenco completo dei moduli citati in MieApp.  

Aiuto! Dopo l'installazione di un modulo la app non risponde più

Se dopo l'installazione di un nuovo modulo la tua app non risponde più (caso raro, ma ahimè può succedere), disabilita il modulo con Drush come spiegata qui.

Una app di esempio

Da qui in poi, utilizzerò come esempio la costruzione della app "Buoni Vicini" per il prestito di attrezzi tra vicini di casa che puoi vedere in bozza qui:

https://buonivicini.bottasini.eu

Le credenziali per accedere alla app sono mostrate nella pagina di login.

Ovviamente non ti sto invitando a ricostruire sul tuo computer o in cloud proprio questa app: "Buoni vicini" è solo un piccolo esempio di cosa si può fare con Drupal, da cui puoi prendere spunto per costruire l'app di tuo interesse.

Per descrivere la app di esempio utilizzo il metodo che ti ho suggerito. Nelle Guide che seguono vedremo come realizzare tutti questi aspetti con Drupal.

Scopo

La app serve per facilitare la condivisione gratuita di attrezzi tra persone che abitano nella stessa zona o città.

Utenti

La app è utilizzata da molti Utenti, che possono prestare i propri attrezzi e chiedere in prestito gli attrezzi altrui. Non ci sono differenze di ruolo tra gli utenti. Per usare la app è necessario iscriversi. I visitatori non possono fare o vedere nulla. La gestione della app è riservata all'Amministratore e (in futuro) a utenti "gestori" che lo aiutano.

Funzioni

Formazione del Magazzino: Gli Utenti mettono a disposizione attrezzi di loro proprietà, caricando per ognuno di essi una scheda descrittiva nel "Magazzino" degli attrezzi. Un Utente può disabilitare temporaneamente nuovi prestiti su un proprio attrezzo (es. per manutenzione) o anche ritirarlo definitivamente dal Magazzino.

Prestito degli attrezzi: Consultando il Magazzino, un Utente può trovare un attrezzo di proprio interesse ed inviare una richiesta di prestito al proprietario dell'attrezzo. Richiedente e proprietario comunicano attraverso la app, senza necessità di esporre i propri contatti personali. Se il proprietario declina la richiesta (ad esempio perché  ritiene l'attrezzo inadatto alle necessità espresse) invita il richiedente a cancellare la richiesta. Altrimenti, il proprietario attiva il prestito in risposta alla richiesta, registrando le date di consegna e di restituzione.

Valutazione dell'esperienza: al termine del prestito, richiedente e proprietario possono esprimere una valutazione dell'esperienza. 

In più, l'Amministratore e i Gestori svolgono queste funzioni di gestione della app:

Gestione degli utenti: accettazione delle richieste di iscrizione e sospensione degli Utenti che si comportano male

Categorizzazione: predisposizione delle categorie con cui catalogare gli attrezzi per facilitarne la ricerca

Gestione anomalie: modifica e cancellazione di richieste e prestiti altrui per risolvere situazioni non previste 

Informazioni 

Attrezzi: Un attrezzo è un oggetto prestabile. Appartiene all'utente che lo aggiunge nel Magazzino della app. E' descritto da un nome breve, una immagine, una descrizione ed eventuali documenti allegati (es. Manuale d'utilizzo). E' catalogato in una Categoria (vedi sotto). Tutti gli Utenti possono aggiungere Attrezzi. Solo il proprietario dell'Attrezzo può modificarlo e cancellarlo. Tutti gli Utenti vedono tutti gli Attrezzi.

Categorie: Le Categorie aiutano a cercare gli Attrezzi nel Magazzino. Ogni Categoria appartiene ad un Ambito (es. la "falciatrice" appartiene al "giardinaggio"). Le Categorie sono predefinite dall'Amministratore. Tutte le Categorie sono selezionabili da tutti gli Utenti.

Richieste: Il prestito è diviso in due parti - Richiesta e Prestito - redatte da due Utenti diversi (il Richiedente ed il Proprietario dell'attrezzo richiesto). Una Richiesta può essere modificata e cancellata solo dal Richiedente ed è visibile solo al Richiedente ed al Proprietario dell'Attrezzo.

Prestiti. Il Prestito è redatto dal Proprietario dell'Attrezzo in risposta ad una Richiesta. Può essere modificato e cancellato solo dal Proprietario ed è visibile solo al Richiedente ed al Proprietario. Nel Prestito vengono scritte dal Proprietario le date di consegna e di restituzione dell'Attrezzo.

Messaggi. Un Messaggio è sempre riferito ad una Richiesta (non ad un Prestito, perché non tutte le Richieste ricevono in risposta un Prestito), può essere redatto dal Richiedente o dal Proprietario ed è visto solo da loro. Può essere modificato o cancellato solo dal suo autore. Per una Richiesta può essere scritto nu numero illimitato di Messaggi.  Ad ogni Messaggio è possibile allegare più immagini o documenti.

Valutazioni.  Una Valutazione è sempre riferita ad un Prestito e può essere espressa solo dal Richiedente e dal Proprietario solo una volta, dopo la riconsegna dell'Attrezzo. La Valutazione contiene un valore che esprime il grado di soddisfazione ed una eventuale nota. La Valutazione è visibile solo al Richiedente ed al Proprietario ed è utilizzata dalla app per le statistiche.

Automazioni

La app provvede autonomamente a:

• cancellare le Richieste rimaste senza risposta dopo tre mesi
• predisporre pagine di statistiche
• avvisare un proprietario quando c'è una nuova richiesta su un suo Attrezzo

Percorsi

I percorsi offerti agli utenti nella app sono descritti nella prossima pagina.

Nel diagramma che segue (disegnato con LibreOffice Draw), ogni riquadro grigio rappresenta una pagina della app, che può contenere una singola Entità (es. Attrezzo) con le informazioni ad essa correlate o un elenco di Entità (es. Magazzino). Gli ovali indicano i comandi che consentono all'utente di muoversi tra le pagine. In alcuni casi, il contenuto della pagina dipende dal ruolo dell'utente. Il diagramma ha come punto di partenza della app la pagina "Cruscotto", che presenta all'utente le informazioni relative alle sue richieste e prestiti aperti e i comandi per vederne i dettagli, attivare nuove richieste e consultare richieste e prestiti conclusi. In tutte le pagine è previsto un comando (non rappresentato nel diagramma) per tornare al Cruscotto. I colori facilitano la comprensione del diagramma: in giallo il percorso relativo agli Attrezzi, in blu le Richieste, in rosso i Prestiti e in verde i Messaggi. 

Cliccando sui riquadri grigi verrai portato alla corrispondente pagina del sito buonivicini.bottasini.eu 

La mappatura dei link sui riquadri è stata realizzata grazie al sito Image Map 

Cosa sono i Contenuti

I Contenuti sono il tipo di Entità meno "specializzato" e quindi più utilizzato per gestire informazioni nelle app. Prima di poter gestire in Drupal un qualsiasi Contenuto, è necessario costruirne il tipo: il Tipo di Contenuto fa da modello o "stampo" per la creazione di Contenuti di quel tipo.

Il Tipo di Contenuto definisce infatti quali Campi formano il Contenuto, i controlli da effettuare sui Campi e come mostrarli, quali Utenti possono inserire Contenuti di quel tipo ecc.

Appena installato, Drupal offre un paio di Tipi di contenuto molto semplici - la "pagina" e l'"articolo" - pensati più per i siti informativi che per una app.  

Quali Tipi di Contenuti servono

La costruzione di una app in Drupal parte proprio dalla identificazione dei Tipi di Contenuto che servono alla app. Per scoprire i Tipi di Contenuto che ci servono, occorre esaminare non solo quali tipi di oggetti, documenti, luoghi ecc. la app deve gestire, ma è opportuno considerare anche "oggetti" più astratti, come procedure, progetti, gruppi di lavoro ecc. 

Nella app di esempio, abbiamo visto che ci servono i Tipi di Contenuto "Attrezzo", "Categoria" "Richiesta", "Prestito", "Messaggio" e "Valutazione". Si noti che in questa app abbiamo deciso di dividere le informazioni relative al prestito su due Tipi: "Richiesta" e "Prestito": questa scelta facilita la protezione delle informazioni, perché di base in Drupal ogni utente può modificare i propri Contenuti e non quelli degli altri. In generale, è utile suddividere le informazioni in Tipi di Contenuto distinti pensando a come saranno condivisi in scrittura i Contenuti.    

Come costruire un nuovo Tipo di Contenuto

Ecco come Amministratore puoi costruire un nuovo Tipo di Contenuto:

• Vai in Struttura - Tipi di contenuto - Aggiungi un tipo di contenuto
• Scegli il nome per il nuovo Tipo (es. "Attrezzo") e digita una breve descrizione
• Scegli i valori per i seguenti Campi predefiniti:
  • Titolo, nome del Campo testo che lo identifica visivamente
  • Promosso alla prima pagina, opzione che lo colloca nella prima pagina del sito (poco utile nella costruzione di una app, lascialo spento)
  • Sempre in cima agli elenchi, opzione che lo colloca in cima agli elenchi (come sopra)
  • Crea una nuova revisione, opzione che genera diverse Versioni del Contenuto (salvo che la app abbia una specifica necessità di tener traccia delle modifiche apportate ad un Contenuto si può lasciare spento)
  • Visualizzare informazioni sull'autore e sulla data, opzione che mostra Autore e data di pubblicazione del Contenuto (da valutare se serve per la app, suggerisco di spegnerlo).

Per aggiungere Campi al Tipo di Contenuto:

• Vai in Struttura - Tipi di contenuto e clicchiamo Gestione campi a fianco del Tipo di Contenuto
• Clicca Create new field
• Scegli il tipo di Campo tra quelli proposti:

• nella pagina seguente, digita l'etichetta con cui il Campo sarà mostrato all'Utente, specifica se la compilazione del Campo è obbligatoria e quanti valori il Campo può accettare; ad esempio, un singolo Campo "Allegati" di tipo File può accettare più documenti, senza necessità di definire più campi "Allegato 1", "Allegato 2" ecc.

Ora costruisci nella tua installazione Drupal i Tipi di Contenuto che servono alla tua app !

Riusare i Campi 

In una app di media complessità, servono normalmente decine di Campi. Per ridurne la proliferazione, è possibile "riciclare" un Campo su più Tipi di Contenuto (e anche su altri tipi di Entità). Definito il Campo la prima volta in un Tipo di Contenuto, per riusarlo in un altro Tipo di Contenuto non cliccare Create new field ma clicca Riutilizzare un campo esistente e seleziona il Campo che intendi riusare. 

Titoli automatici

Il Campo Titolo è presente ed obbligatorio per tutti i Contenuti, ma in alcuni caso non è molto significativo. Nella app di esempio, mentre il Campo Titolo degli Attrezzi è utile per identificare l'attrezzo stesso, per le Richieste e le Proposte le informazioni utili a sono negli altri Campi e il Titolo può limitarsi a indicare il Tipo di Contenuto ed un codice identificativo univoco, ad esempio "Richiesta n. 253", delegando a Drupal la sua compilazione. 

Per automatizzare la compilazione del titolo devi installare i moduli " Automatic Entity Label" e "Token". Nel nostro esempio serve anche il modulo "Serial". Installati questi moduli:

• vai in Struttura - Tipi di Contenuto e seleziona Modifica a fianco del Tipo di Contenuto di cui vuoi automatizzare i titoli (es. "Richiesta")
• clicca Automatic label
• seleziona Automatically generate the label and hide the label field
• in Pattern for the label componi lo schema per la generazione dei titoli, utilizzando sia testo fisso (es. "Richiesta n.") sia i Token che recuperano i valori degli altri Campi del Contenuto: per conoscere i Token disponibili, clicca Sfoglia i token disponibili e naviga in Nodi  fino a trovare il Campo che vuoi sia riprodotto nel Titolo. 

Eliminare un Campo

Se ci ripensi e decidi che un Campo non ti serve più, puoi eliminarlo.  Drupal potrebbe avvisarti che l'eliminazione di quel Campo pregiudica il funzionamento di qualche parte della tua app, ad esempio potrebbe pregiudicare una Vista o un'altra configurazione in cui è utilizzato. Se decidi di procedere lo stesso, la Vista o il workflow non vengono cancellati ma vengono disabilitati, per consentirti di modificarle e rimetterle in linea senza quel Campo.

L'eliminazione di un Campo riusato ne comporta la scomparsa in tutti i tipi di Entità in cui è stata usato.

Se l'eliminazione di un Campo comporta troppo lavoro di sistemazione, potresti decidere di mantenerlo, limitandoti a nascondendolo nelle pagine di inserimento, modifica e visualizzazione dell'Entità cui appartiene.

Cambiare il tipo di un Campo

Se hai scoperto che un Campo numerico intero ti serve invece con numerico con la virgola, oppure che ti risulta più semplice gestire un Campo di tipo data come un Campo testo, in Drupal non c'è un meccanismo per cambiarne il tipo salvando i dati già inseriti. Ci sono moduli sperimentali che promettono di farlo, ma contengono sempre avvertenze. I più esperti propongono interventi diretti sul database, che richiedono competenze e molta attenzione. Quando mi è capitato di doverlo fare, ho scelto la strada più lunga ma più sicura: 

1. esportare in un file l'identificativo dell'Entità ed il valore del Campo, utilizzando il modulo Views Data Export
2. aggiungere alle Entità un nuovo Campo del tipo desiderato
3. importare dal file i valori nel nuovo Campo, utilizzando il modulo Feeds
4. eliminare il Campo iniziale

Esamineremo qualche dettaglio di questa tecnica in una apposita Guida

Nella Guida precedente hai creato uno o più Tipi di Contenuto dove memorizzare le informazioni di cui la tua app ha bisogno. In questa Guida vediamo i comandi base disponibili all'Amministratore per iniziare a popolare la app di Contenuti, cioè i cosiddetti comandi CRUD (Create Read Update Delete). Nelle Guide successive vedremo come preparare e mettere a disposizione degli Utenti della app funzioni più comode ed evolute.

Aggiungere contenuti alla app

Appena costruisci un nuovo Tipo di Contenuto, Drupal ti mette subito a disposizione una pagina attraverso cui puoi inserire Contenuti di quel tipo. Come Amministratore puoi richiamare la pagina di inserimento cliccando Contenuto - Aggiungi contenuto e selezionando il Tipo di Contenuto. Tutti gli altri Utenti richiamano la pagina di inserimento al link:

/node/add/tipo_contenuto

dove tipo_contenuto è il nome del Tipo di Contenuto che stai creando, es:

/node/add/attrezzo

Se l'ordine con cui i Campi sono mostrati nella pagina di inserimento non ti soddisfa, vai in Struttura - Tipi di contenuto e seleziona Gestione visualizzazione form a fianco del Tipo di Contenuto: ti viene mostrata una pagina in cui puoi riordinare i Campi trascinandoli. Nella medesima pagina, per alcuni tipi di Campi puoi anche cambiare la modalità (Widget) con cui compilarli. I Widget disponibili dipendono dal tipo di Campo e dai moduli installati. 

Ritrovare i Contenuti

Come Amministratore, in Contenuto trovi un semplice modulo per la ricerca dei Contenuti inseriti. Gli altri Utenti useranno il motore di ricerca di Drupal o - meglio - le Viste che tu metterai a loro disposizione.   

Come viene mostrato un Contenuto

Per ogni Contenuto inserito, Drupal predispone una pagina che lo visualizza al link:

/node/id_contenuto

dove id_contenuto è il codice univoco che identifica il Contenuto.

Se l'ordine con cui i Campi sono mostrati nella pagina di visualizzazione non ti soddisfa, vai in Struttura - Tipi di contenuto e seleziona  Gestione visualizzazione a fianco del Tipo di Contenuto: oltre a modificare l'ordine, puoi anche nascondere Campi o le loro etichette e, per alcuni tipi di Campi, modificare la modalità (Widget) con cui è mostrato il valore.  Per nascondere un Campo basta trascinarlo sotto Disattivati

Modificare un Contenuto

Per modificare un Contenuto, vai nella sua pagina di visualizzazione e clicca Modifica. Puoi anche andare direttamente alla pagina di modifica a questo link:

/node/id_contenuto/edit

Eliminare un Contenuto

Per eliminare un Contenuto, vai alla sua pagina di visualizzazione e clicca Elimina. Puoi anche andare direttamente alla pagina di eliminazione a questo link:

/node/id_contenuto/delete

Un Contenuto eliminato non è più recuperabile.

Nascondere un Contenuto

Se vuoi rendere invisibile un Contenuto senza eliminarlo (ad esempio per ripresentarlo più avanti), vai in Modifica del Contenuto e disattiva il Campo Pubblicato.

Definiti i Tipi di Contenuto utili alla nostra app (ed eventuali altri tipi di Entità), prima di proseguire nella costruzione della app è opportuno stabilire chi può agire sui Contenuti  e cosa può fare su di essi. Rinviando la gestione degli Utenti ad una Guida più esaustiva, vediamo qui una configurazione minimale degli Utenti e dei loro Permessi sulle Entità della nostra app.

Creazione degli Utenti

In Drupal possiamo distinguere tre grandi famiglie di Utenti:

• gli Amministratori
• gli Utenti autenticati (o "registrati"), cioè gli Utenti dotati di nome utente e password e che quindi possono entrare nella app
• gli Utenti anonimi o visitatori, cioè gli Utenti privi di nome utente e password e che quindi non possono entrare nella app ma solo consultare le sue pagine pubbliche 

Per costruire la app noi lavoriamo dentro Drupal come Amministratori. Gli Amministratori hanno tutti i poteri in Drupal, quindi non risentono di eventuali vincoli che valgono per gli altri Utenti. Per provare il corretto funzionamento della nostra app è quindi necessario interagire con essa come Utenti autenticati o Visitatori. A questo fine è utile definire nella app uno o più Utenti di prova, dando loro i permessi sulle Entità previsti dalla nostra app. 

Per creare un Utente:

• vai in Persone e clicca Aggiungi Utente
• digita email,  nome utente e password
• disattiva Notifica l'utente del nuovo profilo
• attiva Attivo e  Utente autenticato

Non è importante che email sia un indirizzo valido, a meno che tu stia provando funzioni che inviano mail. Definisci fin da subito una regola per la composizione dei nomi utente nella tua app, ad esempio nome.cognome  

Per la app di esempio, è opportuno definire due o tre Utenti di prova, perché la app prevede uno scambio di informazioni (Richieste, Prestiti, Messaggi) tra più Utenti

Per interagire con la app nei panni di questo Utente non Amministratore puoi:

• aprire sullo stesso pc su cui stai costruendo come Amministratore la app un secondo web browser (attenzione: non una seconda finestra dello stesso web browser ma proprio un altro web browser; ad esempio se come Amministratore stai usando Chrome, per l'Utente di prova usa Edge), oppure
• collegarti alla app da un pc diverso, oppure
• installare uno dei moduli (es. Masquerade o User Switcher) che consentono all'Amministratore di impersonare temporaneamente un altro Utente, senza necessità di utilizzare un altro web browser o un altro pc 

Ruoli degli Utenti

In Drupal gli Utenti appartengono ad uno o più Ruoli. Il Ruolo definisce cosa può fare l'Utente in Drupal. Utente autenticato è il Ruolo base cui appartengono tutti gli Utenti dotati di nome utente e password. Gli Utenti con Ruolo Amministratore hanno tutti i poteri dell'Amministratore. E' possibile definire ulteriori Ruoli con Persone - Ruoli - Aggiungi ruolo.

Nella app di esempio, tutti gli Utenti hanno gli stessi poteri quindi non è strettamente necessario definire ulteriori Ruoli. Potremmo però aggiungere un Ruolo "Gestore" cui delegare alcune funzioni dell'Amministratore senza però dar loro tutti i poteri dell'Amministratore, ad esempio il potere di modificare e cancellare Contenuti altrui sbagliati.

Per assegnare o togliere un Ruolo ad un Utente:

• va in Persone e clicca modifica sull'Utente
• Nella pagina di modifica, attiva (o disattiva) i Ruoli

Permessi degli Utenti

Definito un Ruolo, per stabilire cosa possono fare gli Utenti appartenenti al quel Ruolo occorre modificare i Permessi di quel Ruolo:

• va in Persone - Permessi: ti viene mostrata una tabella le cui righe sono i Permessi assegnabili e le colonne sono i Ruoli cui assegnarli
• cerca il Permesso desiderato
• attiva o disattiva l'incrocio tra la riga del Permesso e la colonna del Ruolo

Per la app di esempio avevamo stabilito che ogni Utente potesse aggiungere Attrezzi, Richieste, Prestiti e Messaggi e modificare o cancellare solo i propri Contenuti:

• in Persone - Permessi, cerca "Attrezzo"
• Per il Ruolo Utente autenticato attiva "Crea nuovo Attrezzo", "Elimina i propri Contenuti", "Modifica i propri Contenuti" lasciando disattivate le altre righe:

• ripeti l'operazione per "Richiesta", "Prestito" e "Messaggio"

Se definissimo un Ruolo "Gestore" potremmo attivare per esso anche i Permessi di modifica e cancellazione dei contenuti altrui. 

Limiti dei Permessi

L'assegnazione dei Permessi ai Ruoli è un meccanismo molto semplice e potente per autorizzare o negare azioni degli Utenti sulle Entità e sulle funzioni di Drupal. L'installazione di moduli aggiuntivi può aggiungere ulteriori Permessi assegnabili. Questo meccanismo presenta però alcuni limiti, che risulta già evidenti nella costruzione della app di esempio e che potresti riscontare anche nelle tue app.

Un primo limite è che non esiste un Permesso per nascondere un tipo di Contenuto ad un Ruolo: esiste solo un Permesso che autorizza o proibisce la visualizzazione di tutti i Contenuti (non importa il tipo né l'Autore), che è usato normalmente per nascondere tutti i Contenuti di un sito ai Visitatori. 

Un secondo limite è che i Permessi agiscono su tutti i Contenuti di un tipo, senza possibilità di definire Permessi a livello di singolo Contenuto o - meglio ancora - sul singolo Contenuto in base ai suoi Campi: nella app di esempio, non possiamo quindi nascondere una Richiesta (o un Prestito o un Messaggio) agli Utenti diversi dall'utente che chiede in prestito l'attrezzo e dall'utente che lo presta.

Come spesso accade in Drupal, ciò che non è possibile fare con i moduli base può diventare possibile installando un modulo aggiuntivo: vedremo più avanti moduli che consentono di assegnare uno o più Contenuti a più Utenti o a interi Gruppi di Utenti, specificando in dettaglio i Permessi di creazione, visualizzazione, modifica e cancellazione. Per ora, nella app di esempio utilizzeremo una tecnica di nascondimento dei Campi dei Contenuti basata sulle Viste, senza necessità di installare ed imparare altri moduli.

Come primo esempio, costruiamo la Vista "Magazzino" (prevista dalla app di esempio) che elenca gli Attrezzi messi a disposizione dagli Utenti per il prestito.

Costruire una nuova Vista

Per creare  la nuova Vista "Magazzino":

• Vai in Struttura - Viste - Aggiungi nuova vista.
• Scegli il nome della nuova vista ("Magazzino").
• In Mostra scegli contenuto di tipo "Attrezzo".
• Scegli di creare una Pagina e di mostrare il risultato come Tabella

Le sezioni della Vista

Salvata la Vista, si apre l'editor della Vista (Views UI), composto dalle seguenti sezioni, ognuna delle quali configura un aspetto della Vista:

(*) Questa sezione cambia nome e contenuto in base al tipo di Visualizzazione: si chiama Impostazione pagina se si è scelto di creare una pagina.

Nell'editor ritroviamo le scelte effettuate al momento della creazione della Vista: 

• nella sezione Visualizzazioni  compare una Visualizzazione di tipo Pagina e, come Formato la Tabella
• nella sezione Criteri del filtro compare un Filtro che limita la Vista ai soli Contenuti di tipo "Attrezzo"
• nella sezione Campi compare il "titolo" degli Attrezzi

Aggiungere Campi nelle sezioni

In molte sezioni della Vista è necessario aggiungere Campi per raggiungere il risultato desiderato. Indipendentemente dalla sezione, la modalità di identificazione e selezione di un Campo è sempre la medesima:

• Per aggiungere un Campo in una sezione, clicca Aggiungi a fianco della sezione
• Appare una finestra "Aggiungi campi", che elenca tutti i Campi disponibili nella Vista per quella sezione particolare
• Per facilitare la ricerca del Campo desiderato, seleziona in Categoria il tipo di Entità cui appartiene il Campo; ad esempio, se stai cercando il Campo che contiene la username degli Utenti, in Categoria seleziona Utente
• Per trovare il Campo desiderato, digita parte del suo nome in Cerca
• In caso di omonimie, per assicurarti di aver scelto il Campo desiderato, controlla nella colonna Descrizione che il Campo appartenga al tipo di Entità giusto
• Per selezionare il Campo, attiva la casella al suo fianco e clicca Aggiungi e configura campi

• Nella finestra di configurazione che appare successivamente, seleziona la Relazione che identifica l'Entità in cui leggere il Campo: se il Campo appartiene alla Entità principale su cui stai costruendo la Vista (cioè quella che hai scelto mentre creavi la Vista) non selezionare alcuna Relazione. Su questo punto tornerò con molti esempi, quindi per ora non preoccuparti.
• In base alla sezione in cui stai lavorando, la finestra di configurazione può chiedere altre informazioni, che spiegherò caso per caso.
• Salva

Scegliere quali Campi mostrare nella Vista

La sezione Campi elenca i Campi che la Vista mostra. Se, oltre al titolo dell'Attrezzo, vogliamo mostrare nella Vista "Magazzino" la sua immagine:

• nella sezione Campi clicca Aggiungi
• come spiegato sopra, cerca e seleziona il Campo "immagine" che appare in Attrezzo:

• Nella finestra di configurazione, come Stile immagine del Campo seleziona Miniatura per uniformarne e ridurne le dimensioni

Con la stessa modalità, aggiungi il Campo "Descrizione" e, nella sua configurazione, attiva Escludi dalla visualizzazione per non mostrarlo all'Utente: ci servirà tra poco per eseguire ricerche nel Magazzino.

Modificare l'ordine dei Campi

Se l'ordine delle colonne (Campi) nella tabella non ti soddisfa, nella sezione Campi clicca Rearrange e riordinali. 

Campi e Token

Ad ogni Campo aggiunto alla Vista corrisponde un Token che contiene il valore di quel Campo e che puoi usare negli altri Campi. Ogni Campo "vede" i Token dei Campi che lo precedono nella sezione Campi ma non "vede" i Token dei Campi che lo seguono, quindi l'ordine dei Campi influenza il riuso del valore di un Campo in un altro Campo. L'elenco dei Token visibili in un Campo è disponibile sotto Replacement patterns del Campo stesso e da lì può essere copiato ed incollato.

Per usare il valore di un Campo A in un Campo B:

• clicca sul Campo B
• Sotto Replacement Patterns di B trova il Token corrispondente al Campo A (lo riconosci sia dall'ordine di elencazione sia dal nome)
• Sempre sotto Replacement Patterns trova il Token corrispondente al Campo B (è l'ultimo Token elencato)
• Sotto Risultati di riscrittura attiva Sovrascrivere l'output di questo campo con testo personalizzato e come Testo digita un testo a tuo piacere, in cui puoi inserire sia il Token di A (che sarà sostituito dal valore di A) sia il Token di B (che sarà sostituito dl valore originario di B)

Modificare l'ordine delle Entità

Gli attrezzi sono elencati nella tabella in un ordine casuale. Se li vuoi ordinare per nome: 

• nella sezione Criteri di ordinamento clicca Aggiungi
• cerca e seleziona il Campo Titolo dell'Attrezzo
• nella finestra di configurazione, seleziona l'ordinamento ascendente.

Se metti più criteri di ordinamento, essi vengono eseguiti nell'ordine in cui sono mostrati, dall'alto verso il basso.

Filtrare le Entità

La  sezione Criteri del filtro elenca i Filtri che limitano quali Entità mostrare nella Vista. Un Filtro è formato di tre parti:

• il Campo su cui agisce il Filtro (es. "Stato")
• l'operatore con cui svolgere il confronto (es. è uguale a)
• il valore da confrontare col contenuto del Campo (es. "Disponibile")

Di default c'è sempre il Filtro "Contenuto pubblicato = Si", che evita di mostrare Contenuti tenuti nascosti. Nella Vista "Magazzino" troviamo anche il Filtro Tipo di Contenuto = Attrezzo che avevamo impostato nel momento della creazione della Vista. Per limitare la Vista ai soli Attrezzi attualmente disponibili, aggiungiamo un Filtro sul Campo "Stato" imponendo che sia uguale a "Disponibile".

Filtri esposti all'Utente

I Filtri impostati nella sezione Criteri del filtro sono per default nascosti all'Utente. Attivando Esponi questo filtro, per permettere ai visitatori di modificarlo, il Filtro viene mostrato perché l'Utente possa modificarne il valore ed eventualmente anche l'operatore (ma non il Campo su cui agisce). Ad esempio, il Filtro sopra descritto che limita la Vista ai soli attrezzi disponibili potrebbe essere esposto, per consentire all'Utente di scegliere di vedere anche gli Attrezzi di cui è stato sospeso il prestito. 

Cercare nella Vista

I Filtri esposti sono particolarmente utili per consentire all'Utente di trovare nella Vista le Entità che soddisfano uno o più criteri di ricerca. In particolare, se aggiungiamo ed esponiamo il Filtro Globale - Combina filtri dei campi, all'Utente verrà mostrata una finestra di ricerca, in cui digitare una o più parole che saranno cercate su più Campi contemporaneamente, purché i Campi siano tutti di tipo testo e siano presenti nella sezione Campi. Ecco come impostare la ricerca:

• nella sezione Criteri del filtro aggiungi il Filtro Combina filtri dei campi ed attiva Esponi questo filtro, per permettere ai visitatori di modificarlo
• come operatore seleziona Contiene ogni parola, in modo da poter stringere la ricerca digitando più parole
• in Scegli i campi da combinare per il filtraggio seleziona i Campi testuali in cui cercare; nella nostra Vista: "titolo" e "descrizione"

Paginare la Vista

Se l'elenco delle Entità mostrato dalla Vista è lungo, conviene presentarlo in pagine:

• Nella sezione Paginazione seleziona Risultati paginati, paginatore ridotto oppure Risultati paginati, paginatore completo
• Indica quante Entità mostrare in ogni pagina (es. "10") 

Aggiungere informazioni per l'Utente

Nella sezione Intestazione possiamo aggiungere informazioni che saranno mostrate all'Utente sopra l'elenco degli Attrezzi:

• aggiungi Riassunto del risultato - Globale - Mostra il riassunto del risultato, per esempio gli elementi per pagina. per mettere a disposizione dell'Utente il numero di Attrezzi elencati;
• in Visualizzazione digita "@total Attrezzi disponibili al prestito. Clicca su un Attrezzo per vederne le caratteristiche e chiederlo in prestito.<br>", dove @total sarà sostituito dal numero di Attrezzi elencati e "<br>" è una istruzione che dice di andare a capo.

Relazioni tra Entità

Nella Guida precedente abbiamo costruito una semplice Vista "Magazzino", che mostra le informazioni memorizzate nelle Entità scelte per quella Vista (gli Attrezzi). Vediamo ora come arricchire una Vista con informazioni memorizzate in altre Entità, collegate da relazioni alle Entità della Vista. 

Le relazioni tra Entità sono basate sui Campi Riferimento. Una Entità A è in relazione con una Entità B se l'Entità A ha un Campo Riferimento che rimanda all'Entità B. Rappresentiamo sinteticamente questa relazione come A → B

Grazie al Campo Riferimento, quando in una Vista si conosce l'Entità A si può risalire all'Entità B ed utilizzarne le informazioni insieme alle informazioni di A.

In una Vista basata sulle Entità di tipo A, per risalire alle corrispondenti Entità di tipo B occorre dichiarare la relazione A→B nella sezione Relazioni della Vista e poi usare la relazione nelle altre sezioni della Vista. 

Ad esempio, nella Vista "Magazzino" che elenca gli Attrezzi (A) vogliamo aggiungere le informazioni sulla Categoria cui ogni Attrezzo appartiene (B), grazie al Campo "Categoria" dell'Attrezzo che rimanda alla Categoria (Attrezzo → Categoria). Grazie al Campo predefinito "Autore" dell'Attrezzo, possiamo anche aggiungere alla Vista il nome del Proprietario dell'Attrezzo (Attrezzo → Autore).

Come dichiarare una relazione nella Vista

Per dichiarare la relazione Attrezzo → Categoria basata sul Campo "Categoria" dell'Attrezzo:

• nella sezione Relazioni della Vista clicca Aggiungi
• come spiegato, seleziona "Categoria" dell'Attrezzo, che è elencato come contenuto referenziato da seguito dal nome interno del Campo ("field_categoria") e che appare in: "attrezzo"

• Nella finestra di configurazione, come titolo amministrativo della relazione digita "categoria dell'attrezzo" perché, grazie a questa relazione, identifichi appunto la Categoria associata all'Attrezzo.

Per dichiarare la relazione Attrezzo → Autore basata sul Campo Autore dell'Attrezzo:

• nella sezione Relazioni della Vista clicca Aggiungi
• cerca "autore" e seleziona Utente - Contenuto - Nome utente dell'autore del contenuto e, come titolo amministrativo, digita "proprietario"

Come usare le relazioni nella Vista

Dichiarata una relazione A→B nella sezione Relazioni, per usare nelle altre sezioni della Vista un Campo dell'Entità B basta selezionare quella relazione nella finestra di configurazione del Campo. Ecco ad esempio come aggiungere alla Vista il Campo "titolo" della Categoria cui appartiene un Attrezzo:

• nella sezione Campi clicca Aggiungi
• Seleziona il Campo titolo e, nella finestra di configurazione, come Relazione seleziona "Categoria dell'attrezzo"

Ed ecco come aggiungere il nome del Proprietario dell'Attrezzo:

• seleziona Nome - Utente - Il nome dell'utente o dell'autore e, come Relazione, seleziona "proprietario"; come Etichetta digita "Proprietario"

Relazioni concatenate

Nella app di esempio, una Categoria (es. "Cesoia") può appartenere ad una Categoria superiore (es. "Giardinaggio"). La relazione Categoria → Categoria Superiore è basata sul Campo "Categoria Superiore" della Categoria. In una Vista basata sugli Attrezzi, con la catena di relazioni Attrezzo → Categoria e  Categoria → Categoria Superiore possiamo associare all'Attrezzo anche la Categoria superiore: 

Come esempio, vediamo come aggiungere alla Vista "Magazzino" anche il titolo della Categoria Superiore: 

• nella sezione Relazioni clicca Aggiungi
• seleziona il Campo "Categoria Superiore" della Categoria, elencato come Contenuto referenziato da field_categoria_superiore" che appare in Categoria
• Nella finestra di configurazione del Campo, come Relazione seleziona "Categoria dell'attrezzo" e come titolo amministrativo digita "Categoria superiore"

Non ci sono limiti alla lunghezza delle catene di relazioni: l'importante è nella sezione Relazioni le relazioni siano elencate nell'ordine corretto. Drupal evidenzia la dipendenza di una relazione da una precedente mettendone il nome tra parentesi: ad esempio "(categoria dell'attrezzo) categoria superiore" indica che la relazione che mette a disposizione le informazioni sulla categoria superiore dipende dalla precedente relazione "categoria dell'attrezzo"

In tutte le altre sezioni della Vista, per accedere ad un Campo di una Entità messa a disposizione da una relazione, basta selezionarla come Relazione nella configurazione del Campo. In questo modo, nella sezione Campi possiamo aggiungere alla Vista "Magazzino" il Campo "Sinonimi" della Categoria ed i Campi "Titolo" e "Sinonimi" della Categoria Superiore; nascondiamo i Campi "Sinonimi" (li useremo per la ricerca ma confonderebbero l'Utente se mostrati) e riordiniamo i Campi, per mostrare da sinistra verso destra prima la Categoria superiore (di cui possiamo cambiare etichetta in "Ambiente"), poi la Categoria ed infine l'Attrezzo vero e proprio:

Nella sezione Criteri del filtro Ora possiamo estendere la ricerca nella Vista "Magazzino" alla Categoria, alla Categoria Superiore ed ai loro Sinonimi:

• Nella sezione Criteri del Filtro seleziona il Filtro Globale: Combina filtri dei campi (esposto) che avevamo già creato
• In Scegli i campi da combinare per il filtraggio estendiamo la ricerca a tutti i Campi elencati, che ora includono titolo e descrizione dell'Attrezzo, titolo e sinonimi della Categoria e titolo e sinonimi della Categoria Superiore.

Infine, nella sezione Criteri di ordinamento ordiniamo gli Attrezzi per titolo di Categoria superiore, titolo di Categoria e titolo dell'Attrezzo. 

Relazioni inverse

Nelle Viste è anche possibile usare una relazione A→ B in senso inverso, cioè per identificare A partendo da B come se fosse B→ A  Ecco come.

Quando nella sezione Relazioni selezioni il Campo su cui si basa la relazione, al posto di selezionare la riga:

che identifica l'Entità B richiamata dal campo C dell'Entità A (quindi  A→ B), seleziona invece la riga:

che identifica l'Entità A come l'Entità che utilizza il Campo C per referenziare B (quindi B→ A). 

Ad esempio, per la relazione Attrezzo → Categoria, se selezioni la riga evidenziata in verde la usi in senso diretto (dall'Attrezzo risali alla Categoria), mentre se selezioni la riga evidenziata in giallo la usi in senso inverso (dalla Categoria risali all'Attrezzo).  

Nelle prossime Guide, sfrutteremo questa possibilità nella app di esempio, per trovare il Prestito attivato in risposta ad una Richiesta (per come abbiamo disegnato le Entità, la relazione va infatti dal Prestito alla Richiesta e non viceversa).

Nelle Guide precedenti abbiamo costruito la Vista "Magazzino", che elenca tutti gli Attrezzi disponibili al prestito. Vogliamo ora mettere a disposizione di ogni Utente una Vista "Miei Attrezzi" come una variazione della Vista "Magazzino" che mostra solo gli Attrezzi di proprietà dell'Utente stesso. Nella prossima Guida aggiungeremo i comandi per aggiungere un Attrezzo, passare da una Vista all'altra con un click e predisporre il comando che porta l'Utente al Cruscotto della app. 

I passaggi per ottenere questo risultato sono:

• creare la Vista "Miei Attrezzi" come variazione della Vista "Magazzino"
• aggiungere un Filtro a "Miei Attrezzi" che la limiti ai soli Attrezzi dell'Utente che sta usandola, cioè il cosiddetto Utente corrente (current user)

Puoi vedere il risultato guardando la Vista "Magazzino" e la Vista "Miei Attrezzi" sul sito di esempio.

Creare una variazione di una Vista

Per non creare la Vista "Miei Attrezzi" da zero, possiamo crearla una variazione della Vista "Magazzino" e poi adattarla alle nuove necessità. Per creare una variazione di una Vista esistente ci sono due metodi: fare una copia della Vista originale, oppure creare una nuova Visualizzazione della Vista originale. Vediamo entrambi i metodi ed i loro pro e contro.

Creare una nuova Vista come copia della Vista originale

I vantaggi di questo metodo sono la sua semplicità e l'impossibilità di rovinare per errore la Vista originale. Lo svantaggio è che qualunque modifica si apporterà in futuro alla Vista originale non verrà applicato automaticamente alla nuova Vista.

Creare una nuova Vista come nuova Visualizzazione della Vista originale.

Quando apporti una qualunque modifica in una delle due Visualizzazioni, nella casella Per puoi decidere se applicarla a tutte le Visualizzazioni oppure solo alla Visualizzazione selezionata in quel momento. Il pulsante in fondo conferma tale scelta:   

Il vantaggio di questo metodo è che puoi facilmente estendere le modifiche a tutte o alcune delle variazioni di una Vista. Vedremo inoltre in Guide successive che questo è il metodo standard per creare alcuni Viste che si allegano a Entità (EVA) o ad altre Viste. Lo svantaggio di questo metodo è che, se non si sta attenti, si rischia di rovinare una Vista funzionante applicando ad essa una modifica pensata per un'altra Visualizzazione della stessa Vista. Suggerisco questo secondo metodo quando la nuova Vista si differenzia dall'originale per pochi dettagli. 

Filtrare la Vista sull'Utente corrente

Abbiamo visto nella Guida precedente come usare in una Vista informazioni contenute in Entità collegate da un Campo Riferimento alle Entità principali della Vista stessa. Creata nella Vista "Magazzino" una nuova Visualizzazione "Miei Attrezzi", vediamo come aggiungervi l'informazione sull'Utente Proprietario dell'Attrezzo e usarla per filtrare gli Attrezzi, limitandoli a quelli di proprietà dell'Utente corrente.

In questa Guida vediamo come aggiungere comandi sopra o sotto l'elenco delle Entità mostrato nella Vista e come aggiungere comandi sulle singole Entità elencate nella Vista:

Aggiungere comandi alla Vista

Per "comando" intendo qui un link che, cliccato dall'Utente, consente di passare ad un'altra pagina della app o di aggiungere nuove Entità. Vedremo in Guide successive come aggiungere comandi che eseguono operazioni più complesse.

Come esempio, completiamo le Viste "Magazzino" e "Miei Attrezzi" con comandi che consentano di passare da una Vista all'altra e di passare al Cruscotto della app. Nella Vista "Miei Attrezzi" vogliamo anche aggiungere il comando per caricare un nuovo Attrezzo nella app. 

Perché il comando sia mostrato una volta sola (e non ripetuto per ogni Entità elencata dalla Vista) occorre posizionarlo nella sezione Intestazione o nella sezione Piè di pagina. della Vista. Per facilitarci il compito di aggiungere il comando senza dover scrivere codice HTML, suggerisco di installare ed attivare il modulo aggiuntivo Views Linkarea, che consente di aggiungere link alla Intestazione o Piè di pagina delle Viste senza necessità di conoscere il linguaggio HTML.

Grazie a questo modulo, ecco come aggiungere alla Vista "Miei Attrezzi" il comando "Aggiungi Attrezzo" in cima all'elenco degli Attrezzi:

Con la stessa modalità aggiungiamo alla Vista "Miei Attrezzi" il comando "Magazzino" per tornare al Magazzino (Testo del collegamento: "Magazzino" e Percorso del link: "/magazzino") ed il comando "Cruscotto" per andare al Cruscotto della app (Testo del collegamento: "Cruscotto" e Percorso del link: "/cruscotto"); nella Vista "Magazzino" i comandi "Cruscotto" e "Miei Attrezzi" ("/miei-attrezzi")

Aggiungere comandi sulle Entità elencate in una Vista

Per aggiungere su ogni singola Entità elencata in una Vista un comando che agisce su quella Entità si può aggiungere alla sezione Campi della Vista un Campo Testo personalizzato - Globale - Fornisce testo o link personalizzato. Ad esempio, volendo aggiungere a fianco di ogni Attrezzo elencato nella Vista "Magazzino" un comando "Coda" che elenca le Richieste ancora aperte su quell'Attrezzo:

Consultando la Vista "Magazzino" che abbiamo creato nelle Guide precedenti, un Utente può trovare un Attrezzo di suo interesse e, cliccandovi sopra, accedere alla pagina dell'Attrezzo. Vediamo come personalizzare la pagina dell'Attrezzo con informazioni e comandi che dipendono sia dall'Attrezzo sia dall'Utente (vedi esempio in azione) 

EVA: una Vista dentro la pagina di una Entità

Per arricchire la pagina di una Entità con informazioni prese da altre Entità e con comandi che dipendono dall'Entità e dall'Utente, possiamo usare le EVA (Entity Views Attachment), cioè Viste che vengono inserite ("allegate") nella pagina dell'Entità. Per costruire le EVA occorre installare ed attivare il modulo aggiuntivo EVA: Entity Views Attachment.

La creazione di una EVA richiede i seguenti passaggi;

Esempi di EVA

Con riferimento alla app di esempio, esemplifichiamo le potenzialità delle EVA personalizzando la pagina dell'Attrezzo. Come sempre, il metodo qui illustrato è generalizzabile per personalizzare la pagina di una qualunque Entità della tua app. Vogliamo che la pagina di ogni Attrezzo mostri:

Per ognuno dei riquadri sopra elencati dobbiamo costruire una EVA.  

EVA COMANDI DEL PROPRIETARIO

Questa EVA mostra al solo Proprietario dell'Attrezzo i comandi "Miei Attrezzi" e "Prestiti conclusi sull'Attrezzo".

EVA COMANDI PER NON PROPRIETARIO

Questa EVA mostra agli Utenti diversi dal proprietario dell'Attrezzo i comandi "Magazzino" e "Chiedi in prestito questo Attrezzo". Si può creare come duplicazione o variazione della precedente, cambiando oltre al nome (es. "Comandi Attrezzo non Proprietario") questi aspetti:

EVA DATI DELL'ATTREZZO

Di default, la pagina di una Entità mostra tutti i Campi dell'Entità stessa. Perché quindi creare una EVA per mostrarli? Per un paio di buoni motivi: 

• la pagina dell'Entità non mostra di default il nome del Proprietario dell'Attrezzo, che è contenuto in uno dei Campi predefiniti non elencato nella pagina (Campo Autore)
• usare una EVA al posto dell'esposizione diretta dei Campi consente di personalizzare la loro presentazione, ad esempio per affiancare al Campo Categoria dell'Attrezzo anche l'informazione sulla Categoria superiore. 

In generale, io preferisco usare una EVA per presentare i dati di una Entità anziché limitarmi a mostrarne i Campi. Per presentare in modo "allineato" etichette e valori dei Campi, può risultare utile installare ed attivare il modulo aggiuntivo "Views Flipped Table". Grazie a questo modulo possiamo costruire la Vista come tabella e poi "ruotarla" invertendo le righe con le colonne. Ad esempio se la Vista in formato tabella è così:

selezionando come Formato Flipped Table, la tabella viene mostrata così:

Se decidi di usare anche tu una Flipped View per mostrare i dati dell'Attrezzo a tutti gli Utenti:

EVA RICHIESTE E PRESTITI APERTI

Questa EVA mostra al solo Proprietario dell'Attrezzo l'elenco delle Richieste aperte sull'Attrezzo e l'eventuale Prestito concesso in risposta ad esse. 

Posizionare la EVA nella pagina

Ogni EVA è come se fosse un Campo aggiuntivo dell'Entità, il cui contenuto viene ricalcolato ogni volta che si richiama la pagina. Può quindi essere posizionato a piacere nella pagina dell'Entità, come abbiamo già visto per i Campi veri e propri: 

• In Struttura - Tipo di Contenuto - Attrezzo - Gestione visualizzazione trascina i "campi" EVA nell'ordine desiderato (es. "Dati Attrezzo" prima delle altre due) e salva.

In questa Guida vediamo come passare informazioni tra le pagine della app, in particolare come passare attraverso un link:

• uno o più valori alla pagina di inserimento o modifica di una Entità per precaricarne i Campi, esemplificato al caso della pagina di creazione di una nuova Richiesta
• uno o più valori ad una Vista, per filtrare le Entità elencate, esemplificato al caso della pagina che elenca i Prestiti conclusi effettuati dall'Utente corrente su uno specifico Attrezzo

Precaricare Campi di una Entità attraverso un link

In molte situazioni è utile precaricare attraverso un link uno o più Campi di una nuova Entità, per evitare all'Utente di selezionare nuovamente valori già noti dal contesto. Ad esempio, vogliamo che il comando "Chiedi in prestito questo Attrezzo" lanciato dalla pagina di un Attrezzo A precarichi nella nuova Richiesta il Campo "Attrezzo" con l'identificativo dell'Attrezzo A.  

Nella app di esempio questa tecnica è utile no solo nella creazione di una nuova Richiesta (che eredita l'identificativo dell'Attrezzo richiesto) ma anche nella creazione di un nuovo Prestito (che eredita l'identificativo della Richiesta cui risponde) e di un nuovo Messaggio (che eredita la Richiesta cui si riferisce).

Ciò è reso possibile dal modulo aggiuntivo Entity Prepopulate che quindi deve essere installato ed attivato. 

Attivato il modulo, servono due passaggi:

1. configurare il Campo "Attrezzo" delle Richieste a ricevere un valore dal link
2. configurare il link perché trasmetta quel valore

Per configurare il Campo:

• vai in Struttura - Tipi di contenuto - Richiesta - Gestisci Campi - Attrezzo - Modifica
• nella sezione Entity Prepopulate scrivi il Token [current-page:query:attrezzo]

Il Token [current-page:query:attrezzo] dice a Drupal di prelevare dal link ("query") della pagina corrente ("current_page") il valore associato all'argomento "attrezzo". Come sempre, non è necessario ricordare questo Token a memoria, perché è tra quelli consultabili dalla pagina di configurazione del Campo.

Predisposto il Campo "Attrezzo" della nuova Richiesta a ricevere il valore dell'argomento "attrezzo" scritto nel link, come già abbiamo visto in una Guida precedente costruiamo nella pagina dell'Attrezzo il comando "Chiedi in prestito questo Attrezzo" che corrisponde al link:

/node/add/richiesta?attrezzo={{ raw_arguments.nid }}

dove il Token contiene l'identificativo dell'Attrezzo.

Se dobbiamo passare ad una pagina di inserimento di una Entità due o più valori, destinati ad altrettanti Campi, il link diventa:

/node/add/richiesta?argomento1=valore1&argomento2=valore2&argomento3=valore3

Il carattere ? inizia l'elenco delle coppie argomento/valore, il carattere = associa l'argomento al suo valore ed il carattere & separa le diverse coppie tra loro

Filtrare una Vista attraverso il link: i Filtri contestuali

Un altro caso molto frequente nella costruzione di una app è filtrare l'elenco delle Entità di una Vista con valori scritti nel link di richiamo della Vista. 

Ad ognuno dei valori scritti nel link deve corrispondere un Filtro contestuale, cioè un Filtro scritto nella sezione Filtri contestuali della Vista, anziché nella sezione Criteri del filtro. Mentre un Filtro scritto nella sezione Criteri del Filtro prende il valore di confronto dalla configurazione stessa della Vista (Filtro "nascosto") o lo chiede all'Utente (Filtro esposto), un Filtro contestuale prende il valore dal link on cui viene richiamata la Vista. I valori devono essere scritti nel link nel medesimo ordine con cui i corrispondenti Filtri sono elencati nella sezione Filtri contestuali.

Applichiamo questo metodo generale al caso della Vista "Miei Prestiti conclusi" che, come si vede in figura, viene utilizzata due volte nella app di esempio: se richiamata dal Cruscotto, elenca tutti i Prestiti dell'Utente conclusi; se richiamata dalla pagina di un Attrezzo, elenca tutti i Prestiti dell'Utente conclusi su quell'Attrezzo. La Vista è la stessa in entrambi i casi, ma nel secondo caso deve essere filtrata passando alla Vista l'identificativo dell'Attrezzo. 

Costruiamo la Vista "Miei Prestiti Conclusi" che elenca tutti i Prestiti effettuati dall'Utente corrente e conclusi.

Il comando "Prestiti conclusi sull'Attrezzo" presente nella pagina dell'Attrezzo richiama quindi questa Vista col link:

/miei-prestiti-conclusi/{{ raw_arguments.nid }}

dove il Token {{ raw_arguments.nid }} contiene l'identificativo dell'Attrezzo., che viene utilizzato dal Filtro contestuale per limitare la Vista ai soli Prestiti conclusi che si riferiscono a quell'Attrezzo. 

Il comando "Miei Prestiti conclusi" presente nel Cruscotto richiama la Vista senza specificare un Attrezzo:

/miei-prestiti-conclusi

così che la Vista elenchi tutti i Prestiti conclusi dell'Utente corrente su tutti i suoi Attrezzi.

Se una Vista ha più di un Filtro contestuale, per passarle i corrispondenti valori verrà richiamata col link:

/pagina_della_vista/argomento1/argomento2/argomento3

dove il carattere / separa il percorso della Vista dagli argomenti e gli argomenti tra loro.

In questa Guida proseguiamo la costruzione della app di esempio, concentrandoci per motivi didattici sulla pagina "Richiesta" che mostra le informazioni relativa ad una Richiesta, all'eventuale Prestito attivato in risposta ad essa ed i Messaggi scambiati tra Richiedente e Proprietario dell'Attrezzo. Con le stesse tecniche qui spiegate si può proteggere anche la pagina "Messaggio" e la pagina "Prestito". Queste pagine hanno in comune il fatto che devono mostrare i loro contenuti sia al Richiedente sia al Proprietario, escludendo però tutti gli altri Utenti.

Usare le Viste per proteggere le informazioni

Rinviando ad una futura Guida soluzioni più sofisticate per la protezione delle informazioni, per gli scopi della app di esempio nelle pagine Richiesta, Messaggio e Prestito è sufficiente: 

1. nascondere tutti i Campi a tutti gli Utenti e
2. mostrarli solo al Richiedente ed al Proprietario, grazie a Viste EVA.

Come abbiamo già visto, per nascondere i Campi della Richiesta a tutti gli Utenti: 

• vai in Struttura - Tipi di contenuto - Richiesta - Gestione visualizzazione
• trascina tutti i Campi sotto Disattivati.  
• Salva

Dopo questa operazione, qualunque Utente acceda alla pagina di una qualunque Richiesta ne vedrà solo il titolo, che di per sé non "svela" nulla sul contenuto della Richiesta.

La pagina "Richiesta" è formata da un insieme di EVA che restituiscono queste informazioni ai diversi Utenti:

EVA COMANDI RICHIESTA PROPRIETARIO

La EVA "Comandi Richiesta Proprietario", che mostra al Proprietario i comandi "Cruscotto" e "Presta l'Attrezzo" è facilmente costruibile con le tecniche che abbiamo già visto nelle Guide precedente:

In realtà, così costruita, la Vista mostra il comando "Presta questo Attrezzo" anche se sulla Richiesta è già stato aperto un Prestito. Per motivi didattici sistemeremo questo aspetto nella prossima Guida.

EVA COMANDI RICHIESTA PROPRIETARIO

Questa Vista è costruibile come variazione della precedente, eliminando il comando "Presta questo Attrezzo" e filtrando per Richiedente e non per Proprietario.

Combinazioni di Filtri

EVA DATI RICHIESTA

La EVA "Dati Richiesta" che mostra i dati della Richiesta come Flipped  Table è facilmente costruibile in analogia alla EVA "Dati Attrezzo" che abbiamo già visto. Rispetto alle Viste fin qui esaminate, presenta però una complicazione, perché deve essere vista sia dal Richiedente sia dal Proprietario e solo da loro. 

Se ci limitassimo ad aggiungere alla EVA un Filtro che la limita al Richiedente ed un Filtro che la limita al Proprietario, in realtà nessuno vedrebbe la EVA, perché i Filtri sono per default considerati in AND logico tra loro, quindi il contenuto della Vista sarebbe visto da un ipotetico Utente che fosse contemporaneamente Richiedente e Proprietario. Ma nella nostra app il Richiedente non coincide mai col Proprietario. 

Perché la EVA funzioni col Richiedente e col Proprietario escludendo tutti gli altri Utenti, i due Filtri devono essere posti in OR logico tra loro, in modo che le informazioni siano mostrate se almeno uno dei due Filtri è soddisfatto. 

Ecco come mettere due Filtri in OR tra loro nella sezione Criteri del Filtro:

• aggiungi il Filtro "Proprietario=si" sull'Utente corrente
• aggiungi il Filtro "Richiedente=si" sull'Utente corrente
• clicca And/Or Arrange

• clicca Crea un nuovo gruppo di filtri

• per il nuovo gruppo di filtri seleziona come operatore O (=OR)

• trascina i due Filtri nel nuovo gruppo

• clicca Applica. Controlla che i due Filtri siano raggruppati a parte, in OR tra loro ed in AND con gli altri Filtri:

EVA MESSAGGI RICHIESTA

Questi Filtri in OR servono anche nella EVA "Messaggi Richiesta". Questa Vista gestisce i Messaggi scambiati tra Proprietario e Richiedente sulla Richiesta. Come la precedente, anche questa Vista deve essere mostrata al Richiedente ed al Proprietario e nascosta a tutti gli altri Utenti.

 Ecco come costruirla:

EVA COMANDI MESSAGGI RICHIESTA

Questa Vista mostra nella pagina della Richiesta il comando "Scrivi Messaggio" solo al Proprietario ed al Richiedente. Questo comando non può essere aggiunto come un link nella sezione Piè di pagina della EVA "Messaggi Richiesta" perché, dovendo essere mostrato anche in assenza di Messaggi, verrebbe mostrato anche a Utenti diversi dal Proprietario e dal Richiedente.  Questa EVA può essere facilmente costruita con le tecniche già viste:

Per completare la gestione dei Prestiti e dei Messaggi, è necessario proteggere la pagina del singolo Messaggio dallo sguardo di Utenti diversi dal Proprietario e dal Richiedente  come abbiamo fatto qui con la pagina della Richiesta:

Le stesse attività devono essere applicate anche al Tipo di contenuto "Prestito".

Campi condizionati

Oltre ai Filtri (esposti, nascosti, contestuali) illustrati nelle Guide precedenti, esistono altri metodi in Drupal per alterare il risultato mostrato da una Vista. In particolare, in questa Guida vediamo come modificare la visualizzazione dei Campi di una Vista in base al valore degli altri Campi, grazie ai Campi "condizionati". Mentre i Filtri intervengono sulle "righe" della Vista selezionando quali Entità mostrare, i Campi condizionati intervengono sulle "colonne" della Vista selezionando quali dati mostrare di ogni singola Entità in base al valore di altri Campi dell'Entità stessa. 

Per utilizzare i Campi condizionati è necessario installare ed attivare il modulo aggiuntivo "Views Conditional", che aggiunge il nuovo tipo di Campo Views Conditional - Viste - Output data based off of certain criteria .

Quando si aggiunge un Campo condizionato nella sezione Campi della Vista, devi specificarne i seguenti parametri:

Il risultato di un Campo condizionato così impostato è il seguente:

Esempio di utilizzo 

Nella Guida precedente avevamo costruito la Vista EVA "Comandi Richiesta Proprietario" che mostra al solo Proprietario dell'Attrezzo nella pagina della Richiesta i comandi "Cruscotto" e "Presta questo Attrezzo". Avevamo lasciato in sospeso il problema di non mostrare il comando "Presta questo Attrezzo" se esiste già un Prestito associato alla Richiesta. Il problema poteva essere risolto spezzando la Vista in due Viste: una che mostra il comando "Miei Attrezzi" filtrata solo sul Proprietario e un'altra che mostra il comando "Presta questo Attrezzo" filtrata sul Proprietario e sulla inesistenza del Prestito associato alla Richiesta. 

Per evitare di avere due Viste, coi conseguenti problemi di allineamento visivo tra i due comandi e per motivi didattici, vediamo come risolvere il problema con una sola Vista usando i Campi condizionati. Ecco come modificare la sezione Campi della Vista "Comandi Richiesta Proprietario":

Concatenazione di Campi condizionati

Per gestire casi più complessi, è possibile concatenare più Campi condizionati. Poiché un Campo condizionato è trattato da Drupal esattamente come i Campi "nativi" delle Entità gestite nella Vista, anche al Campo condizionato corrisponde un Token di nome {{ views_conditional_field }}, che può essere utilizzato come parametro nella impostazione di un secondo Campo condizionato, il cui valore dipenderà quindi dal valore del primo Campo condizionato.  La concatenazione può estendersi a tre o più Campi condizionati, il cui Token sarà {{ views_conditional_field }}, {{ views_conditional_field_1 }}, {{ views_conditional_field_2 }} ecc.

Se nella app hai bisogno di svolgere calcoli basati sui valori dei Campi delle Entità, puoi farlo con le Viste. Distinguiamo due casi diversi:

Campi calcolati in base ad altri Campi

La prima esigenza sopra indicata può essere risolta installando ed attivando il modulo aggiuntivo "Views Simple Math Field" che aggiunge alle Viste il Campo Simple Math Field -  Globale - Views field that performs simple math expressions. Nella configurazione di questo Campo è possibile scrivere una formula che calcola un valore sulla base del valore degli altri Campi presenti nella Vista. Nella formula si possono inserire operatori matematici, logici e di confronto ed altre operazioni complesse. 

Riprendendo l'esempio sopra citato, data l'Entità "Cassetta" con un Campo "Peso", che memorizza il peso in kg della frutta contenuta nella cassetta ed un Campo "Tipo di Frutta", che punta ad una Entità di tipo "Frutta" che ha un Campo "Prezzo al kg", se si elencano nella Vista i Campi "Peso" e "(Tipo d Frutta) Prezzo al kg" possiamo aggiungere un Campo di tipo Simple Math in cui scrivere la formula Peso * Prezzo_al_kg

Come esempio didattico, vediamo come aggiungere alla Vista "Miei Prestiti conclusi" della app di esempio che elenca i Prestiti su Attrezzi dell'Utente corrente un Campo che mostra la durata in giorni del prestito effettuato, calcolato come differenza tra la data di consegna dell'Attrezzo al Richiedente e la data di restituzione dell'Attrezzo al Proprietario. Diversamente dal precedente esempio che si limitava a moltiplicare due numeri, in questo esempio vediamo anche un metodo per calcolare la differenza in giorni tra due date.

Poiché un Campo di tipo Simple Math è trattato come un qualunque altro Campo, anche ad esso corrisponde un Token  - di nome {{ field_views_simple_math_field }} - che ne contiene il valore calcolato e che può essere a sua volta usato nei Campi successivi, tra cui ci possono essere altri Campi Simple Math.

Il valore calcolato in un Campo Simple Math è mostrato all'Utente, ma non salvato nella Entità, quindi non è disponibile al di fuori della Vista. Per salvare in un Campo dell'Entità un valore calcolato in base agli altri Campi dell'Entità stessa ci sono due modi, che richiedono altri moduli aggiuntivi:

• aggiungere all'Entità un Campo di tipo Computed, messo a disposizione dal modulo "Computed Field", che però richiede di programmare in PHP e che quindi esula dagli scopi di MieApp.
• disegnare col modulo "ECA" una procedura che, al salvataggio di una Entità, esegua un calcolo usando i Campi dell'Entità stessa e scriva il risultato in un ulteriore Campo dell'Entità. Questo metodo evita di dover programmare in PHP e sarà spiegato nella sezione Automazioni di MieApp  

Aggregare valori di un Campo delle Entità elencate 

Se invece si vuole calcolare un valore calcolato come aggregazione di un Campo delle Entità elencate, ad esempio il prezzo medio (o il peso medio) delle Cassette di frutta, occorre installare e attivare il modulo aggiuntivo "Views Aggregator Plus". 

Questo potente modulo consente di modificare in modo significativo una Vista, però in questo primo esempio ci limitiamo a sfruttarne la capacità di aggiungere in fondo alla Vista "Miei Prestiti Conclusi" sopra descritta la media della durata dei Prestiti effettuati: 

Nelle Guide precedenti abbiamo visto come assemblare una o più Viste (di tipo EVA) nella pagina di una Entità. Vediamo ora invece come assemblare più Viste dentro una semplice pagina di testo o dentro una Vista principale. Esemplifichiamo entrambi i metodi per costruire il Cruscotto messo a disposizione degli Utenti della nostra app di esempio

Il Cruscotto

La nostra app di esempio prevede una pagina "Cruscotto" che mostra all'Utente le informazioni ed i comandi essenziali per agire sia come Richiedente sia come Proprietario:

Le Viste qui sopra elencate sono facilmente costruibili in analogia alle Viste fin qui costruite nelle precedenti Guide e non vengono qui ulteriormente spiegate. Vediamo come assemblarle in una sola pagina "Cruscotto" utilizzando due metodi alternativi, basati su due differenti moduli aggiuntivi.

Viste in una Pagina

Un primo metodo è basato sul modulo "Insert View", che consente di inserire una o più Vista dentro il Campo testuale di una qualunque Entità. Installato ed attivato questo modulo, per inserire una Vista in un Campo testo, basta digitare nel testo il Token: 

[view:name=display=args] 

in cui:

• name è il nome ad uso interno della Vista, nome elencato da Struttura - Viste. E' l'unico parametro obbligatorio per questo Token.
• display è il nome della Visualizzazione dentro la Vista, nome mostrato nella sezione Altro della Vista come Nome ad uso interno. Se la Vista ha una sola Visualizzazione, si può omettere questo parametro
• args sono gli eventuali argomenti passati ai Filtri contestuali della Vista, separati da /. Se la Vista non prevede Filtri contestuali, su può omettere questo parametro dal Token 

Per creare il Cruscotto della app di esempio con questo metodo:

Questo metodo è semplice e consente di mescolare le informazioni fornite dalla Viste con testi fissi, immagini ecc. Se però una delle Viste richiamate necessita di valori per i propri Filtri contestuali e questi valori non sono fissi ma dipendono dal contesto in cui la pagina viene richiamata, allora quasi sicuramente occorre passare al metodo successivo.

Viste in una Vista 

Un secondo metodo, più potente e leggermente più complesso, è basato sul modulo "Views Field View" che consente di aggiungere ad una Vista "principale" una o più Viste "secondarie". Installato ed attivato questo modulo, per inserire nella Vista principale una Vista secondaria basta aggiungere nella sezione Campi della Vista principale il nuovo tipo di Campo Visualizza - Globale - Embed a view as a field. This can cause slow performance, so enable some caching. selezionando poi la Vista secondaria e specificando gli eventuali argomenti da passarle.

La Vista principale può passare alle Viste secondarie qualunque valore noto nella Vista principale stessa, compresi eventuali valori a sua volta ricevuti. Si crea così una catena di Viste che richiamano Viste, che può essere profonda a piacere, ma che è opportuno limitare ad uno o due passaggi per non incorrere in rallentamenti eccessivi o in complessità tali delle interrogazioni sul database da mandare in errore la app.

Nella app di esempio, aggiungiamo una Vista "Cruscotto" basata sull'Utente corrente (in modo da essere certi che la Vista venga mostrata anche quando l'Utente non abbia ancora emesso o ricevuto Richieste) e dentro questa Vista principale richiamiamo le Viste che mostrano le informazioni sopra elencate:

Da scrivere usando come esempio la Vista EVA  Messaggi

Nella precedente Guida abbiamo visto come creare una Vista basata sulla relazione "Attrezzo → Categoria". Grazie a quella relazione, partendo da un tipo di Entità (i Contenuti di tipo Attrezzo) la Vista mostra un altro tipo di Entità (i Termini della Tassonomia "Categoria di attrezzi"). 

Proseguendo nella realizzazione della app di esempio, vediamo ora come costruire la Vista "Categorie di attrezzi" da mostrare agli Utenti non ancora registrati ("visitatori") per invogliarli a iscriversi alla app. 

IL MODULO VIEWS TREE

Come tutte le Tassonomie, le Categorie di attrezzi sono organizzate in una gerarchia, il che significa che in ogni Categoria esiste un riferimento che la lega alla Categoria superiore, ad esempio la Categoria "Falciatrice" contiene un riferimento alla Categoria "Giardinaggio". 

Volendo rappresentare la gerarchia delle Categorie non come una tabella piatta, ci serve un formato di visualizzazione ad "albero". Questo formato non è disponibile nativamente nelle Viste, ma viene aggiunto installando in Drupal il modulo "Views Tree" (vedi questa Guida per sapere come installare un modulo).

CREAZIONE DELLA VISTA

Per creare e configurare la Vista "Categorie di attrezzi" procedi come per la precedente Vista: vai in Struttura - Viste - Aggiungi nuova vista, digita il nome della vista ("Categorie di attrezzi"). In Mostra seleziona "Termine di Tassonomia" di tipo "Categorie di attrezzi". Scegli di creare una "Pagina" di formato "Tree (List)". 

IMPOSTAZIONE DELLA RELAZIONE

Entrato nell'editor della Vista, aggiungi la relazione che lega un Termine di Tassonomia al proprio Termine superiore, che in Drupal è chiamato "genitore": nella sezione Avanzate - Relazioni clicca Aggiungi, cerca e seleziona "genitore":

VISUALIZZAZIONE AD ALBERO

Per usare Il formato ad albero, devi aggiungere nella sezione Campi della Vista l'identificativo dell'Entità "base" e l'identificativo dell'Entità "genitore". Per "Identificativo" si intende il codice univoco che identifica l'Entità, che nel caso dei Termini di Tassonomia è il Campo "ID Termine".  

Aggiungi quindi il Campo "ID Termine":

Nascondi questo Campo perché serve alla Vista per organizzare l'albero ma non serve mostrarlo all'Utente:

Aggiungi nuovamente il Campo "ID Termine" specificando stavolta come "Relazione" la relazione "genitore":

Nella sezione Campi hai quindi :
 

Per evitare che, cliccando sul nome di una Categoria il visitatore possa navigare nel sito, nel Campo "Termine della tassonomia: Nome" disattiva il parametro Collegamento a Termine della tassonomia.

Nella sezione Formato  ora puoi finalmente configurare l'albero: a fianco di "Tree (list)" clicca Impostazioni; come Main field seleziona il primo dei due Campi "ID Termine" e come Parent field il secondo dei due Campi "ID Termine" (corrispondente al termine "genitore"):

Nella sezione Anteprima ecco apparire l'albero delle Categorie degli attrezzi:

Se non sono in ordine alfabetico, nella sezione Criteri di ordinamento aggiungi due criteri: il primo ordina per nome del genitore del Termine ed il secondo per nome del Termine:

Per non spezzare l'albero su più pagine, nella sezione Paginazione imponi che siano mostrate tutte le Entità in una sola pagina:

Poiché questa Vista ha lo scopo di incentivare i visitatori a iscriversi alla app, nella sezione Intestazione aggiungi una "Area di testo" in cui scrivere un messaggio del tipo "Vorresti un attrezzo di questi in prestito gratuito? Sei disponibile a prestare gratuitamente ai tuoi vicini un tuo attrezzo?" e nella sezione Piè di pagina un'altra "Area di testo" con un testo del tipo "Per partecipare a "Buon Vicinato" clicca il comando "Accedi" per registrarti: la tua domanda sarà verificata e riceverai una mail di conferma."

Vedremo in una prossima Guida come far diventare questa Vista la pagina di benvenuto per i visitatori.

Puoi vedere questa Vista in azione qui e qui sotto la sua configurazione:

Velocizzare ma in una app è un problema perché può alterare il risultato atteso.

Entity view Filter o come si chiama

Filtri su intervalli di valore

VBO

https://www.drupal.org/project/views_bulk_edit

Redirezione automatica se si tenta di accedere ad una pagina della app tramite modulo Redirect 403 to User Login

menu

link ipertestuali

link generati da viste

viste EVA che generano link

Da scrivere, usando i moduli Feeds e Views Data Export

Cos'è Cron?

DA SCRIVERE

Come lo eseguo?

DA SCRIVERE

Se Cron va in errore...

Se il comando Configurazione - Cron - Esegui Cron dentro Drupal va in errore, puoi provare a sbloccarlo come spiegato nella Guida a Drush.

Perché devo aggiornare il Core ed i moduli aggiuntivi?

Con una buona frequenza la comunità di Drupal mette a disposizione aggiornamenti del Core e dei moduli. Gli aggiornamenti risolvono errori, aggiungono funzioni e, soprattutto, migliorano la sicurezza di Drupal. Drupal avvisa l'Amministratore quando sono disponibili aggiornamenti. In ogni momento, l'Amministratore può verificare la disponibilità di aggiornamenti sotto il menù Resoconti coi comandi Resoconto sullo stato e Aggiornamenti disponibili. 

Poiché ogni aggiornamento può malauguratamente introdurre problemi e persino crash alla tua app, se nel quotidiano utilizzo della app non riscontri errori installa subito solo gli aggiornamenti di sicurezza, rinviando gli altri fino a quando la versione del modulo che stai usando non diventa incompatibile con il Core o con altri moduli installati. La pagina mostrata da Aggiornamenti disponibili fornisce le informazioni essenziali per decidere.  

Prima di procedere ad un aggiornamento è sempre consigliato fare un backup della app, per poterla ripristinare in caso che l'aggiornamento provochi un blocco o crash della app.

Come aggiornare Drupal?

Come l'installazione, anche l'aggiornamento di Core e moduli non può essere effettuata dall'Amministratore dentro Drupal, ma deve essere effettuata da Terminale con Composer e Drush. Le istruzioni per aggiornare il Core all'ultima versione disponibile sono dettagliate sul sito Drupal. Le istruzioni per aggiornare un modulo sono le medesime che abbiamo già visto per la sua installazione.