# 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://3649373145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UBYFzZ0uSbNRXL14nao%2Fuploads%2FGFq1cobtlHXwLun8vpyc%2FPassaggio1\(1\).png?alt=media)

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

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

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

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

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

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

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

![](https://3649373145-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UBYFzZ0uSbNRXL14nao%2Fuploads%2F5xRgtjV1a5qJqom5tRjo%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.