OdooWiki OCA HUB

Leaflet Javascript Library

web_leaflet_lib folder_open OCA/geospatial open_in_new
Extra Tools License: AGPL-3

This module extends odoo to include Leaflet Javacript library.

This module is used by web_view_leaflet_map.

Important Note

The javascript library is opensource and distributed under BSD 2 Licence. See : . The plugin library is opensource and distributed under MIT Licence. See : .

You can so use it freely.

However, display maps requires to display layers provided by tiles servers, that requires ressources.

For testing purpose

You can use the openStreetMap url https://tile.openstreetmap.org/{z}/{x}/{y}.png or other, listed in that page :

Apart from very limited testing purposes, you should not use the tiles supplied by OpenStreetMap.org itself. OpenStreetMap is a volunteer-run non-profit body and cannot supply tiles for large-scale commercial use.

Regular / High Usage

  • you can contact one of the following companies :
  • You can also install yourself your own tiles servers. See documentation :

Library Update

For the time being, the module embed the lealflet.js library version 1.9.4 ( released on May 18, 2023.)

If a new release is out:

  • please download it here
  • update the javascript, css and images, present in the folder static/lib/leaflet
  • update the plugins
  • test the features
  • make a Pull Request

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Adds the Leaflet map JavaScript library to Odoo's backend, so other modules can display interactive maps. It also stores the map tile server address and copyright text as system settings.

This module does not add any screen or menu of its own. It is a technical building block: it loads the Leaflet map library (and a marker-clustering add-on) into the Odoo backend, so that other modules — such as the map view module mentioned in the description — can show interactive maps inside Odoo.

What it does provide is configuration. Two system parameters are created when the module is installed:

  • leaflet.tile_url: the address of the map tile server used to draw the map background. It is empty by default.
  • leaflet.copyright: the copyright text shown on the map, pre-filled with an OpenStreetMap credit.

These two values are sent to the browser as part of the session information, so any map displayed in Odoo can use them without extra configuration. The ir.http model is extended for this purpose.

A small automatic behaviour runs at installation: if the database is in demonstration mode, the tile address is filled in with the public OpenStreetMap tile server, so maps work out of the box for testing. In a real (non-demo) database the address stays empty and must be set by the administrator.

In short, users will not see a new menu, but administrators can set the map background source and the credit line, and any map-enabled screen will use those values.

Depends on

base

Required by other modules

geospatial_plotweb_leaflet_draw_libweb_view_leaflet_map
Models and fields (1)
  • ir.http · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 4 confirmed, 5 with no information of 9 versions.

Sources · Odoo 17.0

Confirmed on 2026-11-03 in branch 17.0 of OCA/geospatial.

terminal Installation and usage

OCA documentation · Odoo 19.0

Configuration

Source · Odoo 19.0
  • Go to Settings \> Technical \> Parameters \> System Parameters
  • Create or edit the parameter with the key leaflet.tile_url
  • As a value, set the url of the tiles server you chose. (See description)

No verified information in OCA: Installation, Usage.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.