# Fórum Comunitário: guia completo

> Apresentação e pré-requisitos O Fórum Comunitário acrescenta um verdadeiro fórum à sua loja PrestaShop, diretamente ligado à conta de cliente existente. Os seus clientes abrem tópicos, respondem uns aos outros,…

- Página: <https://www.datafirefly.com/pt/documentation/dfforum/>
- Idioma: pt
- Atualizado em: 2026-09-03
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfforum/index.md), [en](https://www.datafirefly.com/en/documentation/dfforum/index.md), [es](https://www.datafirefly.com/es/documentation/dfforum/index.md), [de](https://www.datafirefly.com/de/documentation/dfforum/index.md), [it](https://www.datafirefly.com/it/documentation/dfforum/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfforum/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfforum/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Apresentação e pré-requisitos

O Fórum Comunitário acrescenta um verdadeiro fórum à sua loja PrestaShop, diretamente ligado à conta de cliente existente. Os seus clientes abrem tópicos, respondem uns aos outros, modificam ou eliminam as suas próprias mensagens e denunciam os abusos, enquanto mantém o controlo a partir do back-office: categorias e subfóruns, moderação à unidade ou por lote, pré-moderação opcional e fila de denúncias. Tudo sem ferramenta de terceiros nem base de dados externa.

- Compatível com PrestaShop 8.0 a 9.x, tema Classic e temas derivados.
- PHP 8.1 a 8.3.
- Multiloja e multilingue (FR/EN/ES/DE/IT).
- Nenhuma tarefa CRON necessária, nenhuma dependência Composer.
- Arquitetura conforme ao PrestaShop (ObjectModel, ModuleAdminController), compatível com PS 8 e PS 9 sem adaptação.

Os membros usam a sua **conta de cliente PrestaShop habitual**. Não é necessária nenhuma segunda conta: é acrescentada uma ligação para o fórum na área de cliente e no rodapé.

O pacote de traduções cobre FR/EN/ES/DE/IT e os modelos de e-mail de denúncia existem em francês e inglês. Numa loja em português, traduza as cadeias do front-office (« Novo tópico », « Responder », « Denunciar », ficha de autor) em Internacional > Traduções e renomeie a categoria de demonstração « Discussion générale ».

## Instalação

Instale o módulo como qualquer módulo PrestaShop:

1. Descarregue o arquivo `dfforum.zip` a partir da sua conta de cliente.
2. No back-office, vá a **Módulos > Gestor de módulos**.
3. Clique em **Instalar um módulo** e carregue o arquivo.
4. Depois de instalado, clique em **Configurar**.

Na instalação, o módulo cria as suas tabelas (categorias, tópicos, mensagens, denúncias), regista os seus hooks, acrescenta o separador pai **DataFirefly Forum** e inicia uma primeira categoria de demonstração « Discussion générale » para lhe permitir testar imediatamente.

Se os URLs amigáveis não se ativarem de imediato, limpe a cache (**Parâmetros avançados > Desempenho**) e regenere os URLs a partir de **Tráfego e SEO**.

## Definições gerais do módulo

A página de configuração reúne todas as definições do fórum:

- **Pré-moderação**: se ativada, cada novo tópico ou mensagem passa por uma fila de espera antes de ser público.
- **Leitura pelos convidados**: autoriza ou não a consulta do fórum sem estar autenticado (a escrita continua reservada aos clientes autenticados).
- **Tópicos por página**: número de tópicos apresentados numa categoria (20 por defeito).
- **Mensagens por página**: número de mensagens apresentadas num tópico (15 por defeito).
- **Comprimento mínimo**: número mínimo de caracteres exigido para uma mensagem (10 por defeito).
- **Intervalo anti-flood**: duração mínima, em segundos, entre duas mensagens de um mesmo membro (30 por defeito; 0 para desativar).
- **Denúncias**: ativa ou não a possibilidade de os membros denunciarem uma mensagem.
- **Janela de edição**: duração, em minutos, durante a qual um membro ainda pode modificar a sua mensagem (30 por defeito; 0 para proibir a edição).
- **E-mail de notificação**: endereço que recebe as denúncias (por defeito, o e-mail da loja).

## Criar categorias e subfóruns

A partir do separador **DataFirefly Forum > Categorias**, estruture o seu fórum. Uma categoria pode ser um tema de primeiro nível ou um subfórum associado a outra categoria.

- **Nome e descrição**: textos traduzíveis por idioma, apresentados na página inicial do fórum.
- **Categoria pai**: deixe vazio para uma categoria raiz, ou selecione uma categoria para criar um subfórum.
- **Ícone**: pictograma facultativo apresentado ao lado do nome.
- **Posição**: ordem de apresentação, ajustável por arrastar e largar na lista.
- **Ativa**: oculta ou mostra a categoria do lado da loja.

Cada subfórum mostra automaticamente o seu número de tópicos, o seu número de mensagens e a sua última mensagem.

Eliminar uma categoria elimina também os tópicos e mensagens que contém. Os seus eventuais subfóruns são desassociados (recolocados na raiz), não eliminados.

## Do lado do visitante: criar um tópico e responder

Um cliente autenticado abre um tópico a partir do botão **Novo tópico**: escolhe a categoria, introduz um título e uma mensagem. O módulo gera automaticamente um _slug_ e um URL amigável para o tópico. Num tópico, o formulário de resposta aparece no fundo da página para os membros autenticados.

Cada mensagem mostra uma ficha de autor: avatar com inicial, nome, número de mensagens e data de inscrição. Enquanto a janela de edição não for ultrapassada, o autor pode **modificar** ou **eliminar** a sua própria mensagem diretamente, sem recarregar a página (AJAX).

Se o autor eliminar a única mensagem de um tópico que criou, o tópico inteiro é eliminado. É o comportamento esperado para evitar tópicos vazios.

## Moderação dos tópicos e das mensagens

Dois separadores dedicados permitem-lhe moderar:

- **DataFirefly Forum > Tópicos**: ative ou desative, **fixe**, **bloqueie** ou elimine os tópicos, à unidade ou por lote. Um tópico bloqueado continua legível mas já não aceita respostas; um tópico fixado sobe ao topo da sua categoria.
- **DataFirefly Forum > Mensagens**: modere cada mensagem individualmente ou por lote, valide as mensagens pendentes ou filtre as mensagens de um tópico preciso.

O **painel** (primeiro separador) mostra de relance o número de categorias, tópicos, mensagens, mensagens pendentes e denúncias, com acessos diretos à moderação.

## Pré-moderação

Quando a pré-moderação está ativada nas definições, cada novo tópico e cada nova resposta são criados em estado « pendente » e não aparecem enquanto não os validar. O membro é informado de que a sua mensagem será publicada depois de validação.

Para validar, vá a **Mensagens**: os conteúdos pendentes estão aí assinalados e podem ser aprovados à unidade ou por lote. O contador « pendentes » do painel indica-lhe permanentemente o que falta tratar.

A pré-moderação aplica-se aos novos conteúdos. As mensagens já publicadas não voltam à fila de espera se ativar a opção mais tarde.

## Denúncias e notificações

Se as denúncias estiverem ativadas, cada membro pode denunciar uma mensagem que considere abusiva (uma única denúncia por membro e por mensagem). A denúncia chega ao separador **DataFirefly Forum > Denúncias**, com um acesso direto à mensagem em causa, e pode ser marcada como tratada.

A cada denúncia, é enviado um e-mail para o endereço de notificação configurado. São fornecidos modelos de e-mail prontos a usar em **francês** e em **inglês**.

Para não perder uma denúncia, preencha um endereço de notificação dedicado à moderação em vez do e-mail genérico da loja.

## Pesquisa e URLs amigáveis

O fórum expõe uma pesquisa de texto integral baseada num índice **FULLTEXT** sobre os títulos e o conteúdo das mensagens: os seus visitantes encontram instantaneamente uma discussão. Do lado dos endereços, o módulo gera URLs amigáveis e legíveis para o fórum, as categorias e os tópicos, bem como para a criação de um novo tópico.

Este conteúdo gerado pelos seus clientes, acessível através de URLs claros, alimenta naturalmente o seu posicionamento em pesquisas de cauda longa. Deixe a leitura aberta aos convidados para maximizar a indexação.

## Integração na conta de cliente

O módulo integra-se na área de cliente do PrestaShop através dos hooks `displayCustomerAccount` e `displayMyAccountBlock`: aparece uma ligação para o fórum no painel da conta de cliente. É acrescentada uma segunda ligação no rodapé através do hook `displayFooter`, para tornar o fórum visível a partir de qualquer página.

## FAQ e resolução de problemas

### A ligação do fórum não aparece na área de cliente

Verifique que os hooks `displayCustomerAccount` e `displayMyAccountBlock` estão ligados (separador **Módulos > Posições**). Alguns temas personalizados não chamam estes hooks: é então necessário acrescentá-los ao template da conta de cliente.

### Os URLs do fórum devolvem um erro 404

Limpe a cache e regenere os URLs a partir de **Tráfego e SEO**. Certifique-se de que a reescrita de URL (URLs amigáveis) está ativada na sua loja.

### Um membro já não pode modificar a sua mensagem

A modificação só é possível durante a janela de edição definida nas definições. Passado esse prazo, o botão de modificação desaparece. Defina a janela em 0 para proibir qualquer edição, ou aumente-a para dar mais tempo.

### As mensagens não aparecem imediatamente

É o comportamento normal quando a pré-moderação está ativa: as mensagens ficam pendentes até validação a partir do separador **Mensagens**. Desative a pré-moderação para uma publicação imediata.

### Como lutar contra o spam?

O módulo combina várias salvaguardas: campo honeypot invisível, anti-flood parametrizável, comprimento mínimo e denúncia comunitária. Para um controlo máximo, ative a pré-moderação.

### O que acontece na desinstalação?

A desinstalação elimina as tabelas do módulo e os seus separadores do back-office. É pedida uma confirmação porque esta operação apaga definitivamente as categorias, tópicos e mensagens.