# Universal Map2web

Version: 1.2.0 | QGIS: 3.16+

QGIS plugin to export vector layers as interactive HTML maps with QGIS symbology preservation.

## Features

- Multi-layer export with QGIS styles (colors, widths, opacities)
- Labeling preservation and automatic legend
- Basemaps: OSM, Google Satellite, Hybrid or custom
- Tools: geolocation, measure, search, fullscreen, minimap, print
- Advanced attribute filtering (8 operators)
- 4 visual themes: Light, Dark, Professional, Colorful
- Point clustering
- Per-layer popup configuration
- Dynamic PostgreSQL/PostGIS mode (live data instead of a static export)

## Quick guide

### 1. Launch

Click on the Universal Map2web icon in the QGIS toolbar.

### 2. Export

1. Select the layers to export (Layers tab)
2. Configure popups (fields to display on click)
3. Optionally enable dynamic PostgreSQL/PostGIS mode for layers connected to a database
4. Choose basemap and theme
5. Customize: title, logo, header color
6. Enable desired tools
7. Click "OK" and choose the destination folder
8. The map opens automatically in your browser

### 3. Web navigation

Action | Command
--- | ---
Zoom | Scroll / + / -
Pan | Click-drag
View attributes | Click on feature
Reset view | Double-click on map

### 4. Advanced filtering

In the map sidebar: select layer → field → operator → enter value → Apply.

Available operators: = ≠ contains starts with > < ≥ ≤

### 5. Layer management on map

- Show/Hide: check/uncheck in the legend
- Clustering: enable "Cluster points" (point layers)
- Legend: automatic display of categories and colors

### 6. Dynamic PostgreSQL mode

For layers already connected to PostgreSQL/PostGIS in QGIS, enable "Load PostGIS layers dynamically from PostgreSQL (instead of a static export)" in the dialog.

- The existing QGIS connection is reused: no credentials are re-entered in the plugin
- A protected get_data.php endpoint and db_config.php are generated in the export folder, secured by a random API key and an .htaccess rule
- The web map queries the database live (with bounding-box filtering) instead of using a fixed GeoJSON snapshot
- Layers left unchecked, or not connected to PostgreSQL, are exported as static GeoJSON as usual

Requires a PHP-capable web server with the pdo_pgsql extension to host the exported site — a plain static file host is not enough for this mode.

## Requirements

Component | Requirement
--- | ---
QGIS | 3.16 or higher
Browser | Chrome 90+, Firefox 88+, Edge 90+
Memory | 4 GB RAM minimum
Internet | Required for basemaps and libraries

## Best practices

- Limit to 10 active layers for optimal performance
- Recommended files < 50 MB per layer
- Use WGS84 (EPSG:4326) for your data
- Preview in QGIS before export

## Technical support

Jean-Baptiste KIBORA

📧 Email: jeanbaptiste.kibora@tic.gov.bf

📱 Phone: +226 64 41 25 14

Universal Map2web v1.2.0 | © kibora B. Jean-Baptiste | July 2026