Etichette

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.

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.