Cosa sono i Token
Le informazioni contenute nei Campi delle Entità e molte altre informazioni di sistema (es. la data e ora del computer che ospita Drupal) sono accessibili e riusabili attraverso i Token. Un Token è una parola speciale che identifica una informazione della app e viene sostituita da Drupal col valore di quella informazione; è quindi un concetto molto simile alla "variabile" nei linguaggi di programmazione o alla "incognita" in matematica. Ad esempio, il Token [node:title] viene sostituito dal titolo di un Contenuto (node è un altro modo con cui sono chiamati i Contenuti in Drupal).
A cosa servono i Token
I Token si usano in molti punti della costruzione della app. Vedremo nelle Guide seguenti come usare i Token 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
- ed altro ancora.
Quali Token sono disponibili
Drupal mette a disposizione moltissimi Token. L'elenco dei Token messi a disposizione dal Core di Drupal sono elencati sul sito di Drupal. I moduli aggiuntivi possono aggiungere altri Token. Inoltre ad ogni Campo aggiunto ad una Entità corrisponde un ulteriore Token. Raccomando fortemente di installare il modulo aggiuntivo Token perché facilita la scoperta dei Token disponibili. Dopo la sua attivazione, in Estendi cerca "Token" e clicca 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" si trovano tutti i Campi relativi ai Contenuti.
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 pulsante "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 ed attivi 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).