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

![](https://966958917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBZsjjMPIXBBaW8bd80O7%2Fuploads%2FEhJGipryeRC6knkSgXEH%2Fimmagine.png?alt=media)

### ✏️ 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.4.48/openstamanager/interfaccia/gestione-upload).

## 📓 Operazioni sui record

### ➕ Creazione record

I moduli che permettono la creazione di nuovi elementi presentano un pulsante apposito ![](https://966958917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBZsjjMPIXBBaW8bd80O7%2Fuploads%2FopC79qISg0jUFucM7YLu%2FPulsante%2B.PNG?alt=media) vicino all'intestazione della pagina.

![Pulsante di creazione record (Anagrafiche)](https://966958917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBZsjjMPIXBBaW8bd80O7%2Fuploads%2FnZWIuxWSmXTFAkYHtRvp%2Fadd-button.png?alt=media)

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.

![Creazione di un nuovo record (Anagrafiche)](https://966958917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBZsjjMPIXBBaW8bd80O7%2Fuploads%2FBvI1Y6tc5mTO1RsHuxtI%2FModal.gif?alt=media)

### 📝 Modifica record

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

![](https://966958917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBZsjjMPIXBBaW8bd80O7%2Fuploads%2FC6rwSGUsru2dkasBkmuq%2Frecord.jpeg?alt=media)

Per modificare le righe di un documento è possibile selezionare tutte le righe interessate e svolgere azioni di duplicazione o eliminazione massive.

![operazioni massive sulle righe documento](https://966958917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBZsjjMPIXBBaW8bd80O7%2Fuploads%2FDNBPcMrLkAE0FMerdFQZ%2Fimmagine.png?alt=media)

### 🔧 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.

![](https://966958917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBZsjjMPIXBBaW8bd80O7%2Fuploads%2FdlGQQ6t0zf4EPKeuubdW%2Fimmagine.png?alt=media)

{% hint style="info" %}
Per gli amministratori, è presente un plugin denominato **Info** che permette di visualizzare la cronologia del 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.4.48/openstamanager/interfaccia/broken-reference). Da qui inoltre, abilitando il modulo *Viste,* è possibile creare delle query personalizzate per cambiare la visualizzazione dei vari moduli.