Dolibarr è una soluzione ERP e CRM open-source ampiamente utilizzata dalle aziende per gestire in modo efficiente le attività amministrative, contabili e commerciali. Uno dei principali punti di forza di Dolibarr è la sua modularità, che consente di aggiungere funzionalità in base alle specifiche esigenze aziendali.

Che si tratti di gestire fatture, magazzino, progetti o risorse umane, l’installazione e la configurazione dei moduli permette di personalizzare Dolibarr e ottimizzare i processi aziendali.

In questo articolo vedremo passo dopo passo come installare e configurare un modulo su Dolibarr, spiegando i diversi metodi di installazione, le impostazioni essenziali e le migliori pratiche per garantire un funzionamento ottimale.

1. Dove trovare i moduli per Dolibarr?

Dolibarr offre diverse fonti per scaricare i moduli:

• Moduli nativi: Alcuni moduli sono già inclusi in Dolibarr e devono solo essere attivati.
• Dolistore: Il marketplace ufficiale di Dolibarr offre una vasta gamma di moduli gratuiti e a pagamento per aggiungere nuove funzionalità.
• Marketplace alternativi: Alcuni sviluppatori offrono i propri moduli su piattaforme come GitHub, GitLab, DolibarrStore e Dolimarketplace.
• Sviluppo personalizzato: Le aziende con esigenze specifiche possono sviluppare e installare un proprio modulo personalizzato.

Prima di installare un modulo, è importante verificare che sia compatibile con la versione di Dolibarr in uso.

2. Metodi di installazione di un modulo in Dolibarr

Esistono tre principali metodi per installare un modulo in Dolibarr:

2.1 Installazione tramite l’interfaccia di Dolibarr

Se il modulo proviene da Dolistore o da una fonte ufficiale, è possibile installarlo direttamente dall’interfaccia di Dolibarr:

1. Accedere a Dolibarr come amministratore.
2. Andare su "Home" → "Configurazione" → "Moduli/Applicazioni".
3. Cliccare su "Aggiungi un modulo esterno".
4. Caricare il file ZIP del modulo.
5. Cliccare su "Carica", e Dolibarr installerà il modulo automaticamente.

Una volta installato, il modulo apparirà nell’elenco dei moduli disponibili.

2.2 Installazione manuale tramite FTP o SSH

Se hai ottenuto un modulo da una fonte esterna (ad esempio GitHub o uno sviluppatore indipendente), devi installarlo manualmente:

1. Scaricare il file ZIP del modulo.
2. Estrarre il file sul computer.
3. Caricare la cartella del modulo nella seguente directory di Dolibarr:
   bash

   htdocs/custom/
4. Assicurarsi che i permessi dei file siano correttamente impostati:
   bash

   chmod -R 755 htdocs/custom/mymodule
5. Accedere a Dolibarr, navigare su "Moduli/Applicazioni", e il modulo dovrebbe apparire nell’elenco.

2.3 Installazione tramite Git

Per installare un modulo direttamente da un repository Git (utile per aggiornamenti automatici), segui questi passaggi:

1. Connettiti al tuo server tramite SSH.
2. Vai nella directory htdocs/custom/:
   bash

   cd /var/www/html/dolibarr/htdocs/custom/
3. Clona il modulo da GitHub o GitLab:
   bash

   git clone https://github.com/nomeprogetto/mymodule.git
4. Imposta i permessi corretti sui file:
   bash

   chmod -R 755 mymodule
5. Il modulo apparirà automaticamente in Dolibarr sotto "Moduli/Applicazioni".

3. Attivare un modulo in Dolibarr

Dopo aver installato un modulo, è necessario attivarlo:

1. Andare su "Home" → "Configurazione" → "Moduli/Applicazioni".
2. Trovare il modulo installato nell’elenco.
3. Cliccare su "Attiva".
4. Se necessario, seguire eventuali istruzioni di configurazione aggiuntive.

Alcuni moduli richiedono l’esecuzione di uno script SQL per creare tabelle nel database. Dolibarr notificherà se questa operazione è necessaria.

4. Configurare un modulo dopo l’installazione

Ogni modulo può avere impostazioni specifiche che devono essere configurate:

1. Accedere alle impostazioni del modulo

   • Dopo l’attivazione, cliccare su "Configura" accanto al modulo.
   • Impostare i parametri in base alle esigenze aziendali.

2. Gestire i permessi degli utenti

   • Andare su "Home" → "Utenti e Gruppi".
   • Assegnare i diritti di accesso agli utenti che devono utilizzare il modulo.

3. Testare il modulo

   • Eseguire test funzionali per verificare che tutto funzioni correttamente.
   • Controllare i log di Dolibarr in caso di errori:
     bash

     tail -f htdocs/documents/dolibarr.log

5. Aggiornare o disinstallare un modulo

5.1 Aggiornare un modulo

Se è disponibile una nuova versione del modulo, segui questi passaggi:

• Tramite l’interfaccia di Dolibarr: Scaricare la nuova versione e reinstallare il modulo.
• Tramite FTP/Git: Sostituire i file esistenti in htdocs/custom/ e verificare se sono necessari aggiornamenti del database.

Prima di qualsiasi aggiornamento, è consigliabile eseguire un backup completo di Dolibarr.

5.2 Disinstallare un modulo

Se non hai più bisogno di un modulo, puoi disinstallarlo:

1. Disattivare il modulo in "Moduli/Applicazioni".
2. Eliminare la sua cartella da htdocs/custom/.
3. Rimuovere eventuali tabelle del database associate (con attenzione).

6. Migliori pratiche per l’installazione dei moduli Dolibarr

• Verificare sempre la compatibilità del modulo con la propria versione di Dolibarr.
• Testare il modulo in un ambiente di staging prima di implementarlo in produzione.
• Eseguire un backup completo prima di installare o aggiornare un modulo.
• Non modificare i file del core di Dolibarr, per evitare problemi con gli aggiornamenti.
• Utilizzare moduli provenienti da fonti affidabili, come Dolistore, GitHub, DolibarrStore o Dolimarketplace.

Conclusione

L’installazione e la configurazione di un modulo in Dolibarr permettono di espandere le funzionalità dell’ERP e di adattare il sistema alle esigenze aziendali specifiche. Seguendo questa guida, potrai scaricare, installare, attivare e configurare i moduli in modo semplice e sicuro.

Che si tratti di gestione commerciale, fatturazione, gestione delle scorte o dei progetti, i moduli di Dolibarr offrono una personalizzazione avanzata e migliorano l’efficienza operativa della tua azienda.

Hai già installato un modulo in Dolibarr? Condividi la tua esperienza nei commenti!