=============================================================== 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 into ``var/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 into ``mainconfig.ini.php`` and you want to change. * ``var/config/liveconfig.ini.php`` is containing parameters from ``mainconfig.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: .. code-block:: ini locale = it_IT availableLocales = en_US,fr_FR,it_IT There is also a ``fallbackLocale`` option but it is not recommended to change it. .. _set-password: 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 :file:`localconfig.ini.php` needs to be edited: .. code-block:: bash [jcommunity] resetAdminPasswordEnabled = off