Modulo non trovato: risorse

Il peut arriver che, dopo aver installato un modulo, le sue risorse non possano essere caricate. Quando provi ad accedere alla dashboard, potresti finire su una pagina con una funzionalità danneggiata o mancante.

Puoi usare la console per individuare da dove proviene l’errore. Premendo F12 (su Windows), si aprirà la console di sviluppo. Lì vedrai il percorso dell’errore.

Facciamo vedere come risolvere questi problemi.

Collegamento simbolico mancante

A volte sembra che la causa sia un collegamento simbolico mancante. Le risorse di un modulo non sono esposte direttamente al browser. NexoPOS utilizza collegamenti simbolici per fornire accesso diretto solo alla directory delle risorse, preservando i file interni del modulo e, con lo stesso meccanismo, evitando eventuali fughe di informazioni o vulnerabilità.

La soluzione consiste quindi nel generare il collegamento simbolico. Sebbene è vero che NexoPOS genera automaticamente il collegamento simbolico, se hai installato il modulo rilasciando/estraendo il file, questo processo è stato saltato.

Per creare un collegamento simbolico, dovrai recuperare il nome della cartella in cui è installato il tuo modulo. Quel nome è chiamato anche “namespace”. È un nome univoco con cui NexoPOS identifica i moduli. Per l’errore sopra, il namespace del modulo è “NsBulkImporter” (usato per il modulo Bulk Importer). Quindi eseguiremo questo comando nel terminale:

php artisan modules:symlink NsBulkImporter

Se il problema persiste, l’errore potrebbe essere altrove.

File errati e permessi

Se le soluzioni precedenti non funzionano, potresti provare ad assegnare i permessi corretti ai file. Dovrai eseguire i seguenti comandi nella root della directory del tuo modulo. Se assumiamo che il tuo modulo abbia uno spazio dei nomi NsBulkImporter, dovrai andare a:

/path/to/nexopos/modules/NsBulkImporter

Da lì, eseguirai il comando:

find -type d -exec chmod 755 {} \;
find -type f -exec chmod 644 {} \;

Questo assegnerà 755 come permessi per le tue directory e 644 come permessi per il tuo file.

Se nessuna di queste soluzioni funziona, contatta l’assistenza.