Etichette
Panoramica
Le etichette sono stringhe che è possibile inserire all'interno del tema, sono configurabili dall'utente per ogni lingua dalla voce Etichette del pannello. Sono suddivvise in gruppi: CMS, componenti aggiuntivi o plugin, etichette del tema. Queste ultime possono essere create dal designer in theme.php. Tutte le etichette possono essere inserite in qualsiasi pagina del tema.
Implementazione
Creare un'etichetta del tema
Ogni tema può avere le sue etichette, per creare un nuovo campo etichetta nel pannello è necessario definirla nell'oggetto labels
di theme.php in questo modo:
'labels' => [ 'NOME_ETICHETTA' => ['field' => 'text', 'label' => 'theme::common.labels.NOME_ETICHETTA.label', 'descr' => 'theme::common.labels.NOME_ETICHETTA.descr'], ],
In questo oggetto field
definisce il tipo di campo: può essere di tipo text
per un normale campo input o textarea
per permettere l'inserimento del testo su più righe.
I campi 'label' e 'descr' corrispondono rispettivamente al nome e alla descrizione che verranno mostrati nel pannello vicino al campo dell'etichetta, in modo da descriverla. I valori di questi due campi vanno definiti nei file common.php di ogni lingua.
Anche in common.php andremo quindi a modificare l'oggetto labels
inserendo, nella lingua corretta, il nome e la descrizione dell'etichetta che compariranno nel pannello, in questo modo:
'labels' => [ 'NOME_ETICHETTA' => ['label' => 'NOME ETICHETTA NEL PANNELLO', 'descr' => 'DESCRIZIONE ETICHETTA NEL PANNELLO'], ],
Le etichette create in questo modo verranno visualizzate nella tab del tema all'interno della voce Etichette, e possono essere estratte in front-end.
Inserimento di un'etichetta nel tema
Ogni etichetta può essere inserita in qualsiasi file della cartella views del tema, ad eccezione di settings.html, utilizzando la funzione find_label()
in questo modo:
{{ lang_get('GRUPPO', 'NOME', '') }}
i parametri della funzione sono, nell'ordine:
nome | tipo | descrizione |
---|---|---|
group | string | Nome del gruppo (es. "cms" o "theme") |
name | string | Nome dell'etichetta |
default | string |
La funzione ritornerà come valore la stringa inserita nel pannello, nella lingua attualmente attiva. Nel pannello nella sezione delle etichette è disponibile il pulsante Tags che permette di mostrare la funzione per richiamare ciascuna etichetta.
Voci correlate
- admin.php (Le etichette qui descritte non sono da confondersi con le etichette da usare in settings.html che vanno configurate invece in admin.php)