Dolibarr, il sistema ERP e CRM open source, è ampiamente utilizzato da piccole e medie imprese per la sua modularità, flessibilità e facilità d’uso. Tuttavia, come ogni software, gli aggiornamenti – sebbene essenziali per la sicurezza, le nuove funzionalità e le prestazioni – possono talvolta introdurre anomalie impreviste. Uno dei problemi più comuni riscontrati dagli utenti dopo un aggiornamento di Dolibarr è la visualizzazione errata o l’assenza del logo aziendale nell’interfaccia o nei documenti generati come fatture e preventivi.

Questo articolo propone una guida completa e pratica per identificare, diagnosticare e risolvere i problemi di visualizzazione del logo aziendale dopo un aggiornamento di Dolibarr. Che tu abbia aggiornato dalla versione 16 alla 17, dalla 18 alla 19 o a una versione successiva, i passaggi descritti qui ti aiuteranno a ripristinare correttamente l’immagine del tuo brand all’interno di Dolibarr.

Comprendere la natura del problema

Dopo un aggiornamento, potresti notare:

• Il logo non viene più visualizzato nell’angolo in alto a sinistra dell’interfaccia.

• Il logo è assente nei PDF (fatture, ordini, preventivi).

• Il logo appare rotto (immagine non trovata o percorso non valido).

• Vengono mostrati più loghi in modo errato o sovrapposto.

• Moduli diversi mostrano versioni diverse del logo.

Questi problemi possono essere dovuti a modifiche nella struttura delle cartelle, nelle variabili di configurazione, nei permessi o nella logica di rendering dei template.

Punti principali da controllare

1. Impostazioni di configurazione

2. Temi e modelli di visualizzazione

3. File system e cartella di upload

4. Permessi e accessi ai file

5. Compatibilità con la versione PHP

6. Cache del browser e visualizzazione

Vediamo ogni punto nel dettaglio.

1. Impostazioni di configurazione: Verificare il percorso e il formato del logo

Vai a:

Home > Configurazione > Azienda/Organizzazione

Nella sezione "Logo e filigrana":

• Controlla che il percorso del file del logo sia corretto.

• Se hai caricato un nuovo logo, verifica che sia presente nell’elenco.

• Verifica il formato: sono supportati JPG, PNG e GIF. Per risultati ottimali, usa PNG con sfondo trasparente.

Problemi comuni:

• Dopo un aggiornamento, il percorso del logo può tornare al valore predefinito.

• Il nome del file del logo contiene caratteri speciali che Dolibarr potrebbe non gestire bene.

2. Temi e problemi nei modelli

Il logo nell’interfaccia viene visualizzato tramite CSS e logica del tema.

Vai a:

Home > Configurazione > Aspetto

Controlla il tema selezionato. Se il logo non è visibile:

• Prova temporaneamente un tema predefinito (es: "eldy" o "amarok").

• Verifica i file template in /htdocs/theme.

• Nei temi personalizzati, assicurati che i tag {logo} siano corretti.

Per i PDF:

• Vai su:

Moduli > Template PDF

• Apri il modulo (Fatture, Ordini, ecc.)

• Verifica il percorso del logo nelle impostazioni del modello

3. File system e cartella di upload

Dolibarr salva i loghi in:

/htdocs/viewimage.php?modulepart=mycompany&file=logos/nomelogofile.ext

Verifica:

• Che esista la cartella documents/mycompany/logos/.

• Che il file del logo sia effettivamente lì.

• Che l’immagine non sia corrotta (apri il file direttamente nel browser).

Verifica anche conf.php:

$conf->mycompany->dir_output = '/var/www/html/documents/mycompany';

4. Permessi dei file e cartelle

Permessi errati possono impedire a Dolibarr l’accesso al logo.

Verifica:

chmod -R 755 /var/www/html/documents/mycompany
chown -R www-data:www-data /var/www/html/documents/mycompany

Usa l’utente corretto (www-data o apache) a seconda del tuo server.

5. Compatibilità PHP

Alcune funzioni (come imagecreatefrompng()) richiedono librerie grafiche PHP.

Dopo l’aggiornamento:

• Verifica che la libreria GD sia attiva: php -m | grep gd

• Se mancante: sudo apt install php-gd

• Riavvia Apache o PHP-FPM

Controlla i log:

/var/log/apache2/error.log
/var/log/php-fpm.log

6. Svuotare cache e aggiornare il browser

A volte è un problema di cache del browser:

• Svuota la cache del browser

• Se usi un CDN o proxy, svuota anche quella cache

• Dolibarr memorizza impostazioni in sessione – esci e rientra

Passaggi per reimpostare il logo

1. Vai su:

Home > Configurazione > Azienda/Organizzazione

2. Scorri alla sezione logo

3. Carica un file PNG pulito (max 300px larghezza)

4. Assegna il logo

5. Salva

6. Genera un PDF (es. Fattura) e verifica il logo

Se non compare:

• Riapri le impostazioni del modulo PDF

• Reimposta o svuota il campo del percorso del logo

• Salva e riprova

Ambienti MultiCompany

Se usi il modulo MultiCompany:

• Ogni azienda ha il proprio logo

• Passa al contesto di ciascuna azienda

• Ripeti i passaggi di configurazione

Verifica i percorsi:

/documents/mycompany/ID_azienda/logos/logo.png

Assicurati che ogni logo sia nella directory giusta.

Percorsi personalizzati nei template

Per utenti avanzati:

• Nei template PDF o HTML personalizzati, usa dol_buildpath() o $conf->mycompany->dir_output

• Evita percorsi assoluti che possono rompersi dopo un aggiornamento

Correzione automatica tramite riga di comando

Puoi modificare il logo via SQL:

UPDATE llx_const SET value='logos/logo.png' WHERE name='MAIN_INFO_SOCIETE_LOGO';

• Poi svuota la cache o riavvia i servizi web

Manutenzione dei modelli dopo l’aggiornamento

Gli aggiornamenti possono modificare i file PDF:

• Reimposta le configurazioni del logo

• Salva copie di sicurezza di /core/modules/facture/doc/ o /doc/

Usa un sistema di controllo versioni per i template personalizzati.

Best practice per i loghi in Dolibarr

1. Usa nomi di file coerenti (niente spazi o caratteri speciali)

2. Usa file PNG ottimizzati (<150KB)

3. Mantieni una struttura ordinata: logos/logo.png, logos/logo_small.png

4. Documenta i percorsi in ambienti MultiCompany

5. Inserisci un README in /documents/mycompany

Conclusione: mantieni integra la tua identità visiva

La visibilità del logo è essenziale per la credibilità e l’immagine aziendale. Gli aggiornamenti Dolibarr possono a volte disturbare il logo a causa di modifiche in temi, parametri o modelli. Fortunatamente, questi problemi sono risolvibili con un approccio strutturato.

Comprendendo come Dolibarr gestisce, richiama e visualizza i loghi, potrai individuare rapidamente la causa dei problemi e ripristinare la tua identità visiva in tutti i moduli e documenti.

Che tu gestisca una o più aziende, segui questa guida per garantire che il tuo logo rimanga sempre visibile, coerente e professionale – anche dopo importanti aggiornamenti.