# Moduli e plugin

I moduli sono la componente principale della struttura di OpenSTAManager. Sono progettati per avere una struttura facilmente personalizzabile e mantenere comportamenti indipendenti dal resto del software.

Ogni modulo del gestionale è raggiungibile attraverso il menu laterale, ma può presentare una grafica personalizzata sulla base della funzione a cui è dedicato. Esistono però alcune caratteristiche comuni che si possono individuare quasi sempre, descritte in questa pagina.

Per ottenere maggiori informazioni sul funzionamento interno e specifico di un modulo, è necessario visitare la relativa guida dedicata.

## Pagina principale

Accedendo a ogni modulo è possibile visualizzare l'elenco generale dei record salvati in esso. Cliccando su un singolo modulo si aprirà una schermata che permetterà di andare ad analizzarlo nel dettaglio e modificarlo.

La pagina principale di un modulo può essere composta da due strutture diverse: una tabella generale oppure un sistema di contenuti personalizzati.

### Tabella generale

La schermata principale che si apre entrando in un modulo è formata da una tabella che permette una serie di operazioni comuni su tutti gli elementi registrati all'interno del modulo:

* Scorrere e visualizzare (attraverso un click) i diversi record
* Selezionare diversi record attraverso le relative righe per esportarli (in formato CSV), stamparli o copiarli
* Selezionare dei record per effettuare delle azioni generali specifiche del modulo
* Filtrare i record in base a un determinato campo utilizzando i seguenti operatori:
  * != in caso si voglia ricercare un record diverso da un dato valore specifico;
  * \= in caso si voglia ricercare uno specifico valore all'interno dei record;
  * \> in caso si vogliano ricercare tutti i record maggiori di un determinato valore;
  * < in caso si vogliano ricercare tutti i record minori di un determinato valore.

<figure><img src="https://content.gitbook.com/content/imnORsInuaaXiiRnlr6m/blobs/LMcnyDPhhpP2QsAnyhVk/image.png" alt=""><figcaption></figcaption></figure>

### Contenuti personalizzati

Esistono alcuni moduli che rappresentano informazioni non compatibili al formato tabellare, come ad esempio **Dashboard** e **Statistiche**, che porteranno rispettivamente alla visualizzazione di un calendario interagibile e di un grafico personalizzabile.

### Gestione degli upload

Alcuni moduli presentano una componente generale per permettere l'inserimento di file di vario tipo all'utente finale del gestionale. Questa funzione viene spiegata in [Gestione upload](https://docs.openstamanager.com/2.10.3/openstamanager/interfaccia/gestione-upload).

## Operazioni sui record

### Creazione record

I moduli che permettono la creazione di nuovi elementi presentano un pulsante apposito ![](https://content.gitbook.com/content/imnORsInuaaXiiRnlr6m/blobs/D4mBilbTJgwhvGAeTpCD/Pulsante+.PNG) vicino all'intestazione della pagina.

<figure><img src="https://content.gitbook.com/content/imnORsInuaaXiiRnlr6m/blobs/OCOloEQ3yNNa2DPrybCv/image.png" alt=""><figcaption></figcaption></figure>

Una volta cliccato il pulsante in questione, verrà aperta una schermata sovrapposta al resto del gestionale che permettere di inserire le informazioni del nuovo elemento.

### Modifica record

Cliccando su un singolo record è possibile accede alla schermata di dettaglio dello stesso, da cui è possibile andare ad apportarvi modifiche.

<figure><img src="https://content.gitbook.com/content/imnORsInuaaXiiRnlr6m/blobs/AcW3ik34xiKPsth3kx2D/image.png" alt=""><figcaption></figcaption></figure>

Per modificare le righe di un documento è possibile selezionare tutte le righe interessate e svolgere azioni di duplicazione,  eliminazione massiva, confronto e aggiornamento dei prezzi.

<figure><img src="https://content.gitbook.com/content/imnORsInuaaXiiRnlr6m/blobs/O2qC4W6Dua8lIGKUueUM/immagine.png" alt=""><figcaption></figcaption></figure>

### Plugin

I plugin sono dei moduli che dipendono da altri moduli, e pertanto possono essere considerati dei sotto-moduli. Ogni modulo può possedere un numero variabile di plugin, che è possibile visualizzare nella sezione destra della pagina entrando in un record.

E' possibile aprire la barra dei plugin cliccando sull'apposito indicatore:

<figure><img src="https://content.gitbook.com/content/imnORsInuaaXiiRnlr6m/blobs/EZIMdZts8nma3O2T9dlp/immagine.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/imnORsInuaaXiiRnlr6m/blobs/1EFID8k6IC2bJVi2NZJM/immagine.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Per gli amministratori, è presente un plugin denominato **Info** che permette di visualizzare la cronologia di operazioni sul record
{% endhint %}

## Gestione dei moduli

Le operazioni di gestione dei moduli, quali abilitazione e disabilitazione, sono disponibili attraverso il modulo [Stato dei servizi](https://docs.openstamanager.com/2.10.3/openstamanager/interfaccia/broken-reference). Da qui inoltre, abilitando il modulo *Viste,* è possibile creare delle query personalizzate per cambiare la visualizzazione dei vari moduli.
