Módulo não encontrado: Assets

Às vezes, após instalar um módulo, os respectivos assets não conseguem ser carregados. Ao tentar acessar o painel, você pode acabar em uma página com um recurso quebrado ou ausente.

Você pode usar o console para identificar de onde vem o erro. Ao pressionar F12 (no Windows), ele abrirá o console do desenvolvedor. Nele, você verá o caminho do erro.

Vamos mostrar como corrigir esses problemas.

Link Simbólico Ausente

Às vezes, parece que o motivo disso é um link simbólico ausente. Os assets de um módulo não são expostos diretamente ao navegador. O NexoPOS usa links simbólicos para fornecer acesso direto apenas ao diretório de assets, preservando os arquivos internos do módulo e, por esse mesmo meio, evitando quaisquer vazamentos ou vulnerabilidades.

A solução, portanto, é gerar o link simbólico. Embora seja verdade que o NexoPOS gera o link simbólico automaticamente, se você instalou o módulo ao soltar/extrair o arquivo, esse processo foi ignorado.

Para gerar um link simbólico, você terá que recuperar o nome da pasta onde o seu módulo está instalado. Esse nome também é chamado de “namespace”. É um nome exclusivo pelo qual o NexoPOS identifica módulos. Para o erro acima, o namespace do módulo é “NsBulkImporter” (usado para o módulo de Importação em Lote). Em seguida, executaremos este comando no terminal:

php artisan modules:symlink NsBulkImporter

Se o problema persistir, o erro pode estar em outro lugar.

Arquivos e Permissões Incorretos

Se as soluções anteriores não funcionarem, você pode tentar atribuir as permissões corretas de arquivo. Você terá que executar os comandos a seguir na raiz do diretório do seu módulo. Se assumirmos que seu módulo tem um namespace NsBulkImporter, você deverá acessar:

/path/to/nexopos/modules/NsBulkImporter

A partir daí, você executará o comando:

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

Isso definirá 755 como permissão para seus diretórios e 644 como permissão para seu arquivo.

Se nenhuma dessas soluções funcionar, entre em contato com o suporte.