Pular para o conteúdo principal

Problemas de Instala��o

Falha no Upload do M�dulo​

Problema: O ficheiro zip do m�dulo n�o � carregado atrav�s do painel de administra��o do Perfex.

Causas e Solu��es:

CausaSolu��o
Tamanho do ficheiro excede o limite de upload do PHPAumente upload_max_filesize e post_max_size em php.ini para pelo menos 64M
Timeout do servidor durante o uploadAumente max_execution_time em php.ini para 300
Problema de permiss�esVerifique se o diret�rio modules/ tem permiss�es de escrita (chmod 755)

Alternativa: Fa�a o upload via FTP/SFTP:

  1. Extraia o zip no seu computador
  2. Carregue a pasta extra�da para your-perfex/modules/
  3. Ative atrav�s de Setup ? Modules no painel de administra��o

M�dulo N�o Aparece Ap�s o Upload​

Problema: Carregou o m�dulo mas ele n�o aparece em Setup ? Modules.

Solu��es:

  1. Certifique-se de que a estrutura de pastas est� correta: modules/saas/ (n�o modules/saas-module/ ou modules/saas/saas/)
  2. Verifique se todos os ficheiros foram carregados completamente (compare o n�mero de ficheiros)
  3. Limpe a cache do navegador e atualize a p�gina
  4. Verifique as permiss�es dos ficheiros: todo o diret�rio modules/saas/ deve ser leg�vel pelo servidor web

Falha na Verifica��o MySQL​

Problema: Ao clicar em "Click here to verify server settings" � exibido um erro.

Erro: "Access denied for user"​

Causa: Nome de utilizador ou palavra-passe MySQL incorretos.

Corre��o:

  1. Verifique novamente as credenciais MySQL
  2. Se usar cPanel, tente usar o seu nome de utilizador e palavra-passe do cPanel
  3. Teste as credenciais manualmente:
mysql -u your_username -p -h localhost
# Enter your password when prompted
# If you can log in, the credentials are correct

Erro: "Can't connect to MySQL server"​

Causa: MySQL n�o est� em execu��o ou host/porta incorretos.

Corre��o:

  1. Verifique se o MySQL est� em execu��o: sudo systemctl status mysql
  2. Confirme que o host est� correto (geralmente localhost)
  3. Confirme que a porta est� correta (geralmente 3306)
  4. Se o MySQL est� num servidor diferente, use o endere�o IP desse servidor

Erro: "CREATE command denied"​

Causa: O utilizador MySQL n�o tem permiss�o para criar bases de dados.

Corre��o:

-- Log in to MySQL as root:
GRANT ALL PRIVILEGES ON *.* TO 'your_username'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;

Ou no cPanel: V� a MySQL Databases ? User Privileges ? Marque "ALL PRIVILEGES"

P�gina Branca Ap�s Ativa��o​

Problema: Ap�s ativar o m�dulo, v� uma p�gina branca.

Solu��es:

  1. Verifique os logs de erros PHP: Consulte /var/log/apache2/error.log (Apache) ou /var/log/nginx/error.log (Nginx)
  2. Ative temporariamente a exibi��o de erros: Adicione ao seu .htaccess ou index.php: 
    ini_set('display_errors', 1);
    error_reporting(E_ALL);
  3. Verifique a vers�o PHP: Certifique-se de que est� a usar PHP 7.4 ou superior
  4. Verifique o limite de mem�ria: Defina memory_limit = 256M em php.ini

Formul�rio de Registo N�o Aparece​

Problema: A p�gina de destino n�o mostra um formul�rio de registo.

Solu��es:

  1. Certifique-se de que criou pelo menos um plano em SaaS Management ? Plans
  2. Verifique se os registos est�o ativados em SaaS Management ? SuperAdmin Settings ? Tenants Settings
  3. Verifique se o URL da p�gina de destino est� correto em Landing Page Settings
  4. Tente selecionar um modelo de p�gina de destino diferente
  5. Limpe a cache do navegador

E-mails N�o S�o Enviados​

Problema: E-mails de boas-vindas, de verifica��o ou de faturas n�o s�o enviados.

Solu��es:

  1. Configure o SMTP no Perfex CRM: V� a Setup ? Email ? Email Settings
  2. Servi�os SMTP recomendados:
    • Gmail SMTP (gr�tis at� 500 e-mails/dia)
    • SendGrid (plano gratuito: 100 e-mails/dia)
    • Mailgun (plano gratuito: 5.000 e-mails/m�s)
  3. Teste o envio de e-mails em Setup ? Email ? Send Test Email
  4. Verifique a pasta de spam ? os e-mails podem estar l�
informação

O SMTP � crucial! Sem SMTP configurado, nenhum e-mail ser� enviado da sua plataforma ? incluindo e-mails de verifica��o, boas-vindas e faturas. Configure isto primeiro!

Base de Dados do Inquilino N�o � Criada​

Problema: O inquilino regista-se mas a sua base de dados n�o � criada.

Solu��es:

  1. Verifique as credenciais MySQL nas defini��es SaaS (clique no bot�o verificar)
  2. Verifique se o seu utilizador MySQL tem o privil�gio CREATE DATABASE
  3. Em alojamento partilhado, verifique se atingiu o limite de bases de dados
  4. Consulte o Registo de Atividade SaaS para detalhes de erros
  5. Consulte os logs de erros PHP para erros espec�ficos do MySQL

Erro "Maximum database connections"​

Problema: Erro sobre demasiadas conex�es � base de dados.

Solu��es:

  1. Aumente o max_connections do MySQL em my.cnf: 
    [mysqld]
    max_connections = 200
  2. Reinicie o MySQL: sudo systemctl restart mysql
  3. Considere otimizar o seu servidor (mais RAM) se tiver muitos inquilinos
dica

Problema resolvido? Se ainda tiver problemas, consulte Domain & DNS Issues ou contacte Support.