Git Product home page Git Product logo

qgis2web's Introduction

GitHub version Donate

qgis2web

    qgis2web

QGIS plugin to export your project to an OpenLayers or Leaflet webmap.
It replicates as many aspects of the project as it can, including layers, extent and styles (including categorized and graduated).
No server-side software required.

Installation

  • In QGIS, select Plugins > Manage and Install Plugins...

or:

  • Download and unzip this repo to your QGIS plugins directory

Usage

Prepare your map as far as possible in QGIS, as you want it to appear in your webmap. Specific tasks you can carry out to improve your webmap include:

  • Set your project title, and background and highlight colours in Project > Project Properties...
  • Give your layers human-friendly names in the Layers Panel
  • Give your layer columns human friendly names via Layer > Properties > Fields > Alias
  • Hide the columns you don't want to appear in your popups by changing their Edit widget to "Hidden"
  • If any of your fields contain image filenames, change their Edit widget to "Photo" to have the images appear in popups
  • Style your layers, and set their scale-dependent visibility, if required

Run qgis2web from the Web menu, or via its icon. If required, choose a basemap from the list below the preview pane, and click "Update preview". CTRL/CMD-click for multiple basemaps or to deselect a basemap.

The top-left pane lets you set options for each layer in your map. The bottom-left pane sets overall options for your project. All options are written to your QGIS project, so save your project if you want to keep these settings.

More info on the WIKI

Awards

qgis2web is among the winners of the OSGeo:UK 2023 competition via GoFundGeo os geo uk

Donations

We are thrilled to see how widely our project is being used and appreciated around the world. The development and maintenance require significant time and effort, and we want to continue improving and adding new features.

Please consider a small donation; even a modest "virtual coffee" can help support our commitment to providing quality software.


🎁 As a token of our gratitude, donors will receive as a gift qgis2opengis (a plugin enhancing OpenLayers export of qgis2web).🎁

Thank you for your support!
Happy mapping!🗺️

Current limitations

QGIS, OpenLayers, and Leaflet are all different mapping technologies. This means that their respective functionality differs in many ways. qgis2web does its best to interpret a QGIS project and to export HTML, Javascript, and CSS to create a web map as close to the QGIS project as possible.

However, many elements of a QGIS project cannot be reproduced, and many are only possible in either OpenLayers or Leaflet. qgis2web tries its best to produce a publish-ready map, but you can always manually edit the output code to achieve what qgis2web cannot.

  • in OL3 maps, only single rendered points cluster, not categorized or graduated
  • line style (dashed/dotted) does not appear in OL3 preview, but works in export
  • only a single 2.5d layer will render per map
  • 2.5d layers only appear when zoomed in to building scales
  • attribute filters and abstract export only works in leaflet based webmaps

Reporting bugs

Please report any problems you have with qgis2web. Without this feedback, I am often completely unaware that a problem exists. To ensure no time or effort is wasted in bug reporting, please follow these steps:

  1. Make sure you are using the latest release of qgis2web
  2. Check the issues on Github to see whether the bug has already been reported, and if so, read through all the comments on the issue, and add any additional information from your experience of the bug
  3. Make sure you can reproduce the bug reliably
  4. Reduce the complexity of your bug conditions as far as you can, especially by reducing the number of layers, ideally to one
  5. Raise a Github issue, including:
    • only one bug per Github issue
    • the qgis2web version (or make it clear you are using Github master branch)
    • any Python error text/stack trace which occurs
    • browser JS console errors - press F12 in qgis2web to open the developer toolbar and find the console
    • screenshot of your settings
    • screenshot of the output
    • a link to the data you used, if possible

The stability of qgis2web relies on your bug reports, so please keep them coming.

Credits

qgis2web is fundamentally a merge of Victor Olaya's qgis-ol3 and Riccardo Klinger's qgis2leaf. It would not exist without their work. Thank you, gentlemen. Thanks are also very much due to Paolo Cavallini, who suggested and supported the merge.

  • @volaya
  • @riccardoklinger
  • @pcav

Obviously, qgis2web could not exist without the following monumental software:

  • QGIS
  • OpenLayers
  • Leaflet

Thanks are also due for major code contributions to:

  • @akbargumbira
  • @lucacasagrande
  • @walkermatt
  • @boesiii
  • @ThomasG77
  • @NathanW2
  • @nyalldawson (FTP export for Faunalia/ENEL)
  • @perliedman
  • @olakov

In addition, the following libraries have been used:

  • ol3-layerswitcher, by @walkermatt
  • Autolinker.js, by @gregjacobs
  • requestAnimationFrame polyfill, by @paulirish
  • Function.prototype.bind polyfill, by @mozilla
  • Leaflet.label, by @jacobtoye
  • Leaflet.Locate, by @domoritz
  • Leaflet.markercluster, by @danzel
  • leaflet-measure, by @ljagis
  • leaflet-hash, by @mlevans
  • Proj4js, by @madair, @calvinmetcalf, and other
  • Proj4Leaflet, by @kartena
  • Leaflet.search, by @stefanocudini
  • ol3-search-layer, by @ThomasG77
  • Leaflet.heat, by @mourner
  • OSMBuildings, by @kekscom
  • multi-style-layer, by @perliedman
  • Leaflet.SvgShapeMarkers, by @rowanwins
  • rbush, by @mourner
  • Labelgun, by @JamesMilnerUK
  • Leaflet.pattern, by @teastman
  • Leaflet.VectorGrid, by @IvanSanchez

qgis2web's People

Contributors

tomchadwin avatar riccardoklinger avatar nyalldawson avatar olakov avatar paulds8 avatar andreaordonselli avatar lucacasagrande avatar boesiii avatar walkermatt avatar akbargumbira avatar garprogram avatar jnicho02 avatar m-kuhn avatar todointx avatar geospark avatar shivareddyiirs avatar slarosa avatar kgjenkins avatar jaminmelville avatar agiudiceandrea avatar ahocevar avatar saerdnaer avatar kannes avatar jef-n avatar mbernasocchi avatar tfh-galbraith avatar tomasholderness avatar cukavac avatar greenkeeper[bot] avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.