Come integrare un modulo personalizzato in Dolibarr?
   03/06/2025 00:00:00     Dolibarr    0 Commenti
Come integrare un modulo personalizzato in Dolibarr?

Dolibarr è una soluzione ERP e CRM open-source nota per la sua flessibilità e modularità. Grazie alla sua architettura, è possibile aggiungere funzionalità specifiche sviluppando moduli personalizzati. Che si tratti di soddisfare esigenze aziendali specifiche, automatizzare attività o migliorare l'esperienza utente, l'integrazione di un modulo personalizzato in Dolibarr è una soluzione ideale.

In questo articolo, esploreremo passo dopo passo come integrare un modulo personalizzato in Dolibarr, dalla progettazione all'installazione, passando per lo sviluppo e la configurazione.

1. Perché creare un modulo personalizzato per Dolibarr?

Dolibarr offre un'ampia gamma di moduli nativi ed estensioni disponibili su Dolistore. Tuttavia, a volte queste soluzioni non coprono completamente le esigenze specifiche di un'azienda. Ecco alcuni motivi per creare un modulo personalizzato:

  • Automatizzare processi interni specifici per la tua attività.
  • Aggiungere nuove funzionalità non disponibili in Dolibarr o nei moduli esistenti.
  • Modificare o migliorare l'interfaccia utente per ottimizzare l'ergonomia.
  • Creare connettori con altre applicazioni utilizzate in azienda.
  • Personalizzare report e dashboard per un monitoraggio più preciso.

2. Prerequisiti prima di integrare un modulo personalizzato

Prima di iniziare l'integrazione, è importante assicurarsi che il tuo ambiente Dolibarr sia pronto ad accogliere un nuovo modulo.

2.1 Verificare la versione di Dolibarr

Ogni modulo deve essere compatibile con la versione installata di Dolibarr. Per verificare la versione:

  1. Accedi a Dolibarr come amministratore.
  2. Vai su Home → Configurazione → Informazioni di sistema.

Assicurati che il modulo sia compatibile con questa versione.

2.2 Abilitare la modalità sviluppatore

Dolibarr ha una modalità sviluppatore che aiuta a visualizzare gli errori e a facilitare il debugging:

  1. Vai su Configurazione → Varie.
  2. Aggiungi la seguente riga nel file conf/conf.php:
    php
    $dolibarr_main_prod = 0;

2.3 Accedere alla cartella dei moduli

Tutti i moduli di Dolibarr sono memorizzati nella cartella:

bash
htdocs/custom/

Si consiglia di creare i propri moduli in questa cartella per evitare di sovrascrivere file nativi durante gli aggiornamenti.

3. Sviluppare un modulo personalizzato per Dolibarr

Un modulo Dolibarr è composto principalmente da file PHP e strutture specifiche.

3.1 Creare la struttura del modulo

Un modulo Dolibarr è organizzato come segue:

bash
htdocs/custom/mymodule/ │── core/ │ ├── modules/ │── class/ │── admin/ │── script/ │── mymodule.php │── README.md │── modulebuilder.json

Spiegazione delle cartelle:

  • core/modules/: Contiene i file di configurazione del modulo.
  • class/: Definisce le classi PHP utilizzate dal modulo.
  • admin/: Interfaccia di amministrazione del modulo.
  • script/: Script aggiuntivi per installazione o aggiornamenti.

3.2 Creare il file di configurazione del modulo

Il file principale del modulo (mymodule.php) permette a Dolibarr di riconoscere il modulo:

php
class modMymodule extends DolibarrModules { function __construct($db) { global $langs; $this->db = $db; $this->numero = 500000; $this->family = "custom"; $this->name = "Mymodule"; $this->description = "Un modulo personalizzato per Dolibarr"; $this->version = "1.0"; $this->rights_class = 'mymodule'; } }

3.3 Aggiungere una tabella SQL per memorizzare i dati

Se il modulo deve memorizzare informazioni specifiche, è possibile creare una tabella SQL:

sql
CREATE TABLE llx_mymodule ( rowid INT AUTO_INCREMENT PRIMARY KEY, label VARCHAR(255) NOT NULL, date_creation TIMESTAMP DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB;

Lo script SQL può essere posizionato in script/install.sql ed eseguito all'attivazione del modulo.

4. Installare e attivare il modulo in Dolibarr

Una volta sviluppato il modulo, è necessario integrarlo in Dolibarr.

4.1 Copiare il modulo in Dolibarr

Posiziona la cartella del modulo in:

bash
htdocs/custom/

4.2 Attivare il modulo dal pannello di amministrazione

  1. Vai su Configurazione → Moduli/Applicazioni.
  2. Cerca il tuo modulo nell'elenco.
  3. Clicca su Attiva.
  4. Se necessario, esegui gli script SQL associati.

5. Testare e correggere il modulo

5.1 Controllare i log degli errori

Se il modulo non funziona correttamente, consulta i log degli errori di Dolibarr in:

bash
htdocs/documents/dolibarr.log

5.2 Abilitare la modalità di debug PHP

Aggiungi questa riga in conf/conf.php per visualizzare gli errori:

php
ini_set('display_errors', 1); error_reporting(E_ALL);

5.3 Effettuare test utente

  • Verifica se i permessi funzionano correttamente.
  • Testa l'interfaccia e i moduli del modulo.
  • Controlla la compatibilità con altri moduli attivi.

6. Distribuire e mantenere il modulo

Se vuoi condividere il modulo con la community, puoi:

  • Pubblicarlo su Dolistore (il marketplace dei moduli Dolibarr).
  • Mettere il codice su GitHub/GitLab per aggiornamenti collaborativi.
  • Garantire la compatibilità con le nuove versioni di Dolibarr, testando e aggiornando il modulo regolarmente.

Conclusione

Integrare un modulo personalizzato in Dolibarr consente di adattare l’ERP alle esigenze specifiche e aggiungere funzionalità su misura. Seguendo questi passaggi – dalla creazione del modulo, alla sua configurazione, installazione e test – è possibile migliorare Dolibarr senza modificarne il core.

Con un po’ di conoscenza dello sviluppo PHP e una buona gestione degli aggiornamenti, puoi ottimizzare la gestione aziendale integrando funzionalità progettate appositamente per le tue esigenze.

Hai mai integrato un modulo personalizzato in Dolibarr? Condividi la tua esperienza nei commenti!

Commenti

Accedi o registrati per inserire commenti