Cosa sono i Token
Ad ogni Campo delle Entità è associato un Token. Ad esempio, al titolo dei Contenuti è associato il Token [node:title] (node è il nome "storico" dei Contenuti in Drupal), mentre all'email degli Utenti è associato il Token [user:mail]. Ciò vale sia per i Campi predefiniti sia per i Campi aggiunti.
Oltre ai Token associati alle Entità, esistono Token corrispondenti a informazioni di sistema, tra cui quelli relativi alla installazione stessa di Drupal (es. [site:name] corrisponde al nome del sito), alla data e ora di sistema (es.[current-date:medium] corrisponde alla data e ora correnti nel formato "medio") e all'utente che sta usando la app (es. [current-user:last-login] corrisponde a data e ora in cui l'utente ha fatto login).
Quando Drupal incontra da qualche parte nella app il nome di un Token, lo sostituisce col suo valore. I Token servono quindi per riusare i valori dei Campi delle Entità e le altre informazioni in essi contenuti. Il Token è quindi un concetto molto simile alla "variabile" nei linguaggi di programmazione o alla "incognita" in matematica.
A cosa servono i Token
Vedremo che i Token si usano in molti punti della costruzione di una app, ad esempio per:
- creare titoli automatici dei Contenuti
- precaricare i valori di Campi nella creazione di nuovi Contenuti
- conoscere chi è l'Utente corrente che sta usando una Vista
- riusare il valore di Campi in altri Campi in una Vista
- costruire comandi che passano valori da una pagina ad un'altra pagina della app
- fare calcoli nelle Viste
- richiamare Viste in Campi testuali
- costruire procedure automatizzate
- e molto altro ancora.
Il motivo per cui descrivo ora i Token è proprio perché serviranno già a partire dalla prossima Guida.
Elenco dei Token disponibili
L'elenco dei Token messi a disposizione dal Core di Drupal sono elencati sul sito di Drupal. Spesso l'installazione di nuovi moduli aggiunge ulteriori Token. Infine, come abbiamo appena visto, ad ogni Campo aggiunto alle Entità corrisponde un nuovo Token. Per vedere tutti i Token disponibili nella tua installazione di Drupal ti raccomando di installare il modulo aggiuntivo "Token". Dopo la sua attivazione, con Estendi - Token - Help per vedere tutti i Token disponibili.
I Token sono raggruppati in una gerarchia, che consente di "scendere" da una Entità ai suoi Campi. Ad esempio sotto la voce "Nodi" trovi i Token corrispondenti ai Campi dei Contenuti (non suddivisi per tipo di Contenuto).
Non è necessario ricordare a memoria i Token e neppure tornare ogni volta a questa pagina perché, in ogni punto in cui Drupal accetta Token, viene mostrato un comando "Token" che richiama la gerarchia dei Token (ad esempio ciò accade nella pagina di configurazione dei titoli automatici delle Entità o nella configurazione delle procedure automatiche), oppure viene mostrato un elenco ridotto ai soli Token disponibili in quel punto (ad esempio, ciò accade nella costruzione delle Viste, sotto Sfoglia i Token disponibili o Replacement patterns).
Se installi il modulo aggiuntivo "Twig Tweak", potrai anche accedere ad ulteriori Token di sistema.
Come si usano i Token
In base al contesto in cui vengono utilizzati, i Token si presentano tra parentesi quadre es: [node:title] oppure tra parentesi graffe es: {{ node.title.value }}. Non è necessario comprendere in dettaglio questa differenza, perché Drupal provvede a mostrare i Token nella forma utile al contesto.
Una volta trovato il Token desiderato, se ne copia il nome (selezionandolo e cliccando col pulsante destro il comando "Copia" oppure con la combinazione CTRL C) e lo si incolla nella casella dove serve (comando "Incolla" o CTRL V).