.. _installazione:

**********************
Installazione Software
**********************
La gestione dei *Piani di Gestione Agricolo Forestale della Regione Toscana* si
basa sull'utilizzo del software Open Source `QGIS <https://qgis.org/>`_.

Si richiede l'utilizzo della versione LTR **3.34 Prizren** scaricabile dal 
`sito web <https://qgis.org/it/site/forusers/download.html>`_.

Consigliamo l'installazione della versione *Standalone*:

.. note:: si possono avere versioni diverse di QGIS installate sul proprio sistema
  queste **non** vanno in conflitto fra di loro.

Una volta terminato il download del file, aprirlo e seguire le istruzioni
dell'installer. Al termine dell'installazione QGIS sarà disponibile fra i
programmi installati.


.. _installazione_plugin:

Installazione plugin
====================
È richiesta una semplice installazione dello strumento distribuito come plugin
di QGIS. La seguente modalità di installazione è richiesta solamente la prima volta.
Ai successivi ed eventuali aggiornamenti del plugin, QGIS avvisa l'utente all'avvio
che è possibile aggiornare il plugin.

Sarà sufficiente cliccare sul pulsate di aggiornamento per installare automaticamente
l'ultima versione distribuita del plugin.

Cliccare su :menuselection:`Plugins --> Gestisci ed Installa Plugin...`:

.. image:: img/common/1_installazione.png

Cliccare sulla scheda :menuselection:`Impostazioni` e cliccare sul pulsante ``Aggiungi``: 

.. image:: img/installazione/plugin_repo.png

Nella finestra che si aprirà è necessario riempire i campi:

* ``Nome``: arbitrario, non ha alcun effetto (es ``Plugin PAFRT``)
* ``URL``: obbligatorio, da inserire esattamente questa stringa ``http://plugins.faunalia.eu/faunalia_pafrt.xml``

.. image:: img/installazione/plugin_repo_2.png

Cliccare sulla scheda ``Tutto`` e cercare il plugin con il nome ``pafrt``. Una volta trovato,
cliccare sul pulsante ``Installa``:


.. image:: img/installazione/installazione_plugin.png

.. note:: il plugin è anche già attivo (la casella di controllo è spuntata). Se
  cosi non dovesse essere, spuntare la casella per rendere attivo il plugin.

Il plugin comparirà fra gli algoritmi di :menuselection:`Processing`, lo 
strumento principale di QGIS per le analisi.

:menuselection:`Processing` è un plugin nativo di QGIS e compare in automatico
nella barra degli strumenti:

.. image:: img/common/processing_menu.png

Cliccare su :menuselection:`Processing --> Strumenti` per aprire il panello degli
strumenti: 

.. image:: img/common/processing_menu_strumenti.png

Si vedrà che il plugin è presente come singolo provider:

.. image:: img/installazione/plugin_processing.png