Como instalar um módulo PrestaShop 8: o guia completo 2026

Instalar um módulo PrestaShop parece simples na teoria. Na prática, entre os módulos descarregados da loja de addons, os comprados em marketplaces externos, os desenvolvidos internamente e as restrições próprias do multiloja, os casos particulares aparecem depressa. Este guia cobre os três métodos de instalação válidos em 2026, os erros mais frequentes e as boas práticas para não partir uma loja em produção.

Antes de começar: faça uma cópia de segurança da loja

Esta etapa não é negociável. Antes de acrescentar qualquer módulo a uma loja em produção, precisa de uma cópia de segurança recente da base de dados e dos ficheiros. Se usa um alojamento sério (OVH, Cloudways, ou um alojamento partilhado com cPanel), já existe uma cópia diária automática. Verifique se está atualizada e, sobretudo, se é restaurável.

O ideal continua a ser testar num ambiente de pré-produção idêntico ao de produção e replicar depois a instalação. Se não tem staging, uma exportação rápida através da ferramenta de exportação da base de dados do PrestaShop é melhor do que nada.

Método 1: instalação através do back-office

É o método mais comum e o mais seguro. Funciona para todos os módulos entregues sob a forma de ficheiro ZIP, venham eles da loja de addons oficial, de um marketplace externo ou de um programador independente.

1. Inicie sessão no back-office do PrestaShop
2. Vá a Módulos → Gestor de módulos
3. Clique em Carregar um módulo (canto superior direito)
4. Arraste o ficheiro ZIP para a zona de carregamento, ou clique para o selecionar
5. Aguarde a mensagem de confirmação
6. Clique em Configurar para aceder aos parâmetros do módulo

Se o carregamento falhar com uma mensagem de erro de tamanho, as suas diretivas PHP são demasiado restritivas. É preciso aumentar upload_max_filesize, post_max_size e memory_limit no php.ini ou através de um ficheiro .htaccess na raiz do PrestaShop. Valores razoáveis: 64M para os dois primeiros, 256M para a memória.

Caso particular: módulo bloqueado pelo PrestaShop Marketplace

Se comprou o módulo em addons.prestashop.com, o ZIP está por vezes protegido por uma assinatura que exige ligação à sua conta PrestaShop. Nesse caso, a instalação passa obrigatoriamente por Módulos → Seleção e pelo botão de instalação associado à sua compra. É intencional: o PrestaShop impede assim a redistribuição não autorizada.

Método 2: instalação por FTP

Este método é útil em dois casos: o ficheiro ZIP é demasiado grande para os limites de PHP do seu alojamento, ou está a instalar vários módulos de uma vez e quer ir mais depressa.

1. Descompacte o ZIP do módulo no seu computador
2. Deve obter uma pasta com o nome do módulo (por exemplo omeumodulo/)
3. Carregue essa pasta para /modules/ na raiz do PrestaShop através de FTP ou SFTP
4. Volte a Módulos → Gestor de módulos
5. Procure o módulo na lista e clique em Instalar

Atenção: não descompacte na raiz do PrestaShop um ZIP que já contenha o caminho /modules/omeumodulo/, sob pena de sobrescrever ficheiros existentes. Verifique sempre a estrutura do ZIP antes da extração.

Alternativa: Explorer FTP diretamente no back-office

Se usar o Explorer FTP, pode carregar os ficheiros dos módulos diretamente a partir do back-office, sem cliente FTP externo. Prático quando trabalha em mobilidade ou quando não tem acesso ao FileZilla.

Método 3: instalação através do Composer (PrestaShop 9)

Este método diz respeito apenas aos módulos modernos desenvolvidos segundo as normas Symfony, por enquanto sobretudo os módulos oficiais e alguns módulos de programador. O Composer descarrega automaticamente o módulo e as suas dependências PHP.

cd /caminho/para/prestashop
composer require prestashop/module-name

Depois ativa-o no back-office como um módulo clássico. A documentação oficial do PrestaShop lista os módulos compatíveis com o Composer. Para os módulos de terceiros (marketplaces, programadores independentes), o método 1 continua a ser a norma.

Configurar um módulo depois da instalação

Uma vez instalado, um módulo permanece desativado enquanto não o configurar. Clique em Configurar ao lado do nome do módulo para aceder aos seus parâmetros.

Os módulos sérios fornecem uma página de configuração clara com os parâmetros essenciais. Os módulos amadores deixam-no sozinho perante um ficheiro config.xml para editar à mão, e isso é um sinal de alerta.

Muitos módulos exigem também a ativação de um ou vários hooks. Um hook é um ponto de ligação na página onde o módulo injeta o seu conteúdo. Por exemplo, um módulo de slider tem de se ligar ao hook displayHome para aparecer na página inicial. Verifique em Módulos → Posições se os hooks esperados estão ativos.

Testar num ambiente de staging

Numa loja com muito tráfego, nunca instale diretamente em produção. A sequência a respeitar:

1. Duplicar a loja em pré-produção (mesmas versões de PrestaShop, PHP e MySQL)
2. Instalar o módulo no staging
3. Testar durante 24 a 48 horas os percursos críticos: adicionar ao carrinho, checkout completo, pagamento, multiloja se aplicável
4. Verificar os registos (Symfony, Apache, PHP), porque um módulo pode funcionar à superfície e gerar erros silenciosos em segundo plano
5. Se estiver tudo verde, replicar a instalação em produção fora das horas de ponta

Os erros mais frequentes e as suas soluções

«O módulo não aparece na lista»

Três causas possíveis: o ZIP foi descompactado na pasta errada (verifique se está mesmo em /modules/nomedomodulo/), as permissões dos ficheiros estão incorretas (os ficheiros PHP devem estar em 644 e as pastas em 755), ou a cache do back-office está desatualizada. Para limpar a cache, vá a Parâmetros avançados → Desempenho e clique em Limpar a cache.

«Erro 500 depois da ativação»

O módulo é provavelmente incompatível com a sua versão de PrestaShop ou de PHP. Desative-o eliminando a pasta do módulo por FTP e verifique depois as versões na respetiva página de produto. A compatibilidade entre PrestaShop 1.7 e 8 é a origem número um de incompatibilidades.

«O módulo funciona mas não aparece»

Hook não ativado. Vá a Módulos → Posições, encontre o módulo na lista e verifique os hooks ligados. Se não houver nada assinalado, ligue-o aos hooks recomendados na documentação.

«Conflito com outro módulo»

Sintoma típico: um módulo funciona sozinho, mas parte quando ativa um segundo. A resolução passa pelos registos do Symfony (em var/logs/) e pela desativação alternada para identificar o culpado. Os conflitos mais frequentes envolvem módulos que alteram os mesmos hooks ou os mesmos templates.

Boas práticas depois da instalação

Depois de o módulo estar instalado e configurado, dois reflexos:

1. Documentar: mantenha um ficheiro com a lista dos módulos instalados, as suas versões e as suas licenças. Em caso de migração ou de pedido de apoio, poupa horas.
2. Atualizar regularmente: a maioria das falhas de segurança documentadas no PrestaShop tem origem em módulos de terceiros desatualizados. Ative as notificações de atualização em Módulos → Notificações.

E depois?

Para ir mais longe, explore o nosso catálogo de módulos PrestaShop 8 por categoria: SEO, checkout, marketing e mais. Cada módulo DataFirefly é entregue com documentação de instalação detalhada e apoio técnico.