Configuration of Lizmap
In some server, additional settings should be done into Lizmap.
Settings should be set into the lizmap/var/config/
directory.
Configuration files
There are several configuration files for Lizmap.
Framework configuration files:
app/system/mainconfig.ini.php
contains many configuration parameters, with their default values, mainly for the framework used by Lizmap. You would want to modify some of them, like the available languages etc. However, you must NOT MODIFY mainconfig.ini.php and any other files from app/. Set parameters with their new values intovar/config/localconfig.ini.php
instead!var/config/localconfig.ini.php
contains configuration parameters that are specific to your installation. So you put into it any parameters you can find intomainconfig.ini.php
and you want to change.var/config/liveconfig.ini.php
is containing parameters frommainconfig.ini.php
that are changed by the application itself.
During the execution of Lizmap, mainconfig.ini.php
, localconfig.ini.php
,
and liveconfig.ini.php
are merged in this order. So parameters into liveconfig.ini.php
have higher priority that those into localconfig.ini.php
, which in turn,
have parameters having higher priority over parameters of mainconfig.ini.php
.
Other framework configuration files:
profiles.ini.php
contains all credentials to access to databases, smtp servers, ldap etc. You should modify it to set these access parameters.installer.ini.php
contains informations about Lizmap modules and their state. Don’t touch it, and don’t erase it between upgrades. You can delete it only if you want to reinstall Lizmap.
Lizmap configuration files:
lizmapConfig.ini.php
contains configuration parameters specific to Lizmap.lizmapLogConfig.ini.php
contains configuration for the Lizmap logger
For backups and upgrades, you should keep localconfig.ini.php
, liveconfig.ini.php
,
lizmapConfig.ini.php
, profiles.ini.php
, lizmapLogConfig.ini.php
and installer.ini.php
.
They are all modified during the life or the installation of the application.
Setting language
Lizmap detects automatically the language of the user (given by his browser), and it supports many languages.
Available languages into Lizmap are shown on the GitHub repository. Be careful to select the correct branch on GitHub according to the version of Lizmap Web Client you are installing. Some languages might not be available in older versions of Lizmap Web Client, for instance on the 3.6 branch.
If the browser of the user indicates an unsupported language code, the default language of Lizmap is used, and is en_US.
You can change the default language of Lizmap by setting the parameter locale
Into localconfig.ini.php, with your preferred language code.
You can also limit available language by changing the availableLocales
option.
In this example, only 3 languages are available and the default language is italian:
locale = it_IT
availableLocales = en_US,fr_FR,it_IT
There is also a fallbackLocale
option but it is not recommended to change it.
Setting password for users
By default, in Lizmap, when a new user is created, the user will get an email for setting up his own password.
If for some reasons, the administrator needs to setup the password, the localconfig.ini.php
needs to be edited:
[jcommunity]
resetAdminPasswordEnabled = off