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

```
directory = "Cartella di installazione"
name = "Nome del modulo"
options = "Operazione da eseguire all'apertura"
version = "Versione"
compatibility = "Versioni di compatibilità"
order = "Ordine in cui visualizzare il modulo"
default = "Se predefinito"
enabled = "Se abilitato"
icon = "Ico
parent = "Genitore del modulo"
```

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

```
directory = "Cartella di installazione"
name = "Nome del plugin"
options = "Operazione da eseguire all'apertura"
idmodule_from = "Nome del modulo di origine"
idmodule_to = "Nome del modulo di destinazione e visualizzazione"
position = "Tipo di modulo (valori disponibili: tab)"
version = "Versione"
compatibility = "Versioni di compatibilità"
order = "Ordine in cui posizionare il plugin"
enabled = "Se abilitato"
```

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

<figure><img src="https://807460374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ1tbQf2Op4Kr7ccfkoH0%2Fuploads%2Fwd1StsN37Nl5DX5N1eDV%2Fimmagine.png?alt=media&#x26;token=a52b0584-0003-40ed-883f-4d1b04429f20" alt=""><figcaption></figcaption></figure>

* Cliccare sul tasto ![](https://content.gitbook.com/content/J1tbQf2Op4Kr7ccfkoH0/blobs/LDalbVs7a1aEYRovpxw2/Sfoglia.png) e selezionare il file `.zip` ricevuto precedentemente.

<figure><img src="https://807460374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ1tbQf2Op4Kr7ccfkoH0%2Fuploads%2FXGaeQgKBUqBvr5wz3W96%2Fimmagine.png?alt=media&#x26;token=c748d6bb-e058-41ba-8e2c-0f32deba5f9b" alt=""><figcaption></figcaption></figure>

* Cliccare sul tasto ![](https://content.gitbook.com/content/J1tbQf2Op4Kr7ccfkoH0/blobs/Cs5atPq6wtjp981J88V8/Carica.PNG) per andare a caricare il modulo in OpenSTAManager.
* Confermare la procedura cliccando su **SI**.

<figure><img src="https://807460374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ1tbQf2Op4Kr7ccfkoH0%2Fuploads%2FMyr8Vw7s7jTWNvIwByvI%2Fimmagine.png?alt=media&#x26;token=db321dae-aa20-4a53-90cb-81ee2bc2bb1e" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://807460374-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ1tbQf2Op4Kr7ccfkoH0%2Fuploads%2FRrHLH6j5OfwTL1zjNAce%2Fimmagine.png?alt=media&#x26;token=0db1b6d5-6434-479a-ba18-d9e60e72a1e9" alt=""><figcaption></figcaption></figure>

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