5. Plug-ins
5.1. Lijst met plug-ins
Plug-ins kunnen ook worden geïnstalleerd op QGIS Server.
Sommige voor Server ontworpen plug-ins zijn te vinden in de officiële opslagplaats van QGIS.
Installeer alleen plug-ins die u nodig hebt voor uw eigen doelen. Op QGIS Server zijn plug-ins als haken naar QGIS Server, zijn kunnen alleen in- of uitvoer van QGIS Server wijzigen. Ze kunnen onverwachte resultaten produceren als u niet weet hoe de plug-in werkt. Bekijk hun respectievelijke documentatie of de toepassing die plug-ins voor QGIS Server nodig heeft om te weten te komen welke plug-in voor u nuttig kan zijn.
5.2. Locatie van plug-ins
Op op Debian gebaseerde systemen zal QGIS Server standaard zoeken naar plug-ins die zijn geplaatst in /usr/lib/qgis/plugins. De standaardwaarde wordt in de logs weergegeven als QGIS Server wordt opgestart. Het is mogelijk een aangepast pad in te stellen door de omgevingsvariabele QGIS_PLUGINPATH in de configuratie voor de webserver te definiëren.
5.3. Installeren
5.3.1. Handmatig met een ZIP
Als een voorbeeld, om de plug-in HelloWorld voor het testen van de server, met behulp van een specifieke map, te installeren, dient u eerst een map aan te maken waar de plug-ins voor de server moeten komen te staan. Die zal worden gespecificeerd in de configuratie van de virtuele host en worden doorgegeven aan de server door middel van een omgevingsvariabele:
mkdir -p /var/www/qgis-server/plugins
cd /var/www/qgis-server/plugins
wget https://github.com/elpaso/qgis-helloserver/archive/master.zip
unzip master.zip
mv qgis-helloserver-master HelloServer
Waarschuwing
Gelet op zijn beschrijving, is de plug-in HelloServer ontworpen voor demonstratie- en ontwikkelingsdoeleinden. Behoud deze niet voor productie als u hem niet nodig hebt.
5.3.2. Met een programma voor de opdrachtregel
Wanneer u plug-ins moet installeren en regelmatig moet upgraden die zijn opgeslagen in de QGIS opslagplaats voor plug-ins, zou u de QGIS-Plugin-Manager kunnen gebruiken. Het is een gereedschap om u te helpen plug-ins te beheren vanaf de opdrachtregel.
Installeren gebeurt met pip. Installeren in een virtuele omgeving is een goede manier, maar niet vereist:
pip3 install qgis-plugin-manager
Upgraden van het gereedschap:
pip3 install --upgrade qgis-plugin-manager
Daarna kunt u het uitvoerbare bestand qgis-plugin-manager gebruiken vanaf de opdrachtregel:
cd /var/www/qgis-server/plugins
qgis-plugin-manager list
QGIS server version 3.19.0
List all plugins in /var/www/qgis-server/plugins
------------------------------------------------------------------------------------------------------------------------------------------------------------
| Folder | Name | Version | Experimental | QGIS min | QGIS max | Author | Action ⚠ |
------------------------------------------------------------------------------------------------------------------------------------------------------------
|wfsOutputExtension |wfsOutputExtension |1.6.2 | |3.0 | |3Liz | |
|qgis_server_render_geojson |GeoJson Renderer |v0.4 | |3.4 | |Matthias Kuhn (OPENGIS.ch) | |
|DataPlotly |Data Plotly |3.7.1 | |3.4 |3.98 |Matteo Ghetta (Faunalia) |Upgrade to 3.8.1 |
------------------------------------------------------------------------------------------------------------------------------------------------------------
We raden u aan om de volledige documentatie in het readme-bestand te lezen om te weten te komen hoe u plug-ins installeert of upgradet met dit gereedschap.
5.4. Configureren van de HTTP-server
5.4.1. Apache
FastCGI moet, om in staat te zijn de plug-ins voor de server te kunnen gebruiken, weten waar die te vinden. We moeten dus het configuratiebestand van Apache aanpassen om de omgevingsvariabele QGIS_PLUGINPATH aan te geven voor FastCGI:
FcgidInitialEnv QGIS_PLUGINPATH "/var/www/qgis-server/plugins"
Meer nog, een basisautorisatie voor HTTP is noodzakelijk om met de eerder geïntroduceerde plug-in HelloWorld te kunnen experimenteren. We moeten dus het configuratiebestand voor Apache nog een laatste keer aanpassen:
# Needed for QGIS HelloServer plugin HTTP BASIC auth
<IfModule mod_fcgid.c>
RewriteEngine on
RewriteCond %{HTTP:Authorization} .
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
</IfModule>
Start Apache dan opnieuw:
systemctl restart apache2
5.5. Hoe een plug-in te gebruiken
De server testen met de plug-in HelloWorld:
wget -q -O - "http://localhost/cgi-bin/qgis_mapserv.fcgi?SERVICE=HELLO"
HelloServer!
U kunt eens kijken naar de standaard GetCapabilities van de QGIS server op:
http://localhost/cgi-bin/qgis_mapserv.fcgi?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities