5. Plugin

5.1. Elenco dei plugin 

I plugin possono essere installati anche su QGIS Server.

Alcuni plugin progettati per il server si trovano nel repository ufficiale di QGIS.

Installa solo i plugin necessari per i tuoi scopi. Sul server QGIS, i plugin sono come dei collegamenti nel server QGIS e possono alterare gli input o gli output del server QGIS. Possono produrre risultati inaspettati se conosci il funzionamento del plugin. Per sapere quale plugin ti può essere utile, consulta la rispettiva documentazione o l’applicazione che necessita dei plugin del server QGIS.

5.2. Ubicazione dei plugin 

Per impostazione predefinita, sui sistemi basati su Debian, QGIS Server cercherà i plugin situati in /usr/lib/qgis/plugins. Il valore predefinito viene visualizzato all’avvio di QGIS Server, nei log. È possibile impostare un percorso personalizzato definendo la variabile d’ambiente QGIS_PLUGINPATH nella configurazione del server web.

5.3. Installazione 

5.3.1. Manualmente con uno ZIP 

Ad esempio, per installare il plugin HelloWorld per testare il server, utilizzando una cartella specifica, devi prima creare una cartella per contenere i plugin del server. Questa sarà specificata nella configurazione dell’host virtuale e passata al server attraverso una variabile d’ambiente:

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

Avvertimento

Conformemente alla sua descrizione, il plugin HelloServer è stato progettato per scopi di sviluppo e dimostrativi. Non utilizzare questo plugin per la produzione se non ne hai bisogno.

5.3.2. Con uno strumento a linea di comando 

Se hai bisogno di installare e aggiornare regolarmente i plugin che sono memorizzati nel repository dei plugin di QGIS, puoi usare il QGIS-Plugin-Manager. È uno strumento che aiuta a gestire i plugin dalla linea di comando.

L’installazione avviene tramite pip. L’installazione in un ambiente virtuale è una buona pratica, ma non è obbligatoria:

pip3 install qgis-plugin-manager

Per aggiornare lo strumento:

pip3 install --upgrade qgis-plugin-manager

Quindi, puoi utilizzare l’eseguibile qgis-plugin-manager dalla linea di comando:

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    |
------------------------------------------------------------------------------------------------------------------------------------------------------------

Si consiglia di leggere la documentazione completa nel file readme per sapere come installare o aggiornare i plugin con questo strumento.

5.4. Configura il server HTTP 

5.4.1. Apache 

Per poter utilizzare i plugin del server, FastCGI deve sapere dove cercare. Quindi, dobbiamo modificare il file di configurazione di Apache per indicare a FastCGI la variabile d’ambiente QGIS_PLUGINPATH:

FcgidInitialEnv QGIS_PLUGINPATH "/var/www/qgis-server/plugins"

Inoltre, un’autorizzazione HTTP di base è necessaria per lavorare con il plugin HelloWorld precedentemente introdotto. Quindi dobbiamo aggiornare il file di configurazione di Apache un’ultima volta:

# Needed for QGIS HelloServer plugin HTTP BASIC auth
<IfModule mod_fcgid.c>
    RewriteEngine on
    RewriteCond %{HTTP:Authorization} .
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
</IfModule>

Poi, riavvia Apache:

systemctl restart apache2

5.5. Come usare un plugin 

Fai il test il server con il plugin HelloWorld:

wget -q -O - "http://localhost/cgi-bin/qgis_mapserv.fcgi?SERVICE=HELLO"
 HelloServer!

Puoi dare un’occhiata al GetCapabilities di default del server QGIS su:

http://localhost/cgi-bin/qgis_mapserv.fcgi?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities