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:
| Comando nella Intestazione della Vista | |
| Entità 1 | Comando sulla Entità 1 |
| Entità 2 | Comando sulla Entità 2 |
| Entità | Comando sulla Entità 3 |
| Comando nel Piè di pagina della 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:
| aggiungi il link in cima all'elenco | nella sezione Intestazione aggiungi Link - Globale - Provide an internal or external link |
| mostra il comando anche se non ci sono ancora Attrezzi dell'Utente | nella configurazione del link attiva Visualizza anche se la vista non da risultati |
| scegli il testo del comando da mostrare all'Utente | in Testo del collegamento digita "Aggiungi Attrezzo" |
| definisci cosa esegue il comando | in Percorso del link digita il link da eseguire "/node/add/attrezzo" |
| mostra il comando come un pulsante colorato anziché solo come un link | in Classe del link digita "btn btn-primary" (questa opzione può cambiare in base al tema grafico installato) |
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:
| trova l'identificativo dell'Attrezzo e nascondilo | nella sezione Campi aggiungi ID - Contenuto e attiva Escludi dalla visualizzazione |
| aggiungi il Campo che conterrà il comando | nella sezione Campi aggiungi Testo personalizzato - Globale - Fornisce testo o link personalizzato. |
| definisci come si presenta il comando all'utente | come Testo del Campo digita "Coda", in Risultati di riscrittura attiva Mostra questo campo come un collegamento personalizzato. |
| definisci cosa succede quando l'utente clicca il comando | come Percorso del link digita l'indirizzo della Vista che elenca le Richieste aperte sull'Attrezzo (es. "/richieste-aperte") passandole l'identificativo dell'Attrezzo stesso, che è contenuto nel Token {{ nid }} corrispondente al primo Campo e che trovi elencato sotto Replacement patterns, es. "/richieste-aperte/{{ nid }}" |