Custom templates¶
In Lizmap each module (i.e., view, admin, action, etc.) defines some templates. Templates of each module are located in
lizmap/modules
folder. Each module has one or more templates (.tpl) in the templates folder
lizmap/modules/moduleX/templates/
. In order to customize the template of a module it is advisable to create a
copy of the files without modify the original files. To do this, it is necessary to create a copy of the templates
inside the default theme’s folder of Lizmap, which is in var/themes/default
.
Pré-requis¶
- A folder with the same name of the module to which the template to redefine belongs, in the
var/themes/default
folder.
Configurer l’outil¶
Simply copy the template to redefine in the module folder and customize it with a text editor.
Exemple¶
We want to change the default title in the header of the main page of lizmap. The « view » module and the main.tpl
template are involved in this procedure. We can see the name of the module in the URL bar (myhost/lizmap/index.php/view/
).
- Create a directory named view in the theme’s default folder
nano mkdir lizmap/var/themes/default/view
- Copy the
main.tpl
file from the default location inlizmap/modules/view/templates/
to thelizmap/var/themes/default/view
folder
cp lizmap/var/themes/default/view/main.tpl lizmap/var/themes/default/view
- Find the title div and replace the original code with your custom text
<div id="title">
<h1>{$repositoryLabel}</h1>
</div>
<div id="title">
<h1>Some Text</h1>
</div>
Done!