Modelli personalizzati

In Lizmap ogni modulo (cioè, vista, admin, azione, ecc.) definisce alcuni modelli. I template di ogni modulo si trovano nella cartella lizmap/modules. Ogni modulo ha uno o più template (.tpl) nella cartella template lizmap/modules/moduleX/templates/. Per personalizzare il template di un modulo è consigliabile creare una copia dei file senza modificare i file originali. Per fare questo, è necessario creare una copia dei template all’interno della cartella predefinita del tema di Lizmap, che si trova in var/themes/default.

Prerequisiti

  • Una cartella con lo stesso nome del modulo a cui appartiene il modello da ridefinire, nella cartella var/themes/default.

Configurazione del plugin

Basta copiare il modello da ridefinire nella cartella dei moduli e personalizzarlo con un editor di testo.

Esempio

Vogliamo cambiare il titolo predefinito nell’intestazione della pagina principale di lizmap. Il modulo «view» e il template main.tpl sono coinvolti in questa procedura. Possiamo vedere il nome del modulo nella barra dell’URL (myhost/lizmap/index.php/view/).

  • Creare una directory named view nella cartella predefinita del tema

nano mkdir lizmap/var/themes/default/view

  • Copiare il file main.tpl dalla posizione predefinita in lizmap/modules/view/templates/ alla cartella :file:`lizmap/var/themes/default/view

cp lizmap/var/themes/default/view/main.tpl lizmap/var/themes/default/view

  • Trova il div del titolo e sostituisci il codice originale con il tuo testo personalizzato

<div id="title">
  <h1>{$repositoryLabel}</h1>
</div>

<div id="title">
  <h1>Some Text</h1>
</div>

Fatto!