Soluções de erros ao instalar extensões Joomla
Soluções de erros ao instalar extensões Joomla: componentes, módulos, pluguins e templates
Escrito por Emerson Rocha LuizSe você usa Joomla há algum tempo, provavelmente já passou por algum destes erros. O que escreverei aqui são alguns erros comuns, provaveis causas e soluções para estes erros. É provavel que mais tarde eu adicione novos erros/soluções ou revise os atuais, e aceito, claro, aceito sugestões, basta que você entre em contato comigo.
Permissões insuficientes
Mensagem ou sinal de erro típico
- Use a extensão JoomlaFox e verifique na aba permissões se está tudo com permissão de escrita (em verde). Caso contrário, pode ser este erro.
- Acesse /administrator/index.php?option=com_admin&task=sysinfo verifique na aba permissões de diretório se está tudo com permissão de escrita (em verde). Caso contrário, pode ser este erro.
Provável causa
A pasta temporária ou pastas destino não tem permissão de escrita, logo, não há como instalar o arquivo.
Provável Solução
- Reverta manualmente via FTP/SSH as permissões de modo que fiquem com permissão de escrita. Caso não consiga, provavelmente você não é o dono do arquivo (vide erro seguinte).
- Ative a Camada FTP do Joomla (/administrator/index.php?option=com_config, aba Servidor, em Configurações do FTP adicione dados do seu usuário FTP)
- Solução não ideal: use a opção 'Instalar a partir do Diretório' do /administrator/index.php?option=com_installer. Pode funcionar, mas apenas contorna o problema.
- Via SSH, de o comandos do tipo chmod -R XXX, aonde XXX é o numero da permissão.
- Usuários avançados: Usar aba JFoxConsole do JoomlaFox para executar um comando em PHP da API Joomla para alterar recursivamente permissões de arquivos e diretórios.
Dono do arquivo não permite escrita pelo servidor/seu usuário
Nota: entenda por 'escrita pelo servidor' quando o seu usuário ou o outro usuário que é dono do arquivo não permite que o servidor PHP execute/escreva/leia o arquivo, e 'escrita pelo seu usuário' o erro típico mais comum quando você instala ou faz upload via seu site Joomla e não consegue alterar/deletar os arquivos via FTP/SSH. São erros distintos, mas o segundo exemplo encomoda para quem quer editar algo diretamente, ainda que seu site possa funcionar sem problemas.
Mensagem ou sinal de erro típico
- Use a extensão JoomlaFox e verifique na aba permissões se está tudo com permissão de escrita (em verde). Caso contrário, pode ser este erro. (indiferente para 'escrita para seu usuário')
- Acesse /administrator/index.php?option=com_admin&task=sysinfo verifique na aba permissões de diretório se está tudo com permissão de escrita (em verde). Caso contrário, pode ser este erro. (indiferente para 'escrita para seu usuário')
- Via FTP, marque para exibir dono do arquivo, e verifique qual é.
- Via SSH, de o comando ls -la, e veja quel é o dono dos arquivos.
Provável causa
A pasta temporária ou pastas destino não tem permissão de escrita para o usuário em que o PHP é executado, logo, não há como instalar o arquivo. Esta causa é mais comum em servidores mal configurados ou que os administradores aletam que esta medida é mais segura.
Um erro adicional que pode acontecer é que arquivos instalados via servidor assumem o usuário do PHP, logo, você pode acabar não tendo permissão de escrita via FTP/SSH, a menos que você tenha direitos de edição para alterar o dono dos arquivos/pastas e o faça. Caso não tenha (situação provável em servidores que você não é o administrador) você terá que entrar em contato com o administrador e pedir para que ele troque as permissões para seu usuário FTP, e então você poderá editar arquivos via FTP/SSH.
Provável Solução
- Via SSH, de o comando chown -R nomedousuario * ou análogo e altere o nome dono do arquivo. Provavelmente irá falhar em hosts compartilhados.
- Entre em contato com o administrador do servidor e peça para ele fazer o comando anterior como root ou superusuário.
Path (caminho do site) errado
Mensagem ou sinal de erro típico
Pode apresentar os mesmos erros típicos que acontecem com os dois erros anteriores.
Provável causa
- Migração de servidor, em que você esqueceu de alterar os paths. O Joomla continua funcionando, porém todas as ações envolvendo movimentação de arquivos apresentarão erros.
- Por alguma razão algum administrador do sistema alterou os caminhos e não lhe avisou.
- Alguém editou por engano os paths que estavam funcionando.
Provável Solução
Se for mesmo path, errado, basta alterar para o certo no arquivo /configuration.php e obrigatóriamente este problema estará resolvido. Caso você realmente não sabia se o path está correto, um jeito não muito ortodoxo é instalar um novo Joomla em um subdiretório e copiar o path desde novo Joomla (desconsiderando o subdiretório, claro), que foi detectado automaticamente pelo sistema.
Arquivo de instalação contém vários arquivos de instalação dentro
Mensagem ou sinal de erro típico
- Mensagem do tipo 'Não foi encontrato arquivo XML de instalação'.
- Erro esporádico: não acontece com todos os arquivos que tenta instalar, e em geral somente com algum novo que você está testando.
Provável causa
- Você está tentando instalar um arquivo que deveria ser aberto e descompactado primeiro, e seu conteúdo sim, que deveria ser instalado.
- Você está tentando instalar um arquivo que não é uma extensão Joomla.
Provável Solução
Descompacte o arquivo manualmente e instale os arquivos compactados internos desde arquivo que reune vários instaladores ou que veio com o 'manual de instruções' junto no mesmo arquivo.
Arquivo de instalação contém um arquivo de instruções XML com erros
Mensagem ou sinal de erro típico
- As mensagens podem ser muito váriadas. Espere qualquer tipo de erro, porém em geral não são tão ligados a erros de permissão.
- Erro esporádico: não acontece com todos os arquivos que tenta instalar, e em geral somente com algum novo que você está testando.
- Erro na extensão após instalada: a extensão apresenta erros estranhos; não funciona direito como deveria.
Provável causa
- O aquivo XML contém erros. Em geral por culpa do desenvolvedor que cometeu erros. Pode fazer referência a arquivos que não foram incluídos no pacote, ou mesmo não faz referência a arquivos importantes sem os quais a extensão não irá funcionar adequadamente.
- Seu Joomla não está com plugin legado ativado, e você está tentando instalar alguma extensão que deveria estar com ele ativado.
Provável Solução
- Contactar o desenvolvedor e reportar o erro.
- Identificar e resolver o erro no arquivo você mesmo.