Cosa sono i Token
Un Token è una piccola stringa di testo racchiusa tra parentesi quadrate, ad esempio [node:title] o [current-user:name], che funziona come un segnaposto: quando Drupal incontra un Token, sostituisce quella stringa di testo col dato corrispondente. Ad esempio, se un testo contiene la stringa [current-user:name], quando quel testo viene mostrato la stringa viene sostituita col nome dell'utente corrente che sta usando la app; perciò se il testo è "Ciao [current-user:name]", all'utente di nome Mario viene mostrato come "Ciao Mario", mentre all'utente Carlo viene mostrato come "Ciao Carlo".
Il valore di alcuni Token dipende dal contesto: ad esempio [node:title] viene sostituito col valore del Campo "titolo" del Contenuto (=nodo) mostrato in quel momento.
Token disponibili
In Drupal sono disponibili decine di Token predefiniti, tra cui i due usati come esempio. L'elenco di questi Token è disponibile sul sito di Drupal. L'installazione di moduli aggiuntivi può aggiungere ulteriori Token. E se installi il modulo aggiuntivo "Twig Tweak", potrai anche accedere ad ulteriori Token di sistema, per qualche motivo tecnico non presenti nel Core.
In più, ad ogni Campo che aggiungiamo ad un Bundle viene associato un nuovo Token, formato dal nome del Bundle seguito dal nome interno del Campo. Ad esempio, se aggiungiamo agli Utenti un Campo "Telefono", viene associato il Token [user:telefono].
Per vedere tutti i Token presenti in un certo momento in Drupal bisogna installare il modulo aggiuntivo "Token". Dopo la sua attivazione, in Estendi - Token - Help puoi vedere tutti i Token disponibili.
I Token sono raggruppati in una gerarchia, che consente di "scendere" da un Bundle ai suoi Campi. Ad esempio sotto la voce "Nodi" (=Contenuti) trovi i Token corrispondenti ai Campi dei Contenuti (non suddivisi per tipo di Contenuto).
I Token non corrispondenti a Campi sono anch'essi presentati gerarchicamente. Ad esempio, i Token relativa all'utente corrente sono raggruppati sotto "Current user" e quelli relativi alla app sotto "Site".
Come si usano i Token
Vedremo in diverse Guide che i Token si usano 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 i Token in questo punto di MieApp è che servono già a partire dalla prossima Guida.
In generale, i Token sono utilizzati in Campi testuali o comunque in punti in cui Drupal chiede di digitare un testo. Non è necessario conoscere a memoria i Token e neppure tornare ogni volta alla pagina sopra indicata che elenca tutti i Token: nei punti in cui Drupal accetta Token, viene mostrato un comando "Token" che mostra la gerarchia dei Token, oppure viene mostrato un elenco ridotto ai soli Token disponibili in quel punto (ad esempio, nella costruzione delle Viste, i Token disponibili sono mostrati sotto Sfoglia i Token disponibili o Replacement patterns).
Una volta trovato il Token desiderato, occorre copiarlo (selezionandolo e cliccando col pulsante destro il comando "Copia" oppure con la combinazione CTRL C) e incollarlo nella casella testuale dove intendiamo usarlo (comando "Incolla" o CTRL V).
In base al contesto in cui vengono utilizzati, i Token si presentano tra parentesi quadre es: [node:title] oppure tra doppia parentesi graffe es: {{ node.title.value }}. Non è necessario comprendere il motivo di questa differenza, perché Drupal provvede a mostrare i Token nella forma utile al contesto.