# 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="/files/3PqzrxqnyjNKuYn2i98y" 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](/2.7.3/openstamanager/interfaccia/gestione-upload.md).

## 📓 Operazioni sui record

### ➕ Creazione record

I moduli che permettono la creazione di nuovi elementi presentano un pulsante apposito ![](/files/-LZi3_ucH_QZ1sE_0hyp) vicino all'intestazione della pagina.

<figure><img src="/files/RNJzAXBuwIeFzASyL6dk" 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="/files/Yfn8OjhVu5nuAIBs8K8Z" 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="/files/VM2VoCmJTAyy7kiUlP9W" 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="/files/fZG043cGLnPpo6uOZAI2" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/kBnDms8fbajmnmig4lLg" 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](broken://pages/-M372PphqWo9_vcpY3pW). Da qui inoltre, abilitando il modulo *Viste,* è possibile creare delle query personalizzate per cambiare la visualizzazione dei vari moduli.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.openstamanager.com/2.7.3/openstamanager/interfaccia/moduli-e-plugin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.