# Installazione

OpenSTAManager presenta una struttura modulare appositamente pensata per prevedere l'installazione di moduli aggiuntivi e la personalizzazione di quelli esistenti.

### 📙 Formato del pacchetto

Al momento il gestionale supporta l'installazione diretta di due componenti tramite la [procedura semplificata](#procedura-semplificata) del modulo **Aggiornamenti**: moduli e plugin. Questi componenti possono essere installati e aggiornati in gruppo o singolarmente tramite un apposito archivio ZIP, che segue una struttura di base ben definita.

Ogni componente deve essere presente in una cartella separata, che deve contenere il relativo file `MODULE` oppure `PLUGIN` per permettere a OpenSTAManager di identificarlo.

```
componente.zip
├── modulo_test
|   ├── ... - File contententi il codice del modulo
|   └── MODULE
├── plugin_test
|   ├── ... - File contententi il codice del plugin
|   └── PLUGIN
└── README
```

I contenuti del file `MODULE` devono essere i seguenti:

```
name = "Nome del modulo"
version = "Versione"
directory = "Cartella di installazione"
options = "Operazione da eseguire all'apertura"
compatibility = "Versioni di compatibilità"
compatibility = "Compatibilità del modulo"
parent = "Genitore del modulo"
```

I contenuti del file `PLUGIN` devono essere i seguenti:

```
name = "Nome del plugin"
version = "Versione"
directory = "Cartella di installazione"
options = "Operazione da eseguire all'apertura"
icon = "Icona (Font-Awesome)"
compatibility = "Versioni di compatibilità"
module_from = "Nome del modulo di origine"
module_to = "Nome del modulo di destinazione e visualizzazione"
position = "Tipo di modulo (valori disponibili: tab)"
```

Alcuni esempi sulla struttura dei moduli personalizzati sono disponibili nella repository <https://github.com/devcode-it/example>.

### 📙 Procedura semplificata

Una volta acquistato un modulo aggiuntivo e scaricato l'archivio ZIP contenente i componenti da installare o aggiornare, si può procedere con i seguenti passaggi per caricare il file nel gestionale:

* Cliccare sul modulo **Strumenti** e aprire **Aggiornamenti**

![](https://2166018961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYDclG5L1dBFKqS7vqZat%2Fuploads%2FwcmUtYRAOKvOlawqLgTI%2FPassaggio1\(1\).png?alt=media)

* Cliccare sul tasto ![](https://2166018961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYDclG5L1dBFKqS7vqZat%2Fuploads%2FLgoYvIAoTPmzndvCse5G%2FSfoglia.png?alt=media) e selezionare il file `.zip` ricevuto precedentemente.

![](https://2166018961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYDclG5L1dBFKqS7vqZat%2Fuploads%2FeW8j4fObaypPeUMtmkj9%2FPassaggio2\(2\).png?alt=media)

* Cliccare sul tasto ![](https://2166018961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYDclG5L1dBFKqS7vqZat%2Fuploads%2FtvdBFWmHGgYw5psj5m0l%2FCarica.PNG?alt=media) per andare a caricare il modulo in OpenSTAManager.

![](https://2166018961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYDclG5L1dBFKqS7vqZat%2Fuploads%2Fuq6lKHK7fZw9YC6J5Kmv%2FPassaggio3.png?alt=media)

* Confermare la procedura cliccando su **SI**.

![](https://2166018961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYDclG5L1dBFKqS7vqZat%2Fuploads%2FSiPuX0cn0HzWVo3dNi2B%2FPassaggio4\(1\).png?alt=media)

* Dopo il refresh della pagina, può essere richiesto di aggiornare il database

![](https://2166018961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYDclG5L1dBFKqS7vqZat%2Fuploads%2FaXraP6wNEbqLayLWoBPH%2Fimage.png?alt=media)

In seguito a questi passaggi, dovrebbe essere possibile continuare a utilizzare il gestionale normalmente e trovare di conseguenza i nuovi componenti presenti all'interno.