{"elements":[{"id":7007,"title":"Template Engine","body":"
\n
\n

Sintassi Template<\/h2>\n

Il template engine di DressAPI permette di costruire interfacce HTML dinamiche attraverso una sintassi intuitiva, integrata nei file .tmpl.php<\/code>. Gestito dalla classe CHtmlRender<\/code>, supporta placeholder, cicli, condizioni, componenti riutilizzabili e traduzione automatica del testo.<\/p>\n\n

Variabili<\/h3>\n
\n \n \n \n
Sintassi<\/th>Funzione<\/th><\/tr>\n <\/thead>\n
{{ variabile }}<\/code><\/td>Sostituzione variabile (escaped)<\/td><\/tr>\n
{{ locals::variabile }}<\/code><\/td>Variabile locale del template<\/td><\/tr>\n
{{ 'testo traducibile' }}<\/code><\/td>Testo con traduzione automatica via _T()<\/code><\/td><\/tr>\n <\/tbody>\n <\/table>\n <\/div>\n\n

Accesso ai dati annidati<\/h3>\n

Usa ::<\/code> come separatore per accedere a dati annidati e indici di array:<\/p>\n

\n
Template<\/div>\n{{ user::name }}\n{{ user::details::email }}\n{{ products::0::name }}<\/code>\n <\/div>\n\n

Condizioni<\/h3>\n
\n
Template Syntax<\/div>\n[if(user::logged_in)]\n <p>Benvenuto, {{ user::name }}!<\/p>\n[else]\n <p>Effettua il login.<\/p>\n[\/if]<\/code>\n <\/div>\n

Operatori supportati: ==<\/code>, !=<\/code>, ><\/code>, <<\/code>, >=<\/code>, <=<\/code>, &&<\/code> \/ and<\/code>, ||<\/code> \/ or<\/code>, !<\/code> \/ not<\/code><\/p>\n\n

Blocchi condizionali: if-exists \/ if-not-exists<\/h3>\n

Verifica se una variabile esiste e non è vuota:<\/p>\n

\n
Template Syntax<\/div>\n[if-exists(user::avatar)]\n <img src=\"{{ user::avatar | raw }}\" alt=\"Avatar\">\n[\/if-exists]\n\n[if-not-exists(user::bio)]\n <p>Nessuna biografia disponibile.<\/p>\n[\/if-not-exists]\n\n[if-exists(product::discount)]\n <span class=\"badge\">Sconto {{ product::discount }}%<\/span>\n[else]\n <span class=\"badge\">Prezzo pieno<\/span>\n[\/if-exists]<\/code>\n <\/div>\n\n

Cicli (foreach)<\/h3>\n
\n
Template Syntax<\/div>\n[foreach from=\"products\" item=\"product\"]\n <div class=\"product\">\n <h3>{{ product::name }}<\/h3>\n <p>{{ product::price | number_format:'€%.2f' }}<\/p>\n <\/div>\n[\/foreach]<\/code>\n <\/div>\n

Foreach con chiave<\/h4>\n
\n
Template Syntax<\/div>\n[foreach from=\"settings\" item=\"value\" key=\"setting_name\"]\n <div>{{ setting_name }}: {{ value }}<\/div>\n[\/foreach]<\/code>\n <\/div>\n

Variabili del loop<\/h4>\n
\n \n \n \n
Variabile<\/th>Descrizione<\/th><\/tr>\n <\/thead>\n
loop::index<\/code><\/td>Indice corrente (0-based)<\/td><\/tr>\n
loop::index1<\/code><\/td>Indice corrente (1-based)<\/td><\/tr>\n
loop::is_first<\/code><\/td>true<\/code> se è il primo elemento<\/td><\/tr>\n
loop::is_last<\/code><\/td>true<\/code> se è l'ultimo elemento<\/td><\/tr>\n
loop::total<\/code><\/td>Numero totale di elementi<\/td><\/tr>\n
loop::odd<\/code><\/td>true<\/code> se l'indice (1-based) è dispari<\/td><\/tr>\n
loop::even<\/code><\/td>true<\/code> se l'indice (1-based) è pari<\/td><\/tr>\n <\/tbody>\n <\/table>\n <\/div>\n\n

Modificatori<\/h3>\n

I modificatori trasformano i valori usando la sintassi pipe (|<\/code>). Si possono concatenare: {{ var | mod1 | mod2 }}<\/code><\/p>\n

\n \n \n \n
Modificatore<\/th>Esempio<\/th>Risultato<\/th><\/tr>\n <\/thead>\n
upper<\/td>{{ nome | upper }}<\/code><\/td>MAIUSCOLO<\/td><\/tr>\n
lower<\/td>{{ nome | lower }}<\/code><\/td>minuscolo<\/td><\/tr>\n
capitalize<\/td>{{ nome | capitalize }}<\/code><\/td>Prima Lettera Maiuscola<\/td><\/tr>\n
raw<\/td>{{ html | raw }}<\/code><\/td>Disabilita traduzione ed escaping<\/td><\/tr>\n
nt<\/td>{{ testo | nt }}<\/code><\/td>Disabilita solo traduzione (No Translation)<\/td><\/tr>\n
t<\/td>{{ id | t }}<\/code><\/td>Forza traduzione<\/td><\/tr>\n
escape<\/td>{{ testo | escape }}<\/code><\/td>Forza escaping HTML<\/td><\/tr>\n
date<\/td>{{ data | date:'d\/m\/Y' }}<\/code><\/td>Formattazione data<\/td><\/tr>\n
id_safe<\/td>{{ 'Menu Item' | id_safe }}<\/code><\/td>Menu_Item (ID-safe)<\/td><\/tr>\n
count<\/td>{{ items | count }}<\/code><\/td>Conta elementi array<\/td><\/tr>\n
keys<\/td>{{ obj | keys }}<\/code><\/td>Chiavi array (a, b, c)<\/td><\/tr>\n
add<\/td>{{ prezzo | add:10 }}<\/code><\/td>Somma un numero<\/td><\/tr>\n
sub<\/td>{{ prezzo | sub:10 }}<\/code><\/td>Sottrae un numero<\/td><\/tr>\n
multiply<\/td>{{ prezzo | multiply:1.22 }}<\/code><\/td>Moltiplica per un numero<\/td><\/tr>\n
divide<\/td>{{ totale | divide:2 }}<\/code><\/td>Divide per un numero<\/td><\/tr>\n
number_format<\/td>{{ prezzo | number_format:'%.2f' }}<\/code><\/td>Formattazione numerica<\/td><\/tr>\n
debug<\/td>{{ dati | debug }}<\/code><\/td>Output di debug (print_r)<\/td><\/tr>\n <\/tbody>\n <\/table>\n <\/div>\n

Esempio pratico con modificatori concatenati<\/h4>\n
\n
Template<\/div>\n<p>Prezzo IVA inclusa: {{ product::price | multiply:1.22 | number_format:'€%.2f' }}<\/p>\n<div id=\"section-{{ section::title | id_safe }}\">...<\/div><\/code>\n <\/div>\n\n

Valori di default con ??<\/code><\/h3>\n

Usa ??<\/code> per specificare un valore di default quando la variabile è vuota o non esiste:<\/p>\n

\n
Template<\/div>\n{{ page::title ?? 'Pagina senza titolo' }}\n{{ user::avatar ?? '\/images\/default-avatar.png' }}<\/code>\n <\/div>\n\n

Operatore ternario<\/h3>\n

Scegli tra due valori in base a una condizione:<\/p>\n

\n
Template<\/div>\n<div class=\"item{{ active ? ' active' : '' }}\">\n<span>{{ logged_in ? 'Benvenuto!' : 'Accedi' }}<\/span>\n<span class=\"{{ status == 'active' ? 'text-success' : 'text-muted' }}\"><\/code>\n <\/div>\n

Funziona anche nei cicli con variabili di loop: {{ loop::first ? ' first' : '' }}<\/code><\/p>\n\n

Cardinalità<\/h3>\n

Mostra contenuto diverso in base al numero di elementi in un array:<\/p>\n

\n
Template Syntax<\/div>\n[empty from=\"results\"]\n <p>Nessun risultato trovato.<\/p>\n[\/empty]\n\n[single from=\"results\"]\n <p>Trovato un risultato:<\/p>\n <div>{{ results::0::title }}<\/div>\n[\/single]\n\n[multiple from=\"results\"]\n <p>Trovati {{ results | count }} risultati:<\/p>\n [foreach from=\"results\" item=\"result\"]\n <li>{{ result::title }}<\/li>\n [\/foreach]\n[\/multiple]<\/code>\n <\/div>\n\n

Switch<\/h3>\n

Gestisci più condizioni in modo pulito:<\/p>\n

\n
Template Syntax<\/div>\n[switch]\n [case condition=\"order::status == 'pending'\"]\n <span class=\"badge yellow\">In attesa<\/span>\n [\/case]\n [case condition=\"order::status == 'shipped'\"]\n <span class=\"badge green\">Spedito<\/span>\n [\/case]\n [default]\n <span class=\"badge gray\">Sconosciuto<\/span>\n [\/default]\n[\/switch]<\/code>\n <\/div>\n\n

Include<\/h3>\n

Includi altri file template:<\/p>\n

\n
Template Syntax<\/div>\n[include file=\"header.html\"]\n[include file=\"components\/card.html\" module=\"products\"]<\/code>\n <\/div>\n

Richiede la configurazione di un include_resolver<\/code> tramite SetIncludeResolver()<\/code>.<\/p>\n\n

Permessi<\/h3>\n

Mostra contenuto solo se l'utente ha il permesso specificato:<\/p>\n

\n
Template Syntax<\/div>\n[permission can_edit]\n <button class=\"btn-edit\">Modifica<\/button>\n[\/permission]\n\n[permission can_delete]\n <button class=\"btn-delete\">Elimina<\/button>\n[\/permission]<\/code>\n <\/div>\n\n

Attributi condizionali<\/h3>\n

Aggiungi classi CSS o attributi HTML condizionalmente:<\/p>\n

\n \n \n \n
Attributo<\/th>Sintassi<\/th>Descrizione<\/th><\/tr>\n <\/thead>\n
data-dressapi-class-if<\/code><\/td>condizione:classe<\/code><\/td>Aggiunge una classe CSS se la condizione è vera<\/td><\/tr>\n
data-dressapi-attr-if<\/code><\/td>condizione:attributo:valore<\/code><\/td>Aggiunge un attributo HTML se la condizione è vera<\/td><\/tr>\n <\/tbody>\n <\/table>\n <\/div>\n
\n
Template<\/div>\n<div data-dressapi-class-if=\"product::featured:featured\">{{ product::name }}<\/div>\n<a data-dressapi-attr-if=\"item::external:target:_blank\">Link<\/a><\/code>\n <\/div>\n\n

Processori Pre\/Post<\/h3>\n

Ogni modulo può definire processori eseguiti prima e dopo il rendering:<\/p>\n